DocsBack to fikadesk

Import from Chatwoot

Pull conversations and contacts out of Chatwoot, cloud or self-hosted.

The Chatwoot importer pulls conversations and their messages into conversations and parts, and the people on them into contacts. It accepts a self-hosted instance, so the base URL is yours to set.

Connection settings

  • base_url is the instance root, https://app.chatwoot.com or your own host.
  • account_id is the numeric id the Chatwoot API scopes every account route under.
  • token is a Chatwoot access token, sent separately so it can be sealed at rest.

Run it

POST /api/imports/chatwoot/test reads the account details before a run starts, so a bad base URL or token shows up in the wizard. Then start the run:

sh
curl -X POST http://127.0.0.1/api/imports/runs \
  -H 'content-type: application/json' \
  -H 'authorization: Bearer fk_<key>' \
  -d '{"source":"chatwoot","config":{"base_url":"https://app.chatwoot.com","account_id":"1"},"token":"<access token>"}'

How status maps

Chatwootfikadesk
conversationconversation
messageconversation part
contactcontact
status resolvedclosed conversation
status open, pending, snoozedopen conversation

Chatwoot timestamps are Unix seconds, with a self-hosted build's string parsed as ISO first, so either shape lands on the right wall-clock time.