Intercom Connector
Ingest Intercom conversations into CortexDB.
Tails Intercom conversations (and their parts) and writes them to CortexDB as conversation experiences.
Two ways to run this connector
Self-hosted — pip install 'cortexdb-connectors[intercom]' then cortexdb-sync sync intercom.
Managed — CortexDB runs the connector as a worker. See the Connectors overview.
1. Prepare credentials
Intercom → Settings → Developers → create an app (or use your workspace access token) and copy the access token.
What gets written
Each conversation and conversation part becomes a POST /v1/experience on the resolved scope (default
org:<org>/source:intercom), author resolved (contact or admin), body as content, with an entity
reference to the conversation.
Idempotency key
The idempotency_key uses the ic: prefix (ic:conv:<id>, not intercom:…). This connector
does not use context.preceded_by.
Run it yourself
pip install 'cortexdb-connectors[intercom]'
pip install cortexdb-cli && cortexdb init
export INTERCOM_TOKEN=... # required (access token)
cortexdb-sync --api-url http://localhost:3141 sync intercom
cortexdb-sync --api-url http://localhost:3141 watch intercom --interval 300