fullmetrixDocs

Crisp

Find the website ID and API token in Crisp, connect one or more websites to Fullmetrix and let the AI assistant read your support conversations.

Crisp is a chat and customer support tool. Connecting Crisp lets the Fullmetrix AI assistant read your support conversations to answer your questions. For example, you can ask which products come up most often in this month's complaints, how many conversations are still waiting for a reply, or for a summary of your exchanges with a customer before you call them back.

Access is read-only. Fullmetrix does not reply to your customers, change any conversation or delete anything in Crisp.

What the assistant can read

Once Crisp is connected, the assistant can look up the following information for each linked website.

  • Conversations, their messages, their state (pending, unresolved, resolved), the assigned operator and the tags set on them.
  • Contact profiles linked to conversations and their custom data.
  • The list of operators and their availability.
  • Visitors currently online on your site.
  • Your Crisp help center articles and reader ratings.
  • Conversation analytics, depending on what your Crisp plan allows.

What you need before you start

Have this ready

Access to your Crisp workspace settings, with the right to create an API token. If you have several websites in Crisp, select the one you want to connect first.

Crisp has no one-click sign-in for this integration. Fullmetrix needs three values that you copy from Crisp.

Field in FullmetrixWhat it isWhere to find it in Crisp
Website IDThe unique ID of your Crisp website, shaped like xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxxSettings, then Workspace Settings, then Setup & Integrations
Token identifierThe first half of the API token, which identifies itSettings, then Workspace Settings, then Advanced configuration, API Token section
Token keyThe second, secret half of the API tokenSame place, shown only once when created

Get the three values from Crisp

Copy the website ID

In Crisp, open Settings, then Workspace Settings, then Setup & Integrations. Copy the Website ID. Check the website name at the top of the page before copying.

Create an API token

Still in Workspace Settings, open Advanced configuration. In the API Token section, create a token reserved for Fullmetrix.

Copy the token identifier and key

Copy the token identifier and its key. Crisp shows the key only once. Keep it in your password manager while you connect.

Treat the token key like a password

Never paste it into an email, a screenshot or a shared document. If it has been exposed, delete the token in Crisp, create a new one and reconnect the website.

Connect Crisp in Fullmetrix

Open the connection window

In the sidebar, click Settings, then the Integrations tab. In the Communication category, click Connect on the Crisp card. The Connect Crisp window opens.

Paste the three values

Paste each value into its field, Website ID, Token identifier and Token key. The key field hides what you type.

Confirm

Click Connect. Fullmetrix checks with Crisp that the token is valid and grants access to this website before saving anything. The Crisp connected message appears. The card shows a green dot, your website name (or its domain) and the Manage button.

Connect another Crisp website

If you have several websites in Crisp, one per store or per country for example, connect them all. Click Manage on the Crisp card. The Manage Crisp websites window lists the connected websites. Click Connect another website and repeat the steps with the other website's values. The card then shows 2 websites connected, for example.

If you connect a website ID that is already there, Fullmetrix updates that website's token instead of creating a duplicate. This is how you change tokens.

Check that everything works

Open the AI assistant and ask a simple question about your support, such as "How many Crisp conversations did I get last week?". The assistant should answer with figures taken from Crisp.

Change tokens without losing access

Create the new token

In Crisp, on the same website, create a new API token and copy its identifier and key.

Connect it in Fullmetrix

Click Manage, then Connect another website. Paste the same website ID with the new token identifier and key, then click Connect.

Delete the old token

Once Crisp connected appears, delete the old token in Crisp. Never delete it before, or the assistant loses access in the meantime.

Disconnect a Crisp website

Click Manage, then Disconnect next to the website concerned. The Disconnect this Crisp website? window reminds you that the assistant will lose access to its conversations. Click Disconnect to confirm or Cancel to close the window.

Disconnecting only affects the chosen website. Your conversations, contacts and articles stay in Crisp. If you do not plan to reconnect the website, also delete the token in Crisp.

Common problems

Your customers' data

An assistant answer can quote parts of conversations with your customers. Only share it with people allowed to see those exchanges.

If the problem persists, see Connection and access or contact us with the organization name, the Crisp website name and the message shown. Never send us the token key.

On this page