Confluence Connector
Ingest Confluence pages and comments into CortexDB.
Tails Confluence pages (and their versions) and comments, and writes them to CortexDB as experiences.
Two ways to run this connector
Self-hosted — pip install 'cortexdb-connectors[confluence]' then cortexdb-sync sync confluence.
Managed — CortexDB runs the connector as a worker. See the Connectors overview.
1. Prepare credentials
Create an API token at id.atlassian.com/manage-profile/security/api-tokens. You need your Confluence
site URL, the account email, and the token (HTTP Basic email:token).
What gets written
Each page (as a document) and comment (as a conversation) becomes a POST /v1/experience on the
resolved scope (default org:<org>/source:confluence/ws:{space}), with an entity reference to the
page.
Record keys and threads
- The comment
idempotency_keyiscomment:{comment_id}:v{version}— there is noconf:prefix. - Comments link to their page via a
thread=…label, notcontext.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[confluence]'
pip install cortexdb-cli && cortexdb init
export CONFLUENCE_URL=https://acme.atlassian.net # required
export CONFLUENCE_EMAIL=you@acme.com # required
export CONFLUENCE_API_TOKEN=... # required
cortexdb-sync --api-url http://localhost:3141 sync confluence
cortexdb-sync --api-url http://localhost:3141 watch confluence --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 |
|---|---|---|
CONFLUENCE_SPACES | Space keys to sync | Every space the account can see |