DocsBack to fikadesk

Import from Intercom

Pull contacts, companies, conversations and tags out of Intercom.

The Intercom importer pulls four collections: contacts, companies, conversations and tags. It scrolls the Intercom API with a cursor checkpointed after every batch, so a crash or a redelivered job resumes where it left off instead of starting over.

Preview first

POST /api/imports/intercom/preview is a read-only dry run over the token. It returns the count for each of the four collections, so the numbers validate the token before a run commits. A refused token answers 401 invalid_token rather than a thrown error.

Run it

The token is sealed at rest under FIKADESK_IMPORT_SECRET. The importing member stands in for every Intercom admin, so a thread's history keeps an author.

sh
curl -X POST http://127.0.0.1/api/imports/runs \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer fk_<key>' \
  -d '{"source":"intercom","token":"<access token>"}'

What changes shape

  • Intercom admins become the importing member, since fikadesk conversations need a member author.
  • Conversations over the 500-part cap are truncated, and the run summary says how many.
  • Tags are attached to the conversations that carried them.

A bad or revoked token is a permanent refusal and ends the run as failed. Anything else transient is re-thrown so the job is redelivered against the last cursor.