Référence

Webhooks sortants

ReachFlow envoie des requêtes POST HTTPS vers votre serveur lorsque des événements API se produisent. Configuration dans le dashboard.

Enveloppe commune

Corps JSON POST — le champ data varie selon l'événement.

JSON

{
  "event": "message.delivered",
  "data": { ... },
  "createdAt": "2026-06-04T12:00:00.000Z"
}

En-têtes

En-tête	Description
X-ReachFlow-Event	Nom de l’événement (ex. message.delivered).
X-ReachFlow-Signature	HMAC-SHA256 du corps JSON brut, préfixe sha256=.
Content-Type	application/json

Calculez HMAC-SHA256 sur le corps brut (chaîne JSON exacte) avec le secret affiché à la création du webhook.

Événements

message.sent

Message accepté et transmis au canal WhatsApp.

data

{
  "messageId": "7f9e1234-abcd-4ef0-8765-aabbccddeeff",
  "status": "sent",
  "to": "+2250700000000",
  "providerId": "a3f1b2c4-1234-4abc-9def-000011112222"
}

message.delivered

Accusé de livraison WhatsApp reçu.

data

{
  "messageId": "7f9e1234-abcd-4ef0-8765-aabbccddeeff",
  "status": "delivered",
  "to": "+2250700000000",
  "providerId": "a3f1b2c4-1234-4abc-9def-000011112222"
}

message.failed

Échec d’envoi ou de livraison.

data

{
  "messageId": "7f9e1234-abcd-4ef0-8765-aabbccddeeff",
  "status": "failed",
  "to": "+2250700000000",
  "providerId": "a3f1b2c4-1234-4abc-9def-000011112222"
}

webhook.test

Événement de test depuis le dashboard (bouton Tester).

data

{
  "ok": true,
  "source": "reachflow-dashboard"
}