1. Présentation
Le Lead Delivery Webhook pousse chaque piste captée par AES vers un point d’entrée externe choisi par le client, au fil de l’eau. C’est le moyen le plus simple de refléter la captation d’AES dans un système tiers sans accorder d’accès à la plateforme.
La remise se fait en mode push et au moins une fois. Le point d’entrée récepteur doit être idempotent sur event_id.
2. Configuration
La remise se configure par environnement et est désactivée par défaut. Elle s’active depuis le panneau d’administration du client, où l’on définit l’URL de destination et le secret de signature.
| Réglage | Description |
|---|---|
| URL de destination | Point d’entrée HTTPS qui reçoit la charge utile. |
| Secret de signature | Secret partagé servant à calculer l’en-tête de signature. |
| Événements | Quels événements du cycle de vie sont remis. |
| État | La remise reste inactive tant qu’elle n’est pas explicitement activée. |
3. Charge utile
POST {votre_endpoint}
Content-Type: application/json
X-AES-Event: lead.created
X-AES-Signature: sha256=<hmac_hex>
X-AES-Timestamp: 1787923271
{
"event": "lead.created",
"event_id": "evt_71ab30cd",
"lead_id": "AES-38-104772",
"occurred_at":"2026-08-27T14:02:11+02:00",
"contact": {
"name": "Marie Fernande Rios",
"phone_e164": "+33612345678",
"email": "mfrios@example.com"
},
"origin": {
"channel": "landing_form",
"source": "example.com/nord/service",
"campaign": "printemps-nord"
},
"branch_code": "ACME-NORD",
"fields": {
"message": "Souhaite un créneau en soirée."
}
}4. Événements
| Événement | Envoyé lorsque |
|---|---|
lead.created | Une nouvelle piste est captée sur un canal quelconque. |
lead.updated | Les coordonnées ou les champs de qualification changent. |
lead.stage_changed | La piste passe à une autre étape du pipeline. |
5. Signature
signature = HMAC_SHA256(secret, timestamp + "." + raw_body)
header = "sha256=" + hex(signature)Rejeter toute requête dont l’horodatage sort d’une fenêtre de 300 secondes, et comparer les signatures en temps constant.
6. Remise et reprises
AES considère toute réponse 2xx comme acceptée. Tout autre statut, ou un délai supérieur à 10 secondes, est repris avec temporisation exponentielle pendant 24 heures. La remise étant au moins une fois, le point d’entrée récepteur doit dédupliquer sur event_id.
Un échec continu sur toute la fenêtre de reprise désactive la remise et déclenche une alerte dans le panneau du client. La remise reprend lorsque le point d’entrée est corrigé et réactivé.
7. Gestion des versions
De nouveaux champs peuvent être ajoutés sans préavis et les champs non reconnus doivent être ignorés. Aucun champ n’est supprimé ni ne change de sens au sein d’une même version majeure.
Contact
Questions sur cette spécification : developers@omb.cloud.