Allowing Integrate.io ETL access to my Crisp Chat

Integrate.io ETL can read conversations, people profiles, visitors, and operators data from your Crisp Chat account and ingest them into your ETL pipelines. This article details how to set up the Crisp Chat connection in Integrate.io ETL.

This connector uses a Crisp Marketplace plugin token (identifier + API key) for authentication. No OAuth flow is required.

Step 1: Create a Plugin on the Crisp Marketplace

1. Go to the Crisp Marketplace and sign in with your Crisp account.
2. Click "New Plugin" to create a new private plugin.
3. Give it a name (e.g. Integrate.io ETL Connector) and a description.
4. Save the plugin.

💡 If you already have a plugin you want to use, skip to Step 2.

Step 2: Obtain the Plugin Identifier and API Key

1. In the Crisp Marketplace, open your plugin.
2. Navigate to the "Tokens" tab.
3. You will see two types of tokens:
   • Development — Available immediately, low daily request quota. Good for testing.
   • Production — Requires requesting production credentials. Higher daily quota for production use.
4. Copy the following values:
   • Identifier — A UUID (e.g. 74f6f51e-c7d6-42b7-a118-f77c88d39bf8)
   • Key — A 64-character hex string (e.g. f300591f2c68cf0b8d6b4d330a029226ec53ce2f644d93600be572f71d856d57)

⚠️ Keep these credentials secure. If you suspect they have been compromised, roll them immediately from the Marketplace dashboard — this revokes the previous token instantly.

Step 3: Find Your Website ID

The Crisp API requires a Website ID to access data. Each Crisp website (inbox) has its own unique ID.

1. Log in to the Crisp Dashboard.

2. Go to Settings → Website Settings for the website you want to connect.

3. The Website ID is the UUID in the browser URL bar:

   https://app.crisp.chat/settings/website/**33619249-efd8-44fa-9312-9a594a819eae**/

4. Copy this UUID.

💡 Multiple websites? If your Crisp account has multiple websites (inboxes), you will need a separate Integrate.io connection for each one. Each connection targets one website.

Step 4: Connect the Plugin to Your Website

Your plugin must be connected to the website before it can access data.

1. In the Crisp Marketplace, open your plugin.
2. Navigate to the "Websites" tab or installation settings.
3. Ensure the target website is listed as connected.

💡 You can verify connectivity by calling GET /v1/plugin/connect/websites/all/1 with your plugin credentials. It should return your website ID.

Step 5: Create the Crisp Chat Connection in Integrate.io ETL

1. Navigate to the Connections tab in Integrate.io ETL.
2. Click New Connection and select Crisp Chat (under Services category).
3. Fill in the connection form:

Click Test Connection to verify the credentials are working and click Create Connection.