Importing from Crisp

The Crisp importer brings your contacts, conversation history, and help center articles into Convot. The import runs in the background - you can close the page and check back later.

Only the organization owner can start a migration. Agents and admins do not see the migration settings.

Before you start

You need:

• Your Crisp website ID (found in the URL when you open a Crisp workspace: app.crisp.chat/website/<id>/).
• A Crisp API key with access to that workspace.
• A Convot app to import into. The data will be scoped to that app.

Starting the import

1. Go to Settings → Migrations.
2. Click Crisp.
3. Click New run.
4. Enter your Crisp website ID and API key.
5. Select the Convot app you want to import into.
6. Choose which data to import (see scopes below).
7. Click Start import.

Convot runs a preview first, estimating the number of contacts, conversations, and articles in scope. The actual import then runs in the background.

What you can import

Contacts

Every contact in your Crisp workspace is created in Convot. Email, name, phone, and custom attributes are preserved.

Conversations

Conversations are imported with their full message thread, timestamps, and message attribution. The conversation window defaults to a recent period to keep import time reasonable; the run details page shows exactly how far back it will go. The actual import (unlike the preview) walks every page with no cap.

Help center articles

Articles are imported with their title, body, and category structure. After articles are imported, Convot rewrites internal cross-links between articles so relative links keep working.

Monitoring progress

The run card on the Crisp migration page shows live counters: contacts imported, conversations imported, messages imported, and articles imported. Expand the card to see error details and Crisp rate-limit watermarks.

Paused runs

Crisp has API rate limits. If the importer hits them, the run automatically pauses and shows when it will resume. You don’t need to do anything - it resumes by itself.

Re-running an import

Imports are safe to re-run. If you run the importer a second time with the same website ID and app, existing records are updated rather than duplicated. You might do this if you left Crisp running for a while after your first import and want to catch new conversations.

Cancelling

Click Cancel on an active run. Any data already imported is kept. You can start a new run at any time.