Les webhooks permettent à Smartsupp d’envoyer des notifications en temps réel à l’URL de votre choix — dès qu’une conversation s’ouvre, qu’un contact est créé ou qu’un message est livré, votre système en est informé. Cet article explique ce que sont les webhooks, comment les configurer dans votre tableau de bord et comment les connecter à des plateformes d’automatisation comme Make et n8n.
Nous avons divisé cet article en plusieurs sections :
À quoi servent les webhooks ?
Un webhook est un message HTTP automatique que Smartsupp envoie à l’URL de votre choix chaque fois qu’un événement sélectionné se produit. Au lieu de vérifier périodiquement les changements, vos outils reçoivent les données dès qu’un événement survient.
Voici quelques cas d’utilisation courants :
Plateformes d’automatisation — déclencher des workflows dans Make, n8n ou des outils similaires pour ajouter des contacts à un CRM, publier des notifications sur Slack ou enregistrer des prospects dans une feuille de calcul
Systèmes internes — transmettre en temps réel les données des conversations et des contacts à des tableaux de bord, des entrepôts de données ou des systèmes de gestion des tickets
Notifications — alerter votre équipe lorsque des conversations sont évaluées ou lorsque la livraison d’un message échoue
Conseil : Les webhooks sont disponibles avec le forfait Plus et les forfaits supérieurs — Plus inclut 1 webhook, Expert en inclut 3 et Ultimate propose une limite personnalisée. Comparer les forfaits →
Créer un webhook
La configuration d’un webhook ne nécessite que quelques étapes dans votre tableau de bord Smartsupp :
1. Ouvrez les Paramètres et accédez à la section Webhooks .
2. Cliquez pour ajouter un nouveau webhook et saisissez votre URL de point de terminaison — l’adresse à laquelle Smartsupp enverra les données des événements.
3. Sélectionnez les événements que vous souhaitez recevoir (voir la liste complète dans la section suivante).
4. Enregistrez le webhook. Dès lors, les événements sélectionnés sont transmis sous forme de requêtes HTTP POST avec des charges utiles JSON.
Remarque : Les webhooks configurés précédemment continuent de fonctionner normalement. Des travaux sont en cours pour rendre tous les webhooks existants visibles et gérables depuis la nouvelle section du tableau de bord.
⚠️ Vous avez déjà créé des webhooks ? Les anciens webhooks n’apparaissent pas encore dans cette section — ils continuent de fonctionner comme auparavant. Nous unifions l’ancien et le nouveau système pour que tout puisse être géré au même endroit.
Événements disponibles
Smartsupp peut informer votre point de terminaison des événements répartis en trois catégories. Sélectionnez uniquement les événements dont votre workflow a réellement besoin — cela limite la charge sur votre point de terminaison et évite le trafic inutile.
Contacts
contact.createdcontact.updatedcontact.acquiredcontact.bannedcontact.unbanned
Conversations
conversation.openedconversation.closedconversation.closed_by_contactconversation.ratedconversation.agent_assignedconversation.agent_unassignedconversation.agent_joinedconversation.agent_leftconversation.agent_repliedconversation.bot_repliedconversation.contact_repliedconversation.message_deliveredconversation.message_delivery_failed
Visiteurs
visitor.connectedvisitor.disconnectedvisitor.updatedvisitor.typingvisitor.triggeredvisitor.replied
Ressources associées : Documentation Smartsupp pour les développeurs — schémas complets des charges utiles JSON pour chaque type d’événement.
Tester votre webhook
Avant la mise en production, utilisez la fonctionnalité de test intégrée pour vérifier que votre point de terminaison est accessible et que votre scénario Make ou n8n est correctement configuré.
Dans les paramètres de votre webhook dans le tableau de bord, cliquez sur Envoyer un test. Smartsupp enverra un exemple de charge utile à l’URL de votre point de terminaison. Vérifiez votre service de réception pour confirmer que les données sont arrivées au format attendu.
Conseil : Dans Make, votre scénario doit être actif et à l’écoute avant l’envoi du test. Dans n8n, basculez le nœud Webhook vers son URL de production et assurez-vous que le workflow est actif.
Livraison, nouvelles tentatives et sécurité
Smartsupp est conçu pour transmettre les événements des webhooks de manière fiable, même lorsque votre point de terminaison est temporairement indisponible.
Format — tous les événements sont envoyés sous forme de requêtes HTTP POST avec un corps JSON décrivant l’événement et ses données
Réponse — votre point de terminaison doit répondre avec un code de statut HTTP 2xx le plus rapidement possible ; les réponses lentes peuvent retarder les nouvelles tentatives
Nouvelles tentatives — si la livraison échoue, Smartsupp réessaie avec des délais croissants pendant une durée maximale de 3 jours
Désactivation automatique — les points de terminaison qui échouent de manière persistante sont automatiquement désactivés ; vous pouvez les réactiver à tout moment dans le tableau de bord
Sécurité — chaque requête de webhook est signée pour que vous puissiez vérifier qu’elle provient bien de Smartsupp ; consultez docs.smartsupp.com pour connaître les détails de la vérification de signature
Remarque : Si votre point de terminaison est désactivé en raison d’échecs répétés, réactivez-le dans Paramètres → Webhooks après avoir corrigé le problème sous-jacent. Smartsupp reprendra immédiatement l’envoi des événements.
Connecter Smartsupp à Make ou n8n
La connexion de Smartsupp à une plateforme d’automatisation s’effectue en quatre étapes. Le processus est le même pour Make et n8n — seul le nœud déclencheur diffère.
1. Dans Make, ajoutez un déclencheur Webhooks → Webhook personnalisé et copiez l’URL générée. Dans n8n, ajoutez un nœud déclencheur Webhook et copiez son URL de production.
2. Dans Smartsupp, accédez à Paramètres → Webhooks, créez un nouveau webhook et collez l’URL copiée.
3. Sélectionnez les événements dont vous avez besoin et enregistrez le webhook.
4. Cliquez sur Envoyer un test pour que Make ou n8n capture la structure des données — puis construisez le reste de votre scénario ou workflow à partir de celle-ci.
Conseil : Dans Make, activez votre scénario avant d’envoyer le test — sinon les données du webhook ne seront pas capturées. Dans n8n, utilisez l’URL de production (et non l’URL de test) lors de la configuration du webhook Smartsupp.
Et ensuite ?
API REST Smartsupp — explorez l’API complète pour lire et écrire les données Smartsupp par programmation.
Automatisations — configurez des automatisations basées sur des règles qui se déclenchent directement dans Smartsupp, sans outil externe.
Vue d’ensemble des intégrations — consultez toutes les intégrations natives disponibles avec les CRM, les plateformes de commerce électronique et bien plus encore.
💡 Besoin d’aide supplémentaire ? Contactez notre équipe d’assistance — nous serons ravis de vous aider !