Data connectors はコード不要で深く組み込まれた統合機能で、外部のライブデータを Intercom に接続できます。このライブデータは Fin、Workflows、および Inbox を活用して、顧客が自動的に問い合わせをセルフサーブできるようにします。

始め方としては、チームメイトがかなりの時間を費やして回答している一般的な質問を考えることが良い方法です。これらは現在 Intercom に存在しない情報を使います。

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

解決したい質問が分かれば、ほとんど技術的専門知識がなくても、Data connector を設定するのは意外と簡単で迅速です。

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

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

Data connector に、どの Data connector を実行するかが正確に分かる一意の名前を付けます（例：「注文IDを取得」）。説明欄には、チームメイトがこの Data connector をいつ使うべきかと、取得できる情報を記載してください（例：「指定された ID の注文を取得。注文 ID は Conversation CDA に保存されている必要があります」）。

Fin がこのコネクタを直接使用できるようにするには、Fin タブに移動し、How should Fin use this connector? を Enabled (direct trigger) に設定します。Workflow、Task、Procedure、または Macro 内でのみ使用したい場合は、Disabled (manual trigger) に設定してください。

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

このリクエストがどの Data connector を実行するかを、メソッドを選択して指定できます。

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

Add key value pair をクリックして追加のパラメータをこのリクエストに追加し、HTTP Headers の下で Key value pair を選択できます：

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

POST または PUT リクエストを行う場合、リクエストに含めたいデータを指定するためのリクエストボディを提供するオプションがあります：

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

Test request をクリックして Data connector が正しく構成されているか確認します。接続が API によって検証されると、緑のチェックが表示され、そのリクエストの詳細が見えるはずです。

これらはすべて、Workflows を活用して顧客に迅速な回答（例：注文状況）を提供するために使用できる情報です。

デフォルトでは、Fin は応答の全データにアクセスして返信を生成できます。Fin が読み取るデータを制限したい場合は、Manually restrict access を選択し、Fin にアクセスさせたいデータフィールドを選択してください。

応答データの個々の項目を編集するには、edit アイコンをクリックして、表示名を付けたりデータの変換を指定したりできます。

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

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

このステップは任意です。Data connector によって取得した情報を Intercom 内のどこに保存するかを指定し、Workflows で顧客への回答として使用できるようにします。

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

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

データコネクタのストレージ、認証、実行の扱いについて確認する。

JSONレスポンスデータは次の場所に保存できます：

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

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

Custom Objectsとマッピングする際は、IDをexternal_idフィールドにマップする必要があります。そうしないと各GETリクエストで重複が作成されます。Custom Objectsの適切な参照設定について学ぶ

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

Data connectorのテストが成功したら、本番化する準備が整います。

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

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

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

それはData connectorの使用状況を次で追跡します：

Data connectorがライブになったら、Settings > Integrations > Data connectorsから直接パフォーマンスを監視できます。

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

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

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

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

ログをフィルタできます：

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

Settings > Integrations > Data connectorsに移動し、ドラフトに移動するデータコネクタをクリックしてからSet to draft.を選択します。

Intercomはアクティブな依存関係があるコネクタのドラフト化をブロックしますが、'Used by'列を使用してこれらを事前に管理できるようになりました。この列はアクションを参照するすべてのWorkflow, Procedure, Task, Macro, and Custom Answerのライブでインデックス化されたリストを提供します。リスト内の任意の項目を直接クリックして該当の自動化にジャンプし、依存関係を解決できます。