メインコンテンツにスキップ

データコネクタテンプレートを使用する

Fin AIエージェントがサードパーティアプリを使用するための利用可能なData connectorテンプレート。

対応者:Beth-Ann Sher

ワークスペースにインストールしたサードパーティアプリを利用して、Data connectorを自動で構成するData connectorテンプレートです。これにより、テストと即時公開が可能になります。

これらのテンプレートを使用するには、設定 > 統合 > Data connectorsに移動し、新規をクリックして、インストール済みのアプリの利用可能なテンプレートのいずれかを選択してください。


Shopify Storefront用Data connectors

これらのData connectorを設定すると、FinはShopify Storefrontから情報を取得したい顧客のリクエストを完全に解決できます。これは既存のShopify integrationを使用するため、他のツールとの追加接続は必要ありません。

プリセット条件を使ってこれらのData connectorをライブにするか、独自の条件を設定してShopifyから情報を取得する前にFinが満たすべき要件を指定してください。

よくあるユースケース

これらのData connectorを次の目的で使用できます:

  • ショップカタログを検索:Shopifyでホストされているオンラインストアから商品を検索します。

  • カート取得:指定したカートIDのカート(商品、配送オプション、割引情報、チェックアウトURLを含む)を取得します。

  • カート更新:カートの更新(商品行の追加/削除/更新、購入者情報、配送詳細、割引コード、ギフトカード、メモ)を1回の統合呼び出しで行います。

  • ストアポリシーとFAQを検索:店舗の方針、商品、サービスに関する事実を取得するために使用します。

  • 商品詳細を取得:IDで商品を照会し、必要に応じて特定のバリアントを選択するためにバリアントオプションを指定できます。

注意:Data connectorは入れ子のオブジェクトや配列パラメータをサポートしていないため、MCPコネクタを介したShopifyのsearch_catalogツールを使用した動的な製品検索はできません。製品検索および推奨を有効にするには、ShopifyカタログデータをFinのknowledge baseに同期し、ネイティブのShopify integrationを使用してください。

Shopify Data connectorの典型的な設定例:

  • Data connector名:注文情報を取得

  • 使用タイミング:顧客の注文詳細を取得し、注文に関連する問題のトラブルシューティングを行うために使用します。このData connectorは、注文状況、購入商品、配送先住所、追跡情報など、顧客のすべての注文詳細を提供します。

    • 顧客の問い合わせ例:

      • 私の注文の状況はどうなっていますか?

      • 私の注文は発送されましたか?

      • 追跡リンクを送ってもらえますか?

      • 私の注文はどこに発送されますか?

    このData connectorは返品、返金、注文の更新などの注文管理機能は実行しません。

  • 利用対象:Users かつ “shopify_orders_count” が “greater than 0”

注意:これらのShopify用Data connectorテンプレートを使用するには、ワークスペースにShopify appをインストールする必要があります。


Statuspage用Data connectors

未解決のインシデントを取得

このData connectorを設定すると、Finはインシデントやシステムのパフォーマンスについて問い合わせる顧客のリクエストを完全に解決できます。これは既存のStatuspage integrationを使用するため、他のツールとの追加接続は必要ありません。

プリセット条件を使ってこのData connectorをライブにするか、独自の条件を設定してFinがStatuspageから未解決のインシデントを取得する前に満たすべき要件を指定してください。

よくあるユースケース

顧客が次のことを知りたいときにこのData connectorを使用します:

  • インシデントがいつ始まったか。

  • 問題の現在の状況。

  • どの製品やサービスがインシデントの影響を受けているか。

  • 問題が完全に解決されているかどうか。

  • システムのパフォーマンスが通常に戻っているかどうか。

このテンプレートの設定方法

このData connectorの典型的な設定例:

  • Data connector名:未解決のインシデントを取得

  • 使用タイミング:未解決のインシデントを検索するためにこのData connectorを使用します。

    • 顧客の問い合わせ例:

      • インシデントはいつ始まりましたか?

      • 問題の現在の状況は何ですか?

      • どの製品やサービスがインシデントの影響を受けていますか?

      • 問題は完全に解決されましたか?

      • システムのパフォーマンスは通常に戻りましたか?

  • 利用対象:Leads, Users, and Visitors

注意:このData connectorテンプレートを使用するには、ワークスペースにStatuspage appをインストールする必要があります。


Stripe用Data connectors

サブスクリプション情報を取得

このData connectorを設定すると、FinはStripeを通じてサブスクリプションに関する情報を必要とする顧客のリクエストを完全に解決できます。これは既存のStripe integrationを使用するため、他のツールとの追加接続は必要ありません。

プリセット条件を使ってこのData connectorをライブにするか、独自の条件を設定してFinがStripeからサブスクリプションの詳細を取得する前に満たすべき要件を指定してください。 大きなAPIレスポンス(2000文字以上)やUnixタイムスタンプ(例:1757082297)がある場合は、コードブロックの使用を強く推奨します。Unixタイムスタンプや大きなペイロードを検出すると、自動的にコードを推奨する機能があります。

よくあるユースケース

顧客が次のことを知りたいときにこのData connectorを使用します:

  • サブスクリプションのステータス。

  • いつ請求されるか。

  • どのプランに加入しているか。

  • 請求頻度。

  • サブスクリプションの更新時期。

このテンプレートの設定方法

このData connectorの典型的な設定例:

  • Data connector名:サブスクリプション情報を取得

  • 使用タイミング:顧客のサブスクリプションの詳細を取得し、サブスクリプションに関連する問題のトラブルシューティングを行うために使用します。このData connectorは、サブスクリプションのステータス、請求頻度、次回請求日、プランの詳細など、顧客のすべてのサブスクリプション情報を提供します。

    • 顧客の問い合わせ例:

      • 私のサブスクリプションのステータスは?

      • 次にいつ請求されますか?

      • 私が加入しているプランは何ですか?

      • サブスクリプションの請求はどれくらいの頻度ですか?

      • 私のサブスクリプションはいつ更新されますか?

    このData connectorは一時停止、キャンセル、更新などのサブスクリプション管理機能は実行しません。

  • 利用対象:Users かつ “Plan” が “Paid”

注意:このData connectorテンプレートを使用するには、ワークスペースにStripe appをインストールする必要があります。

料金取得

このData connectorを設定すると、FinはStripeを通じて最近の支払いについて知りたい顧客のリクエストを完全に解決できます。これは既存のStripe integrationを使用するため、他のツールとの追加接続は必要ありません。

プリセット条件を使ってこのData connectorをライブにするか、独自の条件を設定してFinがStripeから支払い情報を取得する前に満たすべき要件を指定してください。

よくあるユースケース

顧客が次のことを知りたいときにこのData connectorを使用します:

  • なぜ最後の支払いが失敗したのか。

  • いつ返金を受け取るか。

  • 請求内訳。

  • 最後に使用したカード。

このテンプレートの設定方法

このData connectorの典型的な設定例:

  • Data connector名:料金取得

  • 使用タイミング:顧客アカウントの支払い情報を取得し、請求や支払いに関する問題のトラブルシューティングを行うために使用します。このData connectorは、支払い・返金の状況、通貨、カード情報、請求金額などの情報を提供します。

    • 顧客の問い合わせ例:

      • なぜ支払いが失敗したのですか?

      • いつ返金を受け取れますか?

      • 何に請求されましたか?

      • どのカードを使いましたか?

    このData connectorは支払いの収集や返金の発行などの操作を行いません。

  • 利用対象:Users かつ “Plan” が “Paid”

注意:このData connectorテンプレートを使用するには、ワークスペースにStripe appをインストールする必要があります。

Stripeの制限とカスタム設定

注意:Stripeのネイティブなメール自動化は請求書や領収書を自動送信できますが、これはStripe側の挙動であり、Finやこの統合で制御されるものではありません。Finにリクエストで請求書や領収書を送らせたい場合は、書き込み/アクション機能を持つカスタムData connectorが必要です。上記の標準Stripeテンプレートは読み取り専用のサブスクリプションおよび支払い照会のみをカバーします。

注意:キャンセルコネクタを設定する場合は、簡潔で任意のキャンセル要求に限定してください。適格性の確認、確認、分岐ロジックにはFin Procedureを使用し、Finのエスカレーションガイダンスにハンドオフ基準を定義してください。タイミングについては、標準のData connectorのタイムアウトは15秒であることに注意してください。プロシージャ内で使用される該当するワークスペースのData connectorは30秒のタイムアウトがあります。

こちらの回答で解決しましたか?