Webhooks sortants : fonctionnement
SendApp appelle votre serveur quand quelque chose se passe dans votre compte : un message arrive ou part, WhatsApp met à jour le statut d'un message, une campagne démarre ou se termine, un modèle WhatsApp est approuvé ou refusé, un rendez-vous est pris. Cela se configure dans Paramètres → Webhook : jusqu'à 10 adresses, chacune avec son compte IA et ses événements.
Chaque appel est une requête POST avec un corps JSON et les en-têtes
X-SendApp-Event, X-SendApp-Delivery (l'id unique de la livraison), X-SendApp-Attempt et X-SendApp-Signature.Vérifiez la signature :
X-SendApp-Signature vaut t=<timestamp>,v1=<HMAC-SHA256 de "timestamp.corps">, calculé avec la clé secrète du webhook (Paramètres → Webhook → Afficher la clé de signature). Refusez les requêtes dont le timestamp a plus de 5 minutes.Répondez avec un code 2xx sous 10 secondes : sinon nous réessayons après 1, 5 et 30 minutes. Un code 4xx (sauf 408 et 429) n'est pas renouvelé. Après 20 livraisons échouées d'affilée, le webhook est désactivé : réactivez-le dans Paramètres → Webhook.
Chaque livraison a un
delivery_id unique, identique à chaque tentative : utilisez-le pour ignorer les doublons. L'ordre d'arrivée n'est pas garanti : pour ordonner les événements, utilisez occurred_at (et timestamp pour les statuts).Le corps contient toujours
event, occurred_at, account_ref, training_token (le compte IA) et delivery_id. account_ref identifie votre compte et n'est pas une clé : le corps ne contient jamais votre clé API. Photos, audios, vidéos et documents arrivent sous forme de liens, jamais de fichiers.Depuis Paramètres → Webhook, vous pouvez envoyer un test de chaque événement : il arrive avec
"test": true. Le journal montre chaque livraison avec le corps envoyé et la réponse de votre serveur.Paramètres
8 · 0 obligatoires
message.received
facultatif
Un client vous écrit, sur n'importe quel canal.
message.sent
facultatif
Un message part : IA, opérateur, campagne, automatisation, API.
message.status
facultatif
Un message WhatsApp a été remis, lu ou non remis (avec le code d'erreur de Meta).
campaign.started
facultatif
Une campagne commence à envoyer.
campaign.completed
facultatif
Une campagne est terminée, avec ses chiffres.
campaign.failed
facultatif
Une campagne s'est arrêtée à cause d'une erreur.
template.status_changed
facultatif
Un modèle WhatsApp a été approuvé, refusé, mis en pause ou désactivé, avec le motif.
booking.* / voice.*
facultatif
Les rendez-vous de l'Agenda et les appels de la Voice AI : mêmes adresses, même signature.
Besoin d'aide pour l'intégration ? info@sendapp.live