データコネクタはノーコードで深く組み込まれた統合機能で、ライブの外部データを Intercom に接続できます。このライブデータは Fin、Workflows、Inbox を動かし、顧客が自動的に自己解決できるようにします。

始めるには、チームメイトがかなりの時間を費やして回答している、現在 Intercom で利用できない情報を使ったよくある質問を考えるのが良い方法です。

これらは、顧客が外部システムに保存されている情報を単に知りたい場合の質問、例えば「注文状況は？」や、外部システムで「配達の再スケジュール」や「返金処理」といったデータコネクタの利用例です。

解決したい質問がわかれば、ほとんど技術的な知識がなくても、データコネクタの設定は驚くほど簡単で迅速です。

まず、設定 > 統合 > データコネクタ に移動します。

ここで、ユースケースに応じて外部データ（例：Shopify、Salesforce など）へのさまざまな接続を設定します。+ 新規 をクリックしてください。

データコネクタに、どのデータコネクタを使うかを正確に説明するユニークな名前を付けてください（例：「注文IDを取得」）。説明欄には、チームメイトがいつこのデータコネクタを使うべきか、どんな情報が取得できるかを記入します（例：「指定されたIDの注文を取得。注文IDは Conversation CDA に保存されている必要があります」）。

Fin がこのコネクタを直接使えるようにするには、Fin タブに移動し、Fin はこのコネクタをどのように使いますか？ を 有効（直接トリガー） に設定します。Workflow、Task、Procedure、Macro 内だけで使いたい場合は、無効（手動トリガー） に設定してください。

次にリクエストの詳細を入力します。ここで接続するサードパーティシステムの HTTPS URL（例：Shopify、Salesforce など）を入力する必要があります。

このリクエストで使うデータコネクタを、メソッドを選択して指定できます。

この例では、API から注文IDを GET するリクエストを行い、URL を入力します。

リクエストに追加パラメータを加えたい場合は、キーと値のペアを追加をクリックし、HTTP ヘッダーの下でキーと値のペアを選択してください。

データコネクタは固定トークンと動的トークンの両方を認証に対応しています。HTTP ヘッダーの下で、リクエストに使う認証トークンを選択すると、ヘッダーに追加されます。

POST または PUT リクエストの場合、リクエストボディに送信したいデータを含めるオプションがあります。

次に、このデータコネクタが接続先のサードパーティシステムから正しいデータを取得しているかテストします。

テストリクエスト をクリックして、データコネクタが正しく設定されているか確認してください。接続が API で検証されると緑のチェックマークが表示され、リクエストの詳細が見えます。

これで、Workflows を活用し、顧客に迅速な回答を提供するための情報が揃いました。例えば注文状況などです。

デフォルトでは、Fin は返信を生成するためにレスポンス全体のデータにアクセスできます。Fin にアクセスを制限したい場合は、手動でアクセス制限を選択し、Fin にアクセスを許可するデータフィールドをチェックしてください。

レスポンスデータの個々の項目は、編集アイコンをクリックして、顧客向けの名前を付けたり、データの変換を指定したりできます。

例えば、API レスポンスが残高0を返した場合、Fin は未払い残高が0であると答える代わりに、現在未払い残高がないと返答できます。

データコネクタのコードブロックを使うことで、Python を使って API レスポンスを直接変換・操作できるようになりました。コネクタ設定内で行えます。

このステップは任意です。データコネクタがこの情報を Intercom のどこに保存するかを指定し、Workflows で顧客の質問への回答として提供できるようにします。

データを保存しなくてもよい一般的なケースは、PUT、POST、DELETE のデータコネクタリクエストタイプです。GET リクエストでボットにデータを使いたい場合は、Intercom にデータを保存する必要があります。

Fin用のデータコネクタを作成する際、レスポンスデータをIntercomの属性やオブジェクトにマッピングする必要はありません。代わりに、FinはJSONレスポンスを直接解釈し、それを使って質問を解決できます。レスポンスは「Test response」セクションに基づいて生成されます。各行項目はJSONレスポンス内のデータポイントに対応しています。

データコネクタのストレージ、認証、実行の取り扱いについて学ぶ。

JSONレスポンスデータは以下に保存できます：

Intercomオブジェクトを選択し、外部APIオブジェクトとマッピングします。

次に、Intercom内でこの情報を保存したいデータ属性を選択します。例えば、Intercomオブジェクトとして「Order」を選択し、外部システムのAPIオブジェクトとして「root」を選択し、API属性「currency」とマッピングしました。

カスタムオブジェクトにマッピングする際は、IDをexternal_idフィールドにマッピングする必要があります。そうしないと、GETリクエストごとに重複が作成されます。カスタムオブジェクトの正しい参照設定について詳しくはこちら。

次のステップは、更新したいカスタムオブジェクトに関連するPeopleまたはConversationからの参照を選択することです。

Data connectorのテストが成功したら、ライブ設定の準備が整います。

Data connectorsを大規模に安全に管理または編集するために、各Data ConnectorやMCPアクションがIntercom内のどこで使用されているかを事前に監査できます。

Used by列はデフォルトで非表示の場合があります。表示するには：

この列はライブでクリック可能な参照リストを提供します。任意の項目をクリックするとそのソースに直接移動します。

Data connectorの使用状況を以下で追跡します：

Data connectorがライブになったら、設定 > インテグレーション > Data connectorsから直接パフォーマンスを監視できます。

Health列は、最近の実行成功率とレイテンシに基づいて各コネクタの稼働状況を表示します。

任意のヘルスステータスバッジにカーソルを合わせると、最近のパフォーマンスの詳細な内訳が表示されます：

ダッシュボード上部の時間フィルターを使ってレポート期間を調整します。利用可能なオプション：1h、6h、24h、7d、または14d。

任意のコネクタをクリックして専用のヘルスダッシュボードを開き、Logsタブを選択すると、すべての実行のタイムスタンプ付き記録が表示されます。各エントリには実行されたチャネルと成功・失敗の状態が示されており、任意のエントリをクリックすると実行の詳細が展開されます。

ログは以下でフィルターできます:

不要になった古いデータコネクタを廃止したい場合は、ドラフト状態に移動できます。

設定 > インテグレーション > データコネクタに移動し、ドラフトに移動したいデータコネクタをクリックしてからドラフトに設定を選択します。

Intercomは依存関係がアクティブなコネクタのドラフト化をブロックしますが、Used by列を使ってこれらを事前に管理できます。この列は、アクションを参照するすべてのWorkflow、Procedure、Task、Macro、Custom Answerのライブインデックスリストを提供します。このリストの任意の項目をクリックすると、その特定の自動化にジャンプして依存関係を解決できます。