Skip to main content
You connect Crisp with a workspace API token. Then you add a web hook in Crisp so OpenCX hears about your tagged conversations.
You need the Crisp workspace owner for the token, and the Integrations settings permission in OpenCX.

Before you start

Only the workspace owner can create the API token in Crisp.
Connecting or changing the integration needs the Integrations settings permission in OpenCX.
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.
Crisp shows the token key only once. Copy it before you close the dialog.
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:send
  • message:received
  • session:set_segments
  • session:set_state
  • session:set_email
  • session:set_phone
  • session:set_nickname
  • session:set_data
Treat the web hook URL as a secret. Crisp does not sign these web hooks, so anyone who has the URL can post events for your workspace.
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

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.
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 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.

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.