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.
Import Fin by Intercom conversations into Agent Analytics
The Fin integration forwards Fin AI agent conversations from Intercom into Agent Analytics, including Fin's actions and user ratings. A scheduled job in your infrastructure searches Intercom for Fin conversations, retrieves each transcript, maps it to [Agent] events, and sends them to the Amplitude HTTP API. An optional Intercom webhook can queue conversations as they close, but the scheduled job stays the source of truth.
This integration covers Fin on the Intercom helpdesk only. Fin on Zendesk, Salesforce, HubSpot, or Freshdesk isn't covered.
Set up with your AI coding agent (recommended)
Paste this prompt into your AI coding agent, such as Cursor, Claude Code, Windsurf, GitHub Copilot, or Codex. The agent fetches the guide, builds the job, and starts with a dry run.
Connect our Fin (Intercom) conversations to Amplitude Agent Analytics.
Fetch https://raw.githubusercontent.com/amplitude/Amplitude-AI-Node/main/docs/integrations/fin.md
and follow "Part 2: Coding agent procedure". Start with a dry run.
The agent stops and asks for values it can't infer, such as which field holds your user ID. Review its changes, then verify with the steps in Get started.
What this means for you
- You run: A scheduled job, plus an optional webhook receiver.
- You need: An Intercom Developer Hub app with the Read conversations permission and its access token. The webhook also needs the app's client secret. Turn on Fin for the workspace.
- Your region: Your Intercom workspace's region, US, EU, or Australia.
- Your contacts must carry: An
external_idthat matches your product analytics user ID.
What carries over
| Data | Carries over |
|---|---|
| Fin turns and session grouping | Yes. The session ends at the first teammate reply. |
| Fin actions | Yes, as tool calls with name, duration, and success, without inputs and outputs |
| Fin ratings and CSAT | Yes, as [Agent] Score events |
| Model, tokens, and cost | No, they aren't in the Intercom API |
| Teammate messages after a handoff | No |
| Notes, redacted parts, and attachments | No. The job never sends them. |
Freshness and limits
- Settle time: The job forwards a conversation after 2 hours with no updates. Closed conversations get an
[Agent] Session End. - Rate limits: Intercom allows 10,000 API calls per minute per app and 25,000 per workspace.
- Long conversations: Intercom returns the 500 most recent parts of a conversation, so the job truncates very long conversations.
Get started
Follow the Fin integration guide. Start with a dry run, check Live Events and the session viewer, then re-run the window to confirm it adds no duplicates.
Guide last verified on October 6, 2026, against Intercom's public API reference. Fin and Intercom are trademarks of their owner. Amplitude isn't affiliated with or endorsed by Intercom.
Was this helpful?