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

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

まずAPIを設計し、次にデータコネクターを作成してAPIの呼び出し方法を定義します。

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

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

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

オブジェクトマッピングは、APIレスポンスデータをIntercomのどこに保存するかをコネクターに指示します。標準オブジェクト（連絡先および会話属性）またはカスタムオブジェクトにマッピングできます。

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

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

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

この表を使ってデータコネクターのドキュメント内の任意の記事に直接ジャンプできます。