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

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

これらは、顧客が単に外部システムに保存されている情報を知りたい場合の質問（例：「私の注文状況は？」）や、外部システムで「配達の再スケジュール」や「返金処理」などの Data connector を使うケースです。

解決したい質問がわかれば、ほとんど技術的な知識がなくても、驚くほど簡単かつ迅速に Data connector を設定できます。

まず、設定 > 統合 > Data connectors に移動します。

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

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

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

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

このリクエストで使う Data connector を、メソッドを選択して指定できます。

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

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

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

POST または PUT リクエストの場合、リクエストに送信したいデータを含むリクエストボディを指定できます。

次に、この Data connector が接続先のサードパーティシステムから正しいデータを取得しているかテストする必要があります。

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

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

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

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

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

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

このステップは任意です。Data connector にこの情報を Intercom のどこに保存するかを伝え、Workflows で顧客の質問への回答として提供できるようにします。

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

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

Data connectorのストレージ、認証、実行の取り扱いについて学ぶ。

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のライブでインデックス化されたリストが表示されます。このリストの任意の項目をクリックすると、その自動化に直接ジャンプして依存関係を解決できます。