NudgeDocs
API et MCP

Événements

Les événements qu'un webhook Nudge peut recevoir, quand ils se déclenchent et ce que contient leur payload.

Enveloppe

Chaque livraison de webhook a la même enveloppe :

{
  "event": "lead_created",
  "timestamp": "2026-11-02T09:14:07.512Z",
  "data": { },
  "organization_id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b"
}

Champ

Type

Voir Webhooks pour les en-têtes, la signature et les règles de livraison.

Catalogue des événements

ÉvénementLibellé dans NudgeStatut
lead_createdLead createdLivré
booking_createdBooking createdPas encore livré
booking_cancelledBooking cancelledPas encore livré
booking_rescheduledBooking rescheduledPas encore livré
outcome_setOutcome recordedPas encore livré
contact_updatedContact updatedPas encore livré
form_submittedForm submittedPas encore livré
contact_disqualifiedContact disqualifiedPas encore livré

Les événements « Pas encore livré » peuvent déjà être cochés sur un webhook, mais Nudge ne les envoie pas aujourd'hui. S'y abonner n'a pour l'instant aucun effet. Pour suivre les rendez-vous, utilisez les intégrations Slack ou CRM, ou lisez les rendez-vous avec le serveur MCP.

lead_created

Envoyé quand un visiteur laisse ses coordonnées via l'un de vos formulaires : un formulaire classique, une page de réservation ou l'étape de réservation de l'agent site web.

Il n'est pas envoyé quand :

  • la soumission est bloquée ou disqualifiée par les règles du formulaire ;
  • la soumission est un test (aperçu ou mode test) ;
  • le contact est créé autrement : par l'API de réservation IA, le serveur MCP, un import ou une création manuelle dans l'application.

Payload

{
  "event": "lead_created",
  "timestamp": "2026-11-02T09:14:07.512Z",
  "data": {
    "id": "6f0c2d1e-8b7a-4c5d-9e3f-2a1b0c9d8e7f",
    "email": "jane@example.com",
    "lead_score": 72,
    "form_id": "a1b2c3d4-e5f6-4a7b-8c9d-0e1f2a3b4c5d"
  },
  "organization_id": "9e8d7c6b-5a4f-4e3d-8c2b-1a0f9e8d7c6b"
}

Champ

Type

Le payload est volontairement court. Pour obtenir le reste du contact (nom, téléphone, réponses, source, étape du pipeline), cherchez-le dans Nudge, par exemple avec l'outil MCP contacts__find_contacts_by_email.

Exemple : envoyer les nouveaux leads vers Zapier

Créez un Zap

Dans Zapier, démarrez un Zap avec le déclencheur Webhooks by Zapier → Catch Hook et copiez l'URL fournie par Zapier.

Créez le webhook dans Nudge

Dans Intégrations → Zapier, cliquez sur Ajouter un webhook, collez l'URL, cochez Lead created et cliquez sur Créer.

Envoyez un vrai lead

Soumettez l'un de vos formulaires depuis votre site en ligne (pas en mode test) pour que Zapier reçoive un exemple, puis associez data.email et data.lead_score à l'étape suivante de votre Zap.

Sur cette page