Données à migrer depuis Crisp

Ce que Crisp stocke

Un compte Crisp contient principalement des conversations et des profils de contact. La migration doit distinguer les données structurées (contacts, tags) des données de flux (messages, pièces jointes) qui nécessitent une transformation pour devenir des tickets SAV structurés.

Ce que Crisp stocke et qui peut être migré :

• Les conversations : fil de messages avec horodatages, auteurs et statuts
• Les messages : textes, images, fichiers, notes internes, messages automatisés
• Les contacts (People) : email, nom, attributs personnalisés, segments
• Les tags de conversation : labels appliqués pour catégoriser les demandes
• Les notes internes : commentaires agents visibles uniquement en backoffice

Ce que Crisp ne stocke pas ou difficilement récupérable :

• Les transcriptions des appels vidéo : les sessions vidéo Crisp ne sont pas enregistrées par défaut et donc non exportables.
• Les données des chatbots et scénarios : la configuration des bots est dans les paramètres de Crisp, pas dans les données exportables. Elle doit être reconstruite dans le nouveau logiciel.
• L’historique des widgets d’aide : les articles de helpdesk Crisp sont dans une section séparée (Knowledge Base), exportables manuellement mais avec une structure différente.

---

Exporter vos données Crisp via l’API

L’API REST Crisp utilise une authentification HTTP Basic Auth.

Authentification

Authorization: Basic base64(identifier:key)
X-Crisp-Tier: plugin

Nous allons ici privilégier l’identification par plugin, plus exhaustive que celle par website. Les identifiants (Identifier et Key) se génèrent via un plugin sur la Marketplace Crisp.

Pour vous guider dans cette configuration, consultez notre tutoriel étape par étape pour créer un token API Crisp.

Lister les conversations avec pagination

GET https://api.crisp.chat/v1/website/{website_id}/conversations/{page_number}

Crisp utilise une pagination par numéro de page (pas par offset). La réponse contient un tableau data de conversations et un indicateur si d’autres pages existent. Répéter en incrémentant le numéro de page jusqu’à obtenir un tableau vide.

Récupérer les messages d’une conversation

GET https://api.crisp.chat/v1/website/{website_id}/conversation/{session_id}/messages

Récupère les messages d’une conversation existante. En cas de volume important, l’API retourne un lot initial. Utilisez le paramètre timestamp_before pour paginer et afficher les messages suivants. Chaque message contient type (text, file, note, …), content, from (user/operator), timestamp et les métadonnées de l’expéditeur.

Exporter les contacts (People)

GET https://api.crisp.chat/v1/website/{website_id}/people/profiles/{page_number}

La liste des contacts est paginée par page. Chaque contact contient people_id, email, person (nom, téléphone), les segments d’appartenance et le score d’engagement définis dans votre espace Crisp.

---

Modèle de données Crisp : ce qu’il faut reconstruire

Conversations → Tickets

Les conversations Crisp deviennent des tickets dans le logiciel SAV sur mesure. La transformation nécessite d’enrichir chaque ticket avec les informations structurées qui n’existent pas dans le chat libre :

Champ Crisp	Champ Ticket cible
session_id	Référence ticket (interne)
created_at	Date d’ouverture
status (unresolved/resolved/pending)	Statut de base (à remapper selon le workflow)
meta.segments	Catégorie de ticket
People associé	Client lié au ticket
Premier message	Description initiale du problème

Contacts → Clients

Les contacts Crisp (People) sont mappés vers les clients dans votre logiciel :

Champ Crisp	Colonne SQL cible
email	email (clé de liaison)
person.nickname	nom_complet
person.phone	telephone
Attribut personnalisé (data)	Colonne métier correspondante
segments	Tags ou groupes clients

Notes internes → Commentaires internes tickets

Les messages de type note dans les conversations Crisp correspondent aux commentaires internes des agents. Ils sont migrés comme commentaires internes dans le nouveau logiciel (non visibles par le client dans le portail).

---

Ce qui nécessite une décision avant la migration

• La requalification des conversations : les conversations Crisp sont des échanges libres. La migration vers des tickets structurés nécessite de définir comment extraire la catégorie de problème (depuis les tags, les mots-clés ou une requalification manuelle sur les tickets récents actifs).
• Le remapping des statuts : Crisp a 3 statuts (unresolved, resolved, pending). Votre workflow SAV en a probablement plus. Les tickets en cours doivent être requalifiés dans le bon statut cible lors de la migration.
• Les conversations sans contact identifié : certaines conversations Crisp peuvent être initiées par des visiteurs anonymes (pas d’email). Ces conversations sont rattachées manuellement lors de la migration ou archivées selon leur date.
• L’historique antérieur : décider si toutes les conversations historiques sont migrées (lecture seule dans le nouveau logiciel) ou uniquement les conversations actives.

Ce qui peut rester dans Crisp

Crisp est souvent conservé pour les usages de messagerie temps réel :

• Chat de premier contact : pour les questions rapides qui ne nécessitent pas de suivi structuré, Crisp reste l’outil le plus fluide. Les demandes complexes basculent vers un ticket dans le logiciel SAV.
• Notifications proactives : les messages automatisés Crisp (onboarding, relances) peuvent rester dans Crisp si le logiciel sur mesure ne couvre pas encore ce canal.

SmartBooster identifie explicitement les types de conversations à migrer lors du cadrage initial.

---

Références techniques

• API REST Crisp - Documentation
• Crisp - Conversations
• Crisp - People (Contacts)
• Crisp - Messages