Webhooks et callbacks de statut de livraison (DLR)
Les webhooks vous permettent de recevoir en temps réel les mises à jour de statut de vos messages, sans avoir à interroger l'API en boucle (polling).
Configuration
Dans Paramètres > API > Webhooks, renseignez l'URL de votre endpoint qui recevra les notifications POST.
Types de callbacks disponibles
- Statut d'envoi sortant : accusé de réception (délivré, échoué, expiré) pour chaque message envoyé
- Message entrant : réponses SMS ou WhatsApp reçues de vos destinataires
- Callback STOP : notification lorsqu'un contact se désinscrit
Exemple de payload reçu
{
"event": "message.delivered",
"message_id": "msg_8f2a1c",
"to": "+212661234567",
"operator": "IAM",
"status": "delivered",
"timestamp": "2026-07-02T14:32:10Z"
}Sécurisation des webhooks
Chaque requête webhook est signée via un en-tête X-EnvoiSMS-Signature, calculé en HMAC-SHA256 à partir de votre secret webhook. Vérifiez toujours cette signature côté serveur avant de traiter la donnée, afin de vous prémunir contre les fausses notifications.