Webhooks sortants

Concept

Volia peut pousser des events HTTP vers votre serveur dès qu'ils se produisent, plutôt que de vous faire poller l'API.

Events disponibles

Event	Quand
`prospect.created`	Nouveau prospect ajouté
`prospect.enriched`	Email trouvé via waterfall
`campaign.launched`	Campagne démarrée
`campaign.completed`	Tous les emails envoyés
`email.sent`	Email envoyé
`email.opened`	Email ouvert (warning: open tracking biased)
`email.clicked`	Lien cliqué
`email.replied`	Reply reçu
`email.bounced`	Hard bounce
`email.unsubscribed`	Désinscription
`deal.created`	Nouveau deal CRM
`deal.stage_changed`	Deal changé d'étape
`deal.won` / `deal.lost`	Deal clôturé

Configurer un webhook

Allez sur Paramètres → Webhooks.
Cliquez + Nouveau webhook.
Configurez :

- URL endpoint : votre serveur HTTPS (HTTPS obligatoire, HTTP refusé).

- Events : cochez ceux à recevoir.

- Secret : auto-généré, sert à signer les payloads.

Sauvegarde.

Payload format

POST JSON :

{
  "event": "deal.created",
  "occurred_at": "2026-05-12T14:32:01Z",
  "data": {
    "id": "deal_xxx",
    "name": "Garage Dupont — site web",
    "value": 5000,
    "stage": "Nouveau lead",
    "pipeline": "Sales B2B",
    ...
  }
}

Header signature :

X-Volia-Signature: sha256=abc123...

Vérifiez la signature côté serveur avec votre secret (HMAC-SHA256 sur le body).

Retry policy

Si votre endpoint répond ≠ 2xx :

Retry après 30 sec, 2 min, 10 min, 1 h, 6 h, 24 h.
Après 6 tentatives échouées : webhook désactivé automatiquement + alerte email.

Logs et debug

Paramètres → Webhooks → votre webhook → Logs :

Historique des 100 derniers événements envoyés.
Status HTTP, body de la réponse, durée.
Bouton Replay pour rejouer un event.

FAQ rapide

Multiples endpoints possibles ? Oui : 1 endpoint (Gratuit / Prospection), illimité (MAX).

Test endpoint avant prod ? Utilise webhook.site pour voir les payloads.

Délai max avant timeout ? Votre endpoint doit répondre en < 10 sec.