Skip to main content
The Intercom integration captures conversations from your Intercom workspace in real time and gives the Modem Agent the ability to search conversations, reply to customers, manage tags, and more.
Agent write access to Intercom (replying, tagging, managing conversations) is disabled by default. An admin can enable it from Settings → Integrations → Intercom.

​
Prerequisites

  • Admin access to the Intercom workspace you want to connect
  • A Modem organization

​
Setup

1

Start the connection

Go to Settings → Integrations → Intercom in your Modem dashboard and click Connect Intercom.
2

Authorize Modem

You’ll be redirected to Intercom to authorize the Modem app. Review the permissions and click Authorize.
After authorization, Modem automatically begins a historical backfill of past conversations and starts receiving new conversation events via webhooks.

​
What Gets Captured

​
Conversations

Modem captures conversation activity as it happens via webhooks:
  • New conversations created by users
  • User and admin replies (including internal notes)
  • State changes: opened, closed, snoozed, unsnoozed
  • CSAT ratings and customer remarks
  • Tags applied to conversations
  • Fin AI involvement: whether Intercom’s Fin AI agent participated in the conversation

​
Contacts

Modem syncs Intercom contacts (users, leads, and visitors) and links them to Modem people profiles using email address matching. This gives you a unified view of each person’s activity across Intercom and your other connected sources.

​
Historical Backfill

When you first connect Intercom, a historical backfill of past conversations starts automatically. This runs in the background and does not block real-time webhook processing.

​
Agent Capabilities

The Modem Agent can interact with your Intercom workspace using the intercom_api_request tool. This gives it flexible access to Intercom’s REST API.

​
What the agent can do

  • Search conversations by keyword, tag, or contact
  • Read contact details including user, lead, and visitor profiles
  • Reply to conversations (requires write access)
  • Add and manage tags on conversations (requires write access)
  • Add internal notes to conversations (requires write access)
  • Close, snooze, or reopen conversations (requires write access)

​
Example prompts

To enable the agent to write to Intercom (reply, tag, manage conversations), go to Settings → Integrations → Intercom and toggle Allow AI agent to write.

​
Troubleshooting

  • Verify the integration is connected in Settings → Integrations → Intercom
  • Allow a few minutes for webhook delivery and processing
  • Check that the conversation type is supported (user conversations, not outbound messages)
A historical backfill starts automatically when you first connect Intercom. If it appears incomplete, try disconnecting and reconnecting the integration, or contact support@modem.dev.
Agent write access is disabled by default. An admin must enable Allow AI agent to write in Settings → Integrations → Intercom.
Contacts are matched to Modem people by email address. If a contact doesn’t have an email set in Intercom, it won’t be linked automatically.

​
Disconnecting

To disconnect Intercom:
  1. Go to Settings → Integrations → Intercom
  2. Click Disconnect
This stops new data from being captured. Historical data remains in Modem after disconnecting.