Intégrations API / CRISP

Crisp et votre logiciel : contacts enrichis, support contextuel

Vos agents support répondent dans Crisp sans voir ce que le client a fait dans votre logiciel : sa simulation en cours, son statut de dossier, ses achats récents. Résultat : des questions redondantes, un manque de contexte et des délais de traitement plus longs. SmartBooster développe le pont entre Crisp et votre logiciel sur mesure : quand une conversation s'ouvre, votre logiciel enrichit automatiquement le profil Crisp avec le contexte métier pertinent. L'agent voit directement l'état du dossier client sans quitter Crisp. Cette intégration est en production chez Caprenov+, où les conseillers voient les informations du client dès l'ouverture du chat.

4,7

| Voir nos avis clients

Interface Crisp : inbox partagé et conversation avec données de contact enrichies

L'API CRISP

Ce que nous développons pour connecter Crisp à votre logiciel

L'API REST Crisp et ses webhooks couvrent les conversations, les contacts et les événements en temps réel. SmartBooster développe le connecteur côté serveur avec les règles métier adaptées à votre activité.

Enrichissement des contacts via webhook

Quand une nouvelle conversation s'ouvre dans Crisp, le webhook session:created déclenche une requête vers votre logiciel. Votre base de données répond avec le contexte client (statut, dossier en cours, historique) et SmartBooster met à jour le profil du contact dans Crisp via l'API. L'agent voit directement les informations pertinentes dans la barre latérale Crisp, sans quitter l'interface.

Synchronisation des contacts Crisp vers le logiciel

Un nouveau contact créé dans Crisp (première conversation) est automatiquement créé dans votre logiciel avec ses attributs. À l'inverse, une mise à jour dans votre SI (changement de statut client, renouvellement de contrat) met à jour les données du contact dans Crisp. La synchronisation est pilotée par des règles métier précises : quels champs, dans quelle direction.

Création de tickets SAV depuis les conversations Crisp

Quand un agent Crisp identifie une demande SAV, une action déclenche la création d'un ticket structuré dans votre logiciel : référence produit, catégorie, description extraite de la conversation. Le client reçoit automatiquement un lien vers son portail pour suivre l'avancement. La conversation Crisp reste ouverte pour les échanges temps réel, le ticket prend en charge le suivi structuré.

Contexte métier visible dans la sidebar Crisp

Via le SDK Plugin Crisp, votre logiciel peut afficher directement dans l'interface Crisp un bloc de contexte personnalisé : statut du dossier, dernière commande, simulation en cours, alertes. L'agent dispose du contexte complet sans jongler entre deux outils.

Notifications agents depuis les événements métier

Quand un événement important survient dans votre logiciel (dossier validé, paiement reçu, statut changé), votre logiciel envoie un message dans la conversation Crisp correspondante ou crée une nouvelle conversation proactive vers le client. Le canal Crisp devient le vecteur de notification de votre SI.

LE SILO DE DONNÉES

Ce qui vous coûte du temps sans connecteur Crisp

Crisp stocke vos données métier mais reste un îlot isolé. Les échanges manuels, les doublons de saisie et les limites du no-code s'accumulent au fil du temps.

Un connecteur API sur mesure synchronise vos outils, expose vos données dans les bonnes interfaces et libère vos équipes des tâches répétitives.

Agent support sans contexte métier sur le client

Vos agents Crisp voient le nom et l'email du client, mais pas son historique dans votre logiciel. Pour connaître l'état de son dossier, ils ouvrent votre logiciel dans un autre onglet, cherchent le client manuellement, puis reviennent répondre. Ce va-et-vient est chronophage et source d'erreurs sur les clients avec des noms proches.

Informations de qualification dispersées dans le chat libre

Un client qui contacte le support pour un problème décrit la situation en plusieurs messages. L'agent doit relire la conversation pour extraire les informations utiles. Sans structure imposée, les informations clés (référence produit, numéro de dossier, étape du processus) sont noyées dans le flux de messages.

Pas de lien automatique entre conversation Crisp et dossier logiciel

Quand un agent résout un problème dans Crisp, l'information ne remonte pas dans le logiciel. Le statut du dossier dans votre SI reste inchangé, le responsable ne voit pas la résolution, et le client peut rouvrir une conversation pour le même problème sans que l'agent sache qu'il a déjà été traité.

LE CODE SUR MESURE

Au-delà du no-code : un code développé pour vos règles métier sans limite

Si vos règles métier vivent dans le code et non dans Crisp, une éventuelle migration reste possible le jour où l'éditeur opère des changements qui ne vous conviennent plus, qu'ils soient tarifaires, ergonomiques ou fonctionnels.

Vous envisagez de plutôt remplacer Crisp ?

Sécurité des clés API

Vos identifiants Crisp ne transitent jamais par un tiers. Hébergés en France sur Clever Cloud, chiffrés en variables d'environnement, audités à chaque déploiement.

RÉALISATIONS

Ce que nous avons livré avec Crisp en production

Voir la réalisation

CAPRENOV+

Support client CapRenov+ avec les informations de contact synchronisées

Le support client de CapRenov+ passe par Crisp. Les informations des utilisateurs sont synchronisées depuis le logiciel : l'agent sait à qui il répond et où en est son compte, sans quitter la conversation.

Rénoprim

Même principe sur Rénoprim : contacts synchronisés dans Crisp

Le support de Rénoprim fonctionne sur le même modèle : les informations des artisans inscrits sur la plateforme sont synchronisées dans Crisp, et chaque réponse part avec le contexte du compte.

VOCABULAIRE API

Glossaire de l'API Crisp

Connecter Crisp à votre écosystème ne se limite pas seulement à l'aspect technique. Un bon connecteur repose d'abord sur une compréhension fine du modèle de données de l'outil : ses entités, ses contraintes, ses particularités. Voici les notions clés à connaître avant de développer sur l'API Crisp.

Website (Site web Crisp): Espace de travail Crisp correspondant à un site ou une application. Identifié par un website_id unique utilisé dans tous les appels API. Un compte Crisp peut avoir plusieurs websites.
Session (Conversation): Échange entre un visiteur/client et l'équipe support. Identifié par un session_id unique. Contient les messages, les métadonnées du visiteur et les notes internes. Accessible via les endpoints /website/{website_id}/conversation/{session_id}.
People (Contact Crisp): Profil de contact dans la section CRM de Crisp. Identifié par un people_id. Contient les attributs standard (email, nom, téléphone) et les segments personnalisés. Mis à jour via PUT /website/{website_id}/people/profile/{people_id}.
Conversation Data: Données contextuelles attachées à une conversation Crisp, visibles dans la barre latérale de l'agent. Peut être enrichi via l'API pour afficher des informations métier (statut dossier, historique) sans modifier les messages de la conversation.
Plugin Crisp: Application intégrée à l'interface Crisp via le SDK dédié. Permet d'afficher un bloc de contexte personnalisé dans la sidebar de l'agent ou dans le widget client. Développé en JavaScript, hébergé sur votre infrastructure.
Webhook Crisp: Notification HTTP POST envoyée par Crisp à votre endpoint quand un événement survient (nouvelle conversation, message, mise à jour contact). Configuré dans les paramètres du site web sous Intégrations.

GUIDES PRATIQUES

Premiers pas avec l'API Crisp

API Crisp : créer vos identifiants API pour connecter Crisp à votre logiciel

Guide pas à pas pour créer un token API Crisp et récupérer le website_id avant de connecter Crisp à votre logiciel.

Consulter le guide

RENDEZ-VOUS DÉCOUVERTE GRATUIT

Vos outils ne se parlent pas avec Crisp ?

En 30 minutes d'échange, nous analysons votre situation et vous proposons une architecture de connecteur adaptée à vos processus et à vos volumes.

Appel de 30 min → Analyse gratuite → Proposition sous 5 jours

Prendre rendez-vous

LA MÉTHODOLOGIE

De l'audit à la mise en production de votre connecteur Crisp

Audit de votre usage de Crisp, architecture du connecteur, recette sur un environnement dédié puis monitoring en production : les quatre étapes sont les mêmes quel que soit l'outil connecté. Et quand c'est votre logiciel qui doit exposer ses données à Crisp ou à d'autres outils, le connecteur devient une API développée sur mesure.

Ce qui change ici, ce sont les contraintes propres à l'API Crisp, à commencer par ses identifiants : guide de création d'identifiants API Crisp

Les 4 étapes de la méthodologie

DOCUMENTATION TECHNIQUE

Subtilités techniques de l'API Crisp

Mode d'authentification de l'API

L'API Crisp propose deux modes d'authentification selon vos besoins. Le mode website est rapide à configurer mais reste limité à un seul site (identifiants "hardcodés"). Pour gérer plusieurs clients ou plateformes, un token distinct est requis pour chaque site. À l'inverse, le mode plugin s'inscrit dans la création d'une application (Marketplace ou privée). Le token est ici lié à votre application et non à un site unique. Bien que plus complexe à initialiser, ce mode offre une meilleure scalabilité, une gestion granulaire des permissions et simplifie l'usage des webhooks.

API REST Crisp : authentification et endpoints principaux

Crisp utilise une authentification HTTP Basic Auth avec deux éléments : l'identifier et la key générés dans les paramètres API du compte ou du plugin. Le header d'authentification est : Authorization: Basic base64(identifier:key) avec le header X-Crisp-Tier: user|plugin pour les accès de niveau utilisateur. Les endpoints principaux : GET /website/{website_id}/people/profiles/{people_id} (lire un contact), PUT /website/{website_id}/people/profile/{people_id} (mettre à jour les données d'un contact), GET /website/{website_id}/conversations (lister les conversations), POST /website/{website_id}/conversation/{session_id}/message (envoyer un message dans une conversation). Base URL : https://api.crisp.chat/v1/. Rate limit : en moyenne 200 requêtes par minute, selon les API utilisées.

Webhooks Crisp : structure et événements disponibles

Les webhooks Crisp se configurent dans les paramètres du site web ou du plugin. Événements importants disponibles : session:created (nouvelle conversation), session:updated, message:send (nouveau message), message:received, people:profile:updated (contact mis à jour), conversation:resolved, conversation:pending. Le payload contient le website_id, le session_id et les données de l'événement. SmartBooster développe le handler sécurisé avec vérification du secret webhook et traitement asynchrone.

Pour aller plus loin

Approfondir votre réflexion

Vous envisagez de remplacer Crisp ?

Découvrez ce qu'un logiciel sur mesure peut remplacer dans Crisp et comment SmartBooster accompagne cette transition sans perte de données.

Notre stack technique

Symfony, Vue.js, Clever Cloud : les technologies que nous utilisons pour développer des connecteurs robustes et maintenables dans le temps.

Nos solutions logicielles

CRM, portail client, back-office, tableau de bord : découvrez les types de logiciels que nous développons sur mesure pour les TPE et PME.

FAQ

Les réponses à vos questions

Et si vous ne trouvez pas ce que vous cherchez, nous serons ravis de vous répondre en direct lors d'un rendez-vous entre humains !

Crisp propose deux mécanismes. Le premier : les Conversation Data, des paires clé-valeur attachées à une conversation via l'API (PUT conversation/data), affichées automatiquement dans la barre latérale de l'agent. Le second : le SDK Plugin Crisp, qui permet d'injecter un composant HTML personnalisé dans la sidebar, avec accès aux données de la conversation en temps réel. SmartBooster utilise les Conversation Data pour les contextes simples et le Plugin SDK pour les affichages plus riches.

Oui. Le webhook session:created est envoyé par Crisp dès qu'une conversation est initiée. Votre logiciel reçoit l'événement, interroge sa base de données et met à jour le profil Crisp en quelques secondes. L'agent voit les données enrichies généralement en moins de 3 secondes après l'ouverture de la conversation, avant même d'avoir répondu au client.

Oui. SmartBooster développe une API interne qui sert d'intermédiaire entre Crisp et votre logiciel. Crisp envoie le webhook avec l'email ou l'identifiant du client, votre API renvoie uniquement les données utiles pour l'agent (statut, références), sans exposer les données sensibles (financières, médicales, personnelles). Le niveau de détail affiché est paramétrable selon le rôle de l'agent.

Crisp s'intègre bien dans les contextes où le support client est lié à un dossier ou un processus dans votre logiciel : rénovation énergétique (Caprenov+), e-commerce, formation, SaaS, services à la personne. L'enrichissement via webhook est particulièrement utile quand l'agent a besoin d'un contexte métier immédiat pour répondre efficacement dès la première réponse.