Webhooks, Zapier et Make
Envoyez les événements Nudge vers votre CRM, Zapier, Make ou votre propre endpoint, et vérifiez chaque livraison.
Ce que font les webhooks sortants
Un webhook est une URL que Nudge appelle chaque fois qu'un événement choisi se produit dans votre espace. Nudge envoie une requête HTTPS POST avec un corps JSON qui décrit l'événement. Tout ce qui sait recevoir un webhook peut y réagir : Zapier, Make, n8n, le point d'entrée de votre CRM ou votre propre serveur.
Cette page explique la configuration depuis l'application. Le format des payloads, les en-têtes et la vérification de signature sont documentés dans la référence API : Webhooks et payloads d'événements.
Qui peut gérer les webhooks
Les webhooks se gèrent depuis Intégrations › Zapier, ce qui demande la permission Manage API keys & webhooks en plus de l'accès à Intégrations. Par défaut, seuls les Administrateurs ont les deux.
Créer un webhook
Ouvrez le panneau des webhooks
Dans Intégrations, trouvez Zapier sous Alertes et automatisation et cliquez sur Configurer (ou Gérer dès qu'un webhook existe). La page liste vos webhooks ; c'est la même liste que vous utilisiez Zapier, Make ou votre propre endpoint.
Ajoutez l'endpoint
Cliquez sur Ajouter un webhook et renseignez :
- URL du endpoint : l'URL complète qui recevra les événements. Elle doit commencer par
https://et pointer vers une adresse publique. Les adresses locales ou privées (commelocalhostou192.168.x.x) sont refusées. - Événements : cochez au moins un événement (voir le tableau ci-dessous).
- Secret de signature (optionnel) : un secret de votre choix, par exemple une longue chaîne aléatoire commençant par
whsec_. S'il est renseigné, chaque livraison est signée en HMAC-SHA256 pour que votre endpoint vérifie qu'elle vient bien de Nudge.
Conservez le secret
Cliquez sur Créer. Si vous avez saisi un secret de signature, un panneau jaune Copiez votre secret de signature maintenant l'affiche une dernière fois. Enregistrez-le dans la configuration de votre endpoint : il n'est plus jamais affiché. Le webhook porte ensuite un badge Signé.
Les événements disponibles
Les libellés de la liste Événements sont affichés en anglais dans l'application.
| Libellé | Événement | Envoyé quand |
|---|---|---|
| Lead created | lead_created | Un visiteur laisse ses coordonnées dans l'un de vos formulaires ou au Website Agent, ou un contact est créé via l'API Nudge. |
| Contact updated | contact_updated | Un contact est modifié via l'API Nudge. |
| Booking created | booking_created | Un rendez-vous est créé via l'API Nudge. |
| Booking rescheduled | booking_rescheduled | Un rendez-vous est reprogrammé via l'API Nudge. |
| Booking cancelled | booking_cancelled | Un rendez-vous est annulé via l'API Nudge. |
| Outcome recorded | outcome_set | Le résultat d'un rendez-vous est enregistré via l'API Nudge. |
| Form submitted | form_submitted | Proposé dans l'application, pas encore envoyé. |
| Contact disqualified | contact_disqualified | Proposé dans l'application, pas encore envoyé. |
Événements de rendez-vous et application
Aujourd'hui, les événements de rendez-vous et de résultat sont envoyés pour les changements faits via l'API Nudge. Les rendez-vous pris par les visiteurs sur votre site ou vos pages de réservation déclenchent Lead created quand le visiteur laisse ses coordonnées. Pour être prévenu en temps réel de chaque nouveau rendez-vous et de chaque annulation, configurez aussi Slack.
Les envois faits en aperçu ou en mode test ne déclenchent pas de webhook.
Connecter Zapier
Créez le déclencheur dans Zapier
Créez un Zap avec le déclencheur Webhooks by Zapier › Catch Hook. Zapier vous donne une URL de webhook dédiée.
Ajoutez-la dans Nudge
Dans Intégrations › Zapier, cliquez sur Ajouter un webhook, collez l'URL Zapier dans URL du endpoint, cochez Lead created (et tout autre événement utile), puis Créer.
Envoyez un premier événement et reliez les champs
Remplissez l'un de vos formulaires, ou discutez avec le Website Agent et laissez une adresse e-mail, lors d'une vraie visite (hors test). Zapier reçoit l'événement ; utilisez ses champs pour construire l'action, par exemple Create contact dans HubSpot ou Add row dans Google Sheets.
Connecter Make
Dans Make, ajoutez un module Webhooks › Custom webhook en première étape d'un scénario et copiez son adresse. Dans Nudge, ajoutez un webhook avec cette adresse et les événements voulus. Lancez le scénario une fois, puis déclenchez un vrai événement pour que Make apprenne la structure des données.
Gérer vos webhooks
Chaque webhook de la liste affiche son URL, ses événements et, s'il a un secret, le badge Signé. À droite :
- L'interrupteur met en pause ou relance les livraisons. Un webhook en pause ne reçoit rien.
- Journaux de livraison (icône œil) affiche les 20 dernières livraisons : l'événement, la date et l'heure, et le code HTTP renvoyé par votre endpoint. Un badge rouge signale un échec (un code d'erreur ou aucune réponse).
- Supprimer (icône corbeille) retire le webhook immédiatement, sans confirmation.
Un webhook ne se modifie pas. Pour changer son URL, ses événements ou son secret, créez un nouveau webhook et supprimez l'ancien.
Comportement des livraisons
- Votre endpoint dispose de 10 secondes pour répondre. Au-delà, la livraison est enregistrée en échec.
- Tout code
2xxcompte comme un succès. Répondez vite et faites le traitement lourd ensuite. - Une livraison en échec n'est pas renvoyée. Consultez les journaux de livraison si vous soupçonnez un trou.
- Chaque requête porte
Content-Type: application/jsonetUser-Agent: Nudge-Webhook/1.0. Les webhooks signés portent aussi un en-têteX-Nudge-Signature. Voir Webhooks et payloads d'événements pour le format exact et la vérification.
FAQ
Slack
Publiez les nouveaux rendez-vous, les annulations et les briefs du Handoff Agent dans un canal Slack grâce à un webhook entrant.
Pixels et balises
Renvoyez les vues, les leads et les rendez-vous pris de votre tunnel Nudge vers Meta ou Google Tag Manager, depuis le navigateur et depuis les serveurs de Nudge.