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.
The key on the wire is derived
The key format above is this connector's internal record identity: it decides which source record an
event belongs to. The idempotency_key actually sent to CortexDB is a derived cxsrc:<56 hex> value
that also hashes the content, labels, observed time and actor, so an unchanged redelivery converges on
the same event while any edit lands as a new one, even where the key format itself is not
content-versioned. Every event also carries a source descriptor with the record's fingerprint. See
Source identity and keys.
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 300Optional settings
Set these as environment variables (or the matching keys in the cortexdb-sync YAML config). Lists are comma-separated. For on/off settings, 1, true, yes or on turns the setting on and any other value turns it off.
| Setting | What it does | Default |
|---|---|---|
INTERCOM_ARTICLES | Also sync Help Center articles | Off |