Connectors
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/space:{space}), with an entity reference to the
page.
Corrected fields
- The comment
idempotency_keyiscomment:{comment_id}:v{version}— there is noconf:prefix. - Comments link to their page via a
thread=…label, notcontext.preceded_by.
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=[email protected] # 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 300