Data connectorsは、Finが会話中に注文詳細、アカウント状況、サブスクリプション情報などの外部システムのライブデータにアクセスできるようにし、人が調べる必要をなくします。この記事は完全な設定プロセスの目次です。初めての場合は順に、復習したい場合は特定のトピックにジャンプしてください。

まず概念の概要を読んでください。データコネクタとカスタムオブジェクトとは何か、それらの関係、どちらが必要かを説明します。

まずAPIを設計し、Data connectorを作成してAPIの呼び出し方法を定義します。

本番稼働前に、コネクタが外部APIとどのように認証するか、顧客がデータにアクセスする前に認証が必要かを設定します。

APIのレスポンス形状はFinが返されたデータを読み取り利用する方法を決定します。このセクションでは異なるレスポンス構造の扱い方を説明します。

カスタムオブジェクトは、標準の連絡先や会話属性では捉えられない注文、サブスクリプション、予約などの構造化された複数プロパティのデータをIntercomに保存できます。通常はコネクタのレスポンスデータをオブジェクトにマッピングして入力します。

オブジェクトマッピングは、APIレスポンスデータをIntercomのどこに保存するかをコネクタに指示します。標準オブジェクト（連絡先や会話属性）またはカスタムオブジェクトにマッピング可能です。APIレスポンスフィールドを属性にマッピングするには、How to set up Data connectorsのオブジェクトマッピングセクションを参照してください。

各コネクタには組み込みのテストツールがあり、本番稼働前にAPI呼び出しとレスポンス形状を検証できます。コネクタのDataタブのTest connectionボタンでリクエストとレスポンス全体を確認してください。Finが会話でコネクタを使うエンドツーエンドテストには、audience rulesで自分のuser emailをターゲットに設定します。

FinはData connectorを直接呼び出して顧客の質問に答えられますが、コネクタはより複雑な多段階手順の基本構成要素でもあります。例えば注文を検索し、更新を提案し、変更を確認するなどです。

コネクタが期待通りに動作しない場合はトラブルシューティング記事から始めてください。セキュリティやプライバシーの質問はFAQ記事でよくある懸念をカバーしています。

この表を使ってData connectorsドキュメント内の任意の記事に直接ジャンプできます。