Fin by Intercomの会話をエージェント分析にインポートする

Fin連携では、Finのアクションやユーザーの評価など、Fin AIエージェントの会話がIntercomからエージェント分析に転送されます。インフラストラクチャ内のスケジュール済みジョブがIntercomでFinの会話を検索し、各トランスクリプトを取得し、それを[Agent]イベントにマップし、Amplitude HTTP APIに送信します。オプションのIntercom Webhookを使用することで、終了した会話をキューに追加できますが、スケジュールされたジョブが依然として信頼できるソースになります。

この連携は、Intercomヘルプデスク上のFinにのみ適用されます。Zendesk、Salesforce、HubSpot、またはFreshdesk上のFinは対象外です。

AIコーディングエージェントを使用した設定(推奨)

このプロンプトを、Cursor、Claude Code、Windsurf、GitHub Copilot、Codexなどの AI コーディング エージェントに貼り付けます。 エージェントはガイドを取得し、ジョブを構築してから、ドライランを開始します。

text
Connect our Fin (Intercom) conversations to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/fin.md
If @amplitude/ai is installed, the same file is under node_modules/@amplitude/ai/docs/integrations/.
Follow links in the guide. If your source isn't listed, start at https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/README.md
Follow "Part 2: Coding agent procedure". Start with a dry run.

エージェントは停止し、推測できない値(ユーザーIDがどのフィールドに保持されているかなど)を尋ねます。 変更を確認し、今すぐ始めるの手順に従って検証します。

必要な対応

  • 実行すること:スケジュールされたジョブと、オプションのWebhookレシーバー。
  • 必要なもの:会話の読み取り権限とそのアクセストークンを持つIntercom Developer Hubアプリ。このWebhookには、アプリのクライアントシークレットも必要です。 ワークスペースに対してFinをオンにします。
  • 地域:Intercomワークスペースの地域で、米国、EU、またはオーストラリア。
  • 連絡先に必要なもの:プロダクト分析のユーザーIDと一致するexternal_id。

引き継がれるもの

鮮度と限界

  • 確定時間:更新がないまま2時間が経過すると、ジョブは会話を転送します。 終了した会話には[Agent] Session Endが付与されます。
  • レート制限:Intercomでは、アプリごとに1分あたり10,000回のAPI呼び出し、ワークスペースごとに25,000回のAPI呼び出しが許可されています。
  • 長期にわたる会話:Intercomは会話の直近500箇所を返します。そのため、このジョブでは非常に長い会話は切り捨てられます。

今すぐ始める

Fin連携ガイドに従ってください。まずはドライランを開始し、ライブイベントとセッションビューアを確認します。次に、ウィンドウを再実行して、重複がないことを確認します。

Guideは、Intercomの公開APIリファレンスに対して2026年10月6日に最後に検証されました。 FinとIntercomは、各所有者の商標です。 AmplitudeはIntercomと提携しておらず、Intercomによって承認されていません。

これは役に立ちましたか?

For AI agents: a documentation index is available at /docs/llms.txt. Append .md to any page URL for markdown, or send Accept: text/markdown.

このページでは