Webhooks Sortants
Les Webhooks Sortants envoient des données de lead depuis LeadHub vers une URL externe chaque fois qu'un événement de lead se produit. Utilisez-les pour synchroniser les leads avec un CRM, déclencher des workflows Zapier ou notifier des systèmes externes.
Comment Fonctionnent les Webhooks Sortants
- Vous créez un webhook sortant avec une URL cible et les événements à écouter.
- Quand l'événement sélectionné se produit (ex. : un nouveau lead est créé), LeadHub envoie une requête HTTP POST à votre URL.
- La charge utile est un objet JSON contenant les données complètes du lead.
Créer un Webhook Sortant
- Allez dans Intégrations → Webhooks Sortants.
- Cliquez sur Nouveau Webhook Sortant.
- Configurez :
| Champ | Description |
|---|---|
| Nom | Nom interne (ex. : "Synchroniser avec HubSpot") |
| URL | Le point de terminaison externe qui reçoit le POST |
| Événements | Quels événements déclenchent ce webhook (voir ci-dessous) |
| Secret | Secret HMAC optionnel pour la vérification de signature de requête |
| Actif | Basculer pour activer ou désactiver |
- Cliquez sur Enregistrer.
Événements Disponibles
| Événement | Quand il se déclenche |
|---|---|
lead.created | Un nouvel enregistrement de lead est créé |
lead.updated | Un lead est modifié |
lead.deleted | Un lead est supprimé |
lead.stage_changed | Un lead passe à une nouvelle étape de pipeline |
lead.assigned | Un lead est assigné à un utilisateur |
form.submitted | Une soumission de formulaire est reçue |
Format de la Charge Utile
Tous les webhooks sortants envoient un corps JSON :
{
"event": "lead.created",
"occurred_at": "2026-04-29T10:30:00Z",
"lead": {
"id": 123,
"first_name": "Jane",
"last_name": "Smith",
"email": "[email protected]",
"phone": "+1-555-000-0000",
"source": "web_form",
"status": "new",
"lead_score": 45,
"pipeline": "Sales Pipeline",
"stage": "New Lead",
"assigned_to": "[email protected]",
"tags": ["vip", "from-webinar"],
"created_at": "2026-04-29T10:30:00Z"
}
}
Vérification de Signature HMAC
Si vous définissez un Secret, LeadHub signe chaque requête avec une signature HMAC-SHA256. La signature est envoyée dans l'en-tête X-LeadHub-Signature.
Pour vérifier (exemple en PHP) :
$computed = 'sha256=' . hash_hmac('sha256', $rawBody, $secret);
if (!hash_equals($computed, $_SERVER['HTTP_X_LEADHUB_SIGNATURE'])) {
http_response_code(401);
exit;
}
Livraison et Nouvelles Tentatives
LeadHub livre les webhooks de manière asynchrone via la file d'attente. Si le point de terminaison externe retourne une réponse non-2xx, la livraison est retentée jusqu' à 3 fois avec un backoff exponentiel.
Voir le Journal Webhook pour consulter l'historique de livraison.
Désactiver vs Supprimer
- Désactiver : Basculez Actif sur off — aucun événement n'est envoyé, mais le webhook est conservé.
- Supprimer : Supprime définitivement la configuration du webhook.