Intégrations API / CRISP
Crisp et votre logiciel sur mesure : enrichissement des contacts et support contextuel sans double saisie
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.
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
Zapier, Make et n8n couvrent beaucoup de cas. Quand vos règles métier deviennent complexes à maintenir, le code sur mesure offre ce que le no-code ne peut pas garantir : une personnalisation sans contrainte, une propriété totale du code et des tests automatisés qui assurent la stabilité du logiciel là où un workflow cassé passe souvent inaperçu.
Autre avantage souvent sous-estimé : si vos règles métier vivent dans le code et non dans Crisp, cela facilite une éventuelle migration si l'éditeur de votre outil opère des changements qui ne vous conviennent plus (tarifaires, ergonomiques ou fonctionnels).
Logique métier sans contrainte
Conditions imbriquées, calculs intermédiaires, transformations spécifiques : le code applique exactement vos règles, pas celles que le no-code autorise.
Vous êtes propriétaire du code
Le code développé vous appartient entièrement. Hébergé sur votre infrastructure, versionné, documenté : vous ne dépendez d'aucun éditeur tiers pour faire évoluer vos intégrations.
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.
Tests automatisés
Chaque flux est couvert par des tests : un workflow no-code qui casse ne prévient pas, un test qui échoue, si. Comportement garanti dans la durée.
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.
RÉPONDRE À VOS ENJEUX
Au-delà du logiciel, des solutions à vos blocages quotidiens
Email + mot de passe, lien magique, SSO ou social login.
Contrôlez qui accède à quoi.
Faites circuler vos données entre vos outils.
Confirmations, relances et alertes déclenchées au bon moment, avec délivrabilité et traçabilité intégrées.
Fiabilisez la donnée avec des interfaces de saisie guidées.
Organisez et visualisez l'avancement de vos projets.
Éliminez la saisie manuelle.
Sécurisez vos chiffres.
Trouvez n'importe quelle information en moins de 5 secondes.
Affectez vos ressources sans conflit ni ressaisie.
Laissez vos clients réserver leurs créneaux en autonomie.
Libérez votre charge mentale. Automatisez vos rappels.
Générez automatiquement vos rapports d'activité périodiques.
Suivez vos marges, factures et indicateurs financiers en temps réel.
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
LA MÉTHODOLOGIE
De l'audit à la mise en production de votre connecteur Crisp
Étape 1 : Audit
Cartographie de votre métier, vos données et votre usage de Crisp
Avant d'écrire une ligne de code, nous analysons votre organisation : votre métier, vos données, les fonctionnalités de Crisp que vous utilisez réellement, et les autres outils en place.
Cette cartographie dessine une vision claire de ce qui doit être connecté, ce qui peut être automatisé, ce qui mérite d'être enrichi par une interface sur mesure, et ce qui gagnerait à être transféré dans votre propre base de données pour en reprendre la maîtrise complète.
Avant de démarrer, vous aurez besoin de générer vos identifiants API Crisp : guide de création d'identifiants API Crisp
Votre métier et vos données
Compréhension de vos processus, de vos entités clés et de la façon dont Crisp s'intègre dans votre quotidien opérationnel.
Votre écosystème applicatif
Inventaire des outils en place (ERP, CRM, logiciel métier) et identification des flux à synchroniser avec Crisp.
Plan de connexion validé
Architecture de la solution, priorisation des flux et estimation. Vous validez avant de démarrer.
Étape 2 : Conception
Architecture de la solution sur mesure
Nous concevons l'architecture du connecteur ou de l'interface : modèle de données, mapping des entités Crisp vers vos systèmes, règles de transformation et gestion des erreurs.
Chaque décision technique est documentée et validée avec vous avant de passer au développement, pour éviter les surprises en cours de route.
Architecture du connecteur
Choix techniques adaptés à vos volumes et à votre fréquence de synchronisation, en tenant compte des limites de taux de l'API Crisp.
Mapping des entités
Correspondance entre les entités Crisp et votre modèle de données cible, avec les règles de transformation et de validation.
Gestion des erreurs
Stratégie de reprise en cas d'échec, alertes et traçabilité des échanges pour ne jamais perdre une transaction.
Étape 3 : Développement & mise en production
Environnement de recette dédié, zéro modification directement en production
Chaque fonctionnalité est développée et testée sur un environnement de recette isolé, identique à la production. Vous validez sur des données réelles avant toute mise en ligne, sans jamais exposer vos utilisateurs à un connecteur instable.
C'est une différence fondamentale avec les agences no-code, qui modifient souvent les workflows directement en production : une erreur de configuration devient immédiatement visible par vos équipes, vos clients ou vos partenaires.
Développement itératif
Livraisons régulières avec démonstration sur l'environnement de recette. Chaque cycle intègre vos retours avant de passer au suivant.
Recette en conditions réelles
Vous testez et validez le connecteur sur vos propres données, dans un environnement identique à la production. Zéro surprise à la mise en ligne.
Bascule en production maîtrisée
La production ne reçoit que du code validé. Pas de modification à chaud, pas de régression silencieuse : chaque déploiement est préparé et contrôlé.
Étape 4 : Monitoring & maintenance
Monitoring et maintenance évolutive, votre connecteur reste robuste dans la durée
Une fois en production, le monitoring est dimensionné selon les contraintes réelles du projet. Selon les besoins, nous pouvons développer un historique des appels API, des statistiques d'utilisation ou un système d'alertes en cas d'échec. Rien de superflu : c'est le sur mesure qui permet de se concentrer sur ce qui est vraiment essentiel pour votre projet.
Votre outil évolue ? L'API change ? Notre équipe maintient et adapte le connecteur dans le cadre de la maintenance évolutive.
Alertes en temps réel
Notification immédiate en cas d'échec de synchronisation ou de dépassement de quota API, avant que vos équipes ne s'en aperçoivent.
Tableau de bord de supervision
Vue complète des échanges : volume, statut, temps de réponse et historique des erreurs pour chaque flux.
Maintenance évolutive
Mises à jour de l'API Crisp, évolution de vos processus, nouveaux flux : notre équipe assure la continuité de service dans la durée.
DOCUMENTATION TECHNIQUE
Subtilités techniques de l'API Crisp
Mode d'authentification de l'API
Mode d'authentification de l'API
API REST Crisp : authentification et endpoints principaux
API REST Crisp : authentification et endpoints principaux
Webhooks Crisp : structure et événements disponibles
Webhooks Crisp : structure et événements disponibles
CAS D'USAGES
Ce que nous pouvons construire avec l'API Crisp
Portail client
Donnez à vos clients un accès direct à leurs données dans Crisp : statuts de projets, avancements, documents partagés. Vous maîtrisez l'interface et votre image de marque, sans exposer votre base brute.
Formulaire et simulateur
Créez des formulaires intelligents qui écrivent directement dans Crisp avec prise de coordonnées, calculs conditionnels et envoi automatique de confirmation. Idéal pour les devis, les inscriptions ou les demandes de renseignements.
Tableau de bord et reporting
Agrégez les données de Crisp dans un dashboard interactif avec graphiques, filtres et exports. Partagez des indicateurs clés avec votre direction ou vos partenaires sans leur donner accès à l'intégralité de la base.
Pour aller plus loin
Approfondir votre réflexion
Découvrez ce qu'un logiciel sur mesure peut remplacer dans Crisp et comment SmartBooster accompagne cette transition sans perte de données.
Symfony, Vue.js, Clever Cloud : les technologies que nous utilisons pour développer des connecteurs robustes et maintenables dans le temps.
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.