Intercom
Connect Intercom to surface every Fin AI Agent conversation, Custom Bot, AI Inbox suggestion, and installed app touching your help-desk workspace. The OAuth connector polls the Intercom API on a 15-minute cadence and registers each bot + AI feature as an observed agent.
What gets observed
- Fin AI Agent — per-conversation resolution counts, handoff events, escalations.
- Custom Bots — inventory + last-event timestamps + branch flow.
- AI Inbox features — copilot suggestions and summarisations marked at the conversation envelope level.
- Installed apps from the App Store (with capabilities granted).
- Admin audit events (role changes, app installs).
Conversation bodies are not stored — the connector reads metadata and tag envelopes only. Customers needing prompt-level fidelity on Fin should route outbound traffic through the collector LLM proxy.
Setup
- Sign in to app.trefur.com as an Intercom workspace owner.
- Open Integrations → Intercom → Connect.
- You're bounced through Intercom's OAuth consent screen. Approve the requested access. [Screenshot: Intercom OAuth consent]
- On success Trefur stores a refresh token and kicks off an instant scan. The first inventory normally completes in under a minute.
Access requested
Intercom does not use per-request OAuth scopes — access is governed by the permissions configured on the Trefur app in Intercom, and its consent screen shows those permissions when you approve. Trefur's connector reads only: it inventories Fin, Custom Bots, admins, and installed apps, and never writes back to your workspace.
Troubleshooting
| Symptom | Fix |
|---|---|
| Fin AI Agent rows missing. | Fin must be enabled on the workspace and have processed at least one conversation. Without it the connector still inventories Custom Bots. |
| Token expired after a day. | Intercom OAuth tokens are long-lived but rotate on admin password change. Re-run the connect flow if you see auth-error events in the dashboard. |
| Audit events not arriving. | Audit-log access requires Intercom's Premium plan. Lower tiers still get Fin + Custom Bot + app inventory. |
Back to all integrations.