Les webhooks permettent à Smartsupp d’envoyer des notifications en temps réel vers l’URL de votre choix — dès qu’une conversation s’ouvre, qu’un contact est créé ou qu’un message est remis, votre système en est immédiatement 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é l’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. Plutôt que d’interroger les changements, vos outils reçoivent les données au moment même où quelque chose se passe.

Les cas d’utilisation typiques incluent :

Plateformes d’automatisation — déclencher des workflows dans Make, n8n ou des outils similaires pour ajouter des contacts dans un CRM, publier des notifications dans Slack ou enregistrer des prospects dans une feuille de calcul
Systèmes internes — alimenter les tableaux de bord, entrepôts de données ou systèmes de tickets avec les données de conversation et de contact en temps réel
Notifications — alerter votre équipe lorsque des conversations sont évaluées ou lorsque la remise de messages échoue

Conseil : Les webhooks sont disponibles à partir du plan Plus — Plus inclut 1 webhook, Expert en inclut 3 et Ultimate offre une limite personnalisée. Comparer les plans →

Créer un webhook

La configuration d’un webhook ne prend que quelques étapes dans votre tableau de bord Smartsupp :

1. Ouvrez Paramètres et accédez à la section Webhooks.
2. Cliquez pour ajouter un nouveau webhook et saisissez l’URL du point de terminaison — l’adresse à laquelle Smartsupp enverra les données d’é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. À partir de ce moment, les événements sélectionnés sont remis sous forme de requêtes HTTP POST avec des charges utiles JSON.

Remarque : Les webhooks précédemment configurés continuent de fonctionner normalement. Des efforts sont en cours pour rendre tous les webhooks existants visibles et gérables depuis la nouvelle section du tableau de bord.

Événements disponibles

Smartsupp peut notifier votre point de terminaison sur des événements dans trois catégories. Ne sélectionnez que les événements dont votre workflow a réellement besoin — cela allège votre point de terminaison et évite un trafic inutile.

Contacts

contact.created
contact.updated
contact.acquired
contact.banned
contact.unbanned

Conversations

conversation.opened
conversation.closed
conversation.closed_by_contact
conversation.rated
conversation.agent_assigned
conversation.agent_unassigned
conversation.agent_joined
conversation.agent_left
conversation.agent_replied
conversation.bot_replied
conversation.contact_replied
conversation.message_delivered
conversation.message_delivery_failed

Visiteurs

visitor.connected
visitor.disconnected
visitor.updated
visitor.typing
visitor.triggered
visitor.replied

Ressources connexes : Documentation développeur Smartsupp — schémas complets de charge utile JSON pour chaque type d’événement.

Tester le 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é.

Depuis les paramètres de 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 dans le format attendu.

Conseil : Dans Make, votre scénario doit être actif et en écoute avant d’envoyer le test. Dans n8n, basculez le nœud Webhook vers son URL de production et assurez-vous que le workflow est actif.

Remise, tentatives et sécurité

Smartsupp est conçu pour remettre les événements webhook 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 aussi rapidement que possible ; des réponses lentes peuvent retarder les tentatives
Tentatives — en cas d’échec de remise, Smartsupp réessaie avec des délais croissants pendant jusqu’à 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 dans le tableau de bord à tout moment
Sécurité — chaque requête webhook est signée pour que vous puissiez vérifier qu’elle provient bien de Smartsupp ; consultez docs.smartsupp.com pour les détails de 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 résolu le problème sous-jacent. Smartsupp reprendra immédiatement l’envoi des événements.

Connecter Smartsupp à Make ou n8n

Connecter Smartsupp à une plateforme d’automatisation nécessite 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 capturent la structure des données — puis construisez le reste de votre scénario ou workflow sur cette base.

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 (pas l’URL de test) lors de la configuration du webhook Smartsupp.

Et ensuite ?

Smartsupp REST API — explorez l’API complète pour lire et écrire des 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.
Aperçu des intégrations — découvrez toutes les intégrations natives disponibles avec les CRM, les plateformes e-commerce et plus encore.

💡 Besoin d’aide supplémentaire ? Contactez notre équipe d’assistance — nous serons ravis de vous aider !

Webhooks : Connecter Smartsupp à Make, n8n et vos propres outils