Crisp integration for Dimension Labs
This brings in each Crisp conversation as one conversation: what the visitor wrote and what your operators and bots replied, across chat, email and the other channels connected to your inbox. You run it on your side: a small script pulls from the Crisp REST API and posts each message to the universal API.
- Platform
- Crisp
- Type
- Chat, messaging and AI agents
- Connects by
- Universal API
- Setup
- 5 steps
- Guide checked
- 2026-10-26, against Crisp's documentation
Every Crisp message, in the same shape as everything else.
Each record lands in the Dimension Labs conversation format, so Dimensions, reports and the agent work the same way as for every other source.
message content text Only messages whose type is text. Skip note messages: those are private notes for your team. Files, pickers and events are skipped too.
conversation people_id userId Crisp's internal id for the contact, on every message of the conversation. Fall back to the sessionId.
message from incoming true when from is user (the visitor). Operators and bots are operator.
conversation session_id sessionId Prefix it, for example crisp-session_700c65e1-....
conversation session_id conversationId Same value as sessionId.
message timestamp dimensionlabs_timestamp Convert with toMillis.
message origin, automated; conversation state, inbox_id, meta.segments platformJson automated is true for bot messages.
5 steps. Then it runs on its own.
A small job on your side reads Crisp through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Rate limits, per Crisp: on top of the website token's daily quota, the API applies global and per-route limits. Going over returns 429 Too Many Requests or 420 Enhance Your Calm (rate limits).
Open the full Crisp guide ›- 01Get API access in Crisp
- 02Pull new conversations
- 03Map the fields
- 04Send it
- 05Run it
What you need
- The owner of your Crisp workspace: only owners can generate a website token.
- Your website token (an identifier and a key) and your website ID.
- A Dimension Labs API key for a new Universal API source.
[03] What you can ask
Questions teams answer with Crisp data.
- Where does the bot fail, and what does it cost?
- What do customers say right before they ask for a person?
- Which intents should be automated next?
Crisp integration questions
Does Dimension Labs integrate with Crisp?
Yes. A small job on your side reads Crisp through its API and posts each message to the Dimension Labs universal API. The guide gives the steps, the field mapping and the code. The setup guide was checked against Crisp's documentation on 2026-10-26.
What Crisp data does Dimension Labs bring in?
This brings in each Crisp conversation as one conversation: what the visitor wrote and what your operators and bots replied, across chat, email and the other channels connected to your inbox. You run it on your side: a small script pulls from the Crisp REST API and posts each message to the universal API.
What do I need to connect Crisp?
The owner of your Crisp workspace: only owners can generate a website token. Your website token (an identifier and a key) and your website ID. A Dimension Labs API key for a new Universal API source.
How often does Crisp data update?
Run the job once for history, then every 15 minutes. A live source is enriched automatically every day; history is enriched with a backfill.
Can I connect a platform that is not Crisp?
Yes. Any platform with an API connects through the same universal API, and any tool with an export button works as a file upload. The integrations page lists the platforms with a written guide.
Stop reporting. Start understanding.
Start with one file. Ask why a number moved. Plans from $299 a month, no demo and no contract on monthly plans.