Les webhooks sortants
Équipe nBot · Lecture 6 min Mis à jour le 6 octobre 2026 Envoyer vos conversations et vos formulaires vers votre CRM, Zapier, Make ou n8n à chaque événement, vérifier la signature et suivre les livraisons.
Les webhooks sortants envoient les événements de vos conversations et de vos formulaires à votre propre adresse. Réservé aux administrateurs. Cette section dépend de votre offre : c’est l’add-on Webhooks sortants.
Les webhooks poussent les événements vers vous. Pour que vos outils viennent lire ou modifier vos données dans nBot, voir plutôt L’API publique de nBot.
Ouvrez la section Webhooks
- Ouvrez Réglages › Réglages, puis la section Webhooks.
- Si vous lisez Webhooks sortants désactivés, l’add-on n’est pas activé pour votre organisation : demandez-le à l’équipe nBot.
Ajoutez un endpoint
- Dans Ajouter un endpoint, collez l’adresse qui recevra les envois. Elle doit commencer par
https://. - Cliquez sur les événements voulus. Aucun événement sélectionné = tous les événements.
- Si vous avez plusieurs widgets, cliquez sur ceux qui vous intéressent. Aucun widget sélectionné = tous les widgets de l’organisation.
- Cliquez sur Créer l’endpoint.
- Le Secret de signature s’affiche une seule fois : cliquez sur Copier, rangez-le en lieu sûr, puis sur J’ai copié le secret.
L’interrupteur de chaque endpoint le met en pause ou le réactive ; la corbeille le supprime. Pour changer d’adresse, supprimez l’endpoint et créez-en un nouveau.
Choisissez les événements
| Événement | Quand il part |
|---|---|
conversation.started | Un visiteur commence une conversation dans un widget. |
conversation.waiting_for_agent | La conversation attend un humain : le visiteur ou l’IA a demandé le relais. |
message.created | Un nouveau message arrive dans le chat du widget. Les messages d’une même conversation sont regroupés : un envoi au plus toutes les 10 secondes. |
conversation.closed | La conversation est fermée. L’envoi contient tout l’échange. |
form.submitted | Une réponse arrive d’un formulaire de votre site, d’une landing page ou d’un formulaire nBot. |
form.prospect | Une réponse est classée comme prospect, par l’IA ou par votre équipe. |
Chaque envoi est un POST en JSON. Il contient l’événement, sa date, le widget et la conversation (nom et e-mail du visiteur, statut, résumé et sentiment s’ils existent), ou, pour un formulaire, le contact, son message, tous les champs et le tri de l’IA (catégorie, prospect, spam).
Vérifiez la signature
Chaque envoi porte ces en-têtes :
X-Nbot-Signature-256:sha256=suivi de la signature HMAC SHA-256 du corps brut, calculée avec votre secret ;X-Nbot-Event: le nom de l’événement ;X-Nbot-Event-Id: un identifiant unique, pour ignorer un envoi déjà traité ;X-Nbot-Delivery-Attempt: le numéro de la tentative.
Recalculez la signature sur le corps tel que reçu, avant de le lire en JSON, et refusez l’envoi si elle diffère.
Suivez les livraisons
Votre serveur doit répondre par un code 2xx en moins de 10 secondes ; les redirections ne sont pas suivies. Sinon, nBot réessaie après 1 minute, puis en doublant l’attente jusqu’à une fois par heure, et abandonne 24 heures après l’événement.
Cliquez sur Journal, sur la ligne d’un endpoint, pour voir ses 50 derniers envois : l’événement, le statut (succès, en attente, en cours ou abandonné), le nombre de tentatives, le code HTTP reçu et l’erreur éventuelle.
Astuce · Sans l’add-on, chaque widget a aussi un onglet Webhooks dans Assistant IA › Widgets : une URL du webhook, ses Événements et un Secret HMAC (optionnel), avec un bouton Tester.
