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 コーディング エージェントに貼り付けます。 エージェントはガイドを取得し、ジョブを構築してから、ドライランを開始します。
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。
引き継がれるもの
| データ | 繰り越します |
|---|---|
| Finのターンとセッションのグループ化 | はい セッションは、最初のチームメイトが応答した時点で終了します。 |
| Finのアクション | はい、名前、期間、成功を含むツール呼び出しとして。入力および出力は含みません |
| FinRatingsとCSAT | はい、[Agent] Scoreイベントとして |
| モデル、トークン、およびコスト | いいえ、Intercom APIにはありません。 |
| ハンドオフ後のチームメイトメッセージ | いいえ |
| メモ、非公開部分、および添付ファイル | いいえ。ジョブはそれらを送信しません。 |
| 実験 | はい、Intercom会話属性がバリアントを記録する場合です。 コーディングエージェントに、どの属性かを伝えます。 |
鮮度と限界
- 確定時間:更新がないまま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.