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

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

Fin AI Agentがサードパーティアプリを使用するための利用可能なデータコネクターテンプレート。

対応者:Beth-Ann Sher

データコネクターテンプレートは、アプリごとにグループ化されたテンプレートカタログから、事前構築済みで即使用可能なデータコネクターをインストールできます。テンプレートはインストール済みの統合を使って自動的に設定されるため、すぐにテストしてライブ設定が可能です。Intercomが改善を行うと通知が届き、適用前に変更内容を確認できます。

これらのテンプレートを使用するには、設定 > 統合 > データコネクターに移動し、新規をクリックしてテンプレートから開始を選択します。アプリごとにグループ化されたテンプレートが表示されるので、インストールしたいテンプレートを選択してください。


テンプレートの仕組み

カタログからのインストール

テンプレートカタログには、利用可能な事前構築済みテンプレートがアプリごとにグループ化されて表示されます(例:Stripe、Shopify、Statuspage)。閲覧とインストールは新しいコネクターフローに組み込まれており、コネクター作成時にテンプレートから開始を選択し、アプリを選んで希望のテンプレートを選びます。

テンプレートをインストールすると、ワークスペース内に独立したコピーが作成されます。元のテンプレートや他のワークスペースに影響を与えずに自由にカスタマイズ可能です。

オプトインレビューによる安全な更新

Intercomが既にインストールしたテンプレートの改良版を公開しても、コネクターは自動的には変更されません。代わりに新しいバージョンが利用可能である通知が届きます。変更内容を正確に確認してから更新を適用するか決定でき、カスタマイズ内容は保持されます。

インストールされた各コネクターは、どのテンプレートバージョンから作成されたかを記録しているため、常に最新かどうか、または新しいバージョンが利用可能かが明確です。


Shopify Storefrontデータコネクターテンプレート

これらのデータコネクターを設定すると、FinはShopify Storefrontから情報を取得したい顧客のリクエストを完全に解決できます。これは既存のShopify統合を使用しているため、他のツールとの追加接続は不要です。

これらのデータコネクターをプリセット条件でライブ設定するか、独自の条件を設定してFinにShopifyから情報を取得するための要件を伝えます。

注意:

  • これらのShopify用データコネクターテンプレートを使用するには、ワークスペースにShopifyアプリをインストールする必要があります。

  • データコネクターはネストされたオブジェクトや配列パラメーターをサポートしていないため、MCPコネクター経由のShopify search_catalogツールによる動的な商品検索はできません。商品検索や推奨を有効にするには、ShopifyカタログデータをFinのknowledge baseに同期し、ネイティブのShopify統合を使用してください。

一般的な使用例

これらのデータコネクターを使用して:

カタログ検索

顧客の言葉でストアのカタログを検索します。該当する商品の価格帯、在庫状況、画像、ストアリンクを返します。

カート取得

顧客のShopifyカートの内容を読み取ります。カート内の各行の数量、該当する商品とバリアント、行ごとの合計とカート合計、チェックアウトリンクを返します。

カート更新

顧客のShopifyカート内のアイテムの数量を変更します。更新されたカートの全行、新しい合計、チェックアウトリンクを返します。例として以下のような顧客の問い合わせがあります:

  • あの注文を3つに変更できますか?

  • 青いシャツは1枚だけで、2枚はいりません

  • カートからスライドを取り除いてください

  • カートの数量を更新してください

この操作にはcart_id、変更するアイテムのline_id、新しい数量が必要です。line_idはGet Shopify cartアクションで返されるカート行IDであり、商品やバリアントIDではないため、顧客が指す行を特定するためにカートを先に読み取ってください。数量を0に設定すると行が完全に削除されるため、この操作は数量変更とアイテム削除の両方をカバーします。これはShopify Storefront MCPエンドポイントの廃止予定のupdate_cartツールの両機能に代わるもので、新規アイテム追加は別のStorefrontミューテーションです。

商品詳細取得

ストアのカタログ内の1つの商品を調べます。説明、価格帯、在庫状況、画像、購入可能なすべてのバリアントとそれぞれの価格、SKU、オプション、在庫を返します。顧客がカートや注文ではなく商品について尋ねた場合に使用します。


Shopifyデータコネクターテンプレート

注文情報取得

顧客の注文に関する詳細を取得し、注文関連の問題解決を支援します。この操作は注文状況、購入商品、配送先住所、追跡情報、その他関連する注文詳細をすべて提供します。


Statuspageデータコネクターテンプレート

このデータコネクターを設定すると、FinはStatuspageに記録されたインシデントについて報告や問い合わせをする顧客のリクエストを完全に解決できます。これは既存のStatuspage統合を使用しているため、他のツールとの追加接続は不要です。

プリセット条件でデータコネクターをライブ設定するか、独自の条件を設定してFinにStatuspageから情報を取得するための要件を伝えます。

未解決のインシデント

顧客が問題を経験している場合、進行中のシステム停止、サービス障害、未解決のインシデントがあるかを確認します。この操作はすべてのアクティブなインシデント、その状況、最新の更新情報を提供します。

注意: このデータコネクターテンプレートを使用するには、ワークスペースにStatuspageアプリをインストールする必要があります。


Stripeデータコネクターテンプレート

これらのデータコネクターを設定すると、FinはStripeに保存された情報を必要とする顧客のリクエストを完全に解決できます。これは既存のStripe統合を使用しているため、他のツールとの追加接続は不要です。

プリセット条件でこれらのデータコネクターをライブ設定するか、独自の条件を設定してFinにStripeから情報を取得するための要件を伝えます。

注意: これらのデータコネクターテンプレートを使用するには、ワークスペースにStripeアプリをインストールする必要があります。

一般的な使用例

これらのデータコネクターを使用して:

IDでStripe顧客を取得

Stripe顧客ID(cus_...)で単一のStripe顧客を取得します。顧客の保存された詳細(ID、メール、名前、残高、通貨、延滞、作成日)を表示します。読み取り専用。

Stripe顧客一覧

Stripe顧客のリストを返します。オプションで正確なメールアドレスでフィルタリング可能です。各顧客の保存された詳細(ID、メール、名前、残高、通貨、延滞、作成日)を表示します。読み取り専用。

顧客のStripe請求書一覧

Stripe顧客の請求書(最新順、最大10件)を一覧表示します。請求書ID、ステータス、支払額、通貨、請求期間、ホストされた請求書URLを含みます。顧客のStripe ID(cus_...)を渡します。読み取り専用。

顧客のStripe請求検索

Stripe顧客の請求(最大10件)を検索します。請求ID(ch_...)、金額、通貨、ステータス、支払済み・返金済みフラグ、説明、作成日を含みます。顧客のStripe ID(cus_...)を渡します。返金前に必要なcharge_idを見つけるためによく使われます。読み取り専用。

メールでStripe顧客検索

正確なメールアドレスでStripe顧客を検索し、一致する顧客を返します。ID、メール、名前、残高、通貨、延滞、作成日を含みます。これはメールアドレスのみがある場合のStripe検索の最も一般的な出発点です。読み取り専用。Finはこのコネクターを使ってメールで誰かのStripe記録を呼び出します。メールフィールドが未検証の更新から保護されていない場合、顧客がMessengerで変更して他人の記録を呼び出す可能性があります。データコネクタードラフトのセキュリティタブでメールが保護されたフィールドであることを確認してください。

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

顧客のサブスクリプションに関する詳細を取得し、サブスクリプション関連の問題解決を支援します。この操作はサブスクリプションの状態、請求頻度、次回請求日、プラン詳細などすべての情報を提供します。

顧客の問い合わせ例:

  • 私のサブスクリプションの状態は?

  • 次に請求されるのはいつですか?

  • どのプランに加入しているか教えてください。

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

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

Stripeの制限とカスタム設定

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

注意:キャンセルコネクターを設定する場合は、単純で自主的なキャンセルリクエストに限定してください。適格性チェック、確認、分岐ロジックにはFin Procedureを使用し、Finのエスカレーションガイダンスで引き継ぎ基準を定義してください。タイミングについては、標準データコネクターのタイムアウトは15秒、適格ワークスペース内のProcedureで使用されるデータコネクターは30秒です。

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