You need the Crisp workspace owner for the token, and the Integrations settings permission in OpenCX.
Before you start
The workspace owner in Crisp
The workspace owner in Crisp
Only the workspace owner can create the API token in Crisp.
The Integrations settings permission in OpenCX
The Integrations settings permission in OpenCX
Connecting or changing the integration needs the Integrations settings permission in OpenCX.
The AI turned on for your channels
The AI turned on for your channels
A session takes the channel of its Crisp conversation: web chat, WhatsApp or email. Turn the AI on for each of those channels under Settings → Autopilot. With assist mode on, the AI’s reply stays in OpenCX as a draft and is not sent to Crisp.
Setup
1
Create an API token in Crisp
In Crisp, go to Settings → Workspace → Advanced configuration → REST API and select Create Token.Copy the token identifier and the token key.
2
Copy your Website ID
In Crisp, go to Settings → Workspace → Setup & Integrations and copy the Website ID. This is your workspace ID.
3
Save your credentials in OpenCX
In OpenCX, go to Settings → Integrations or Settings → Ticketing and open Crisp.Paste the workspace ID, the token identifier and the token key, then save.OpenCX checks the credentials with Crisp before saving. The token key is stored encrypted and is never shown again.
4
Add the web hook in Crisp
Copy the web hook URL shown on the Crisp card in OpenCX.In Crisp, go to Settings → Workspace → Advanced configuration → Web Hooks and select Add a Web Hook. Paste the URL and turn on these events:
message:sendmessage:receivedsession:set_segmentssession:set_statesession:set_emailsession:set_phonesession:set_nicknamesession:set_data
5
Tag a conversation to try it
In the Crisp inbox, tag a conversation with
opencx. The AI answers in that conversation, and a session for it appears in your OpenCX Inbox.To send conversations to the AI automatically, add the segment from a Crisp routing rule or workflow.If the AI does not answer, see Troubleshooting.Settings
Change these on the Crisp card under Settings → Integrations.Replace the token key
The token key is never shown again after you save it. To replace it, enter a new one on the Crisp card and save.Good to know
Crisp's own AI agent and workflows
Crisp's own AI agent and workflows
If you use Crisp’s own AI agent or automated workflows, make sure they do not answer the conversations you tag for OpenCX. Otherwise customers get two answers.
Tokens restricted to IP addresses
Tokens restricted to IP addresses
If you restrict the Crisp token to specific IP addresses, allow OpenCX’s addresses first. Otherwise saving fails with a message from Crisp. Ask [email protected] for the current list.
Crisp's daily request limit
Crisp's daily request limit
Crisp allows a limited number of API requests per day for a workspace token. Every AI reply uses a few. See Crisp’s documentation for the current number.
Related Documentation
Conversation flow
How tagging, replies, handoff and resolving work.
Troubleshooting
AI not replying, two answers, saving fails.
Overview
What the Crisp integration does and how it fits with your team.
Human handoff
Global handoff rules and office hours.