Enregistrez dans le tableau de bord un endpoint HTTPS de votre système pour recevoir les retours.
Webhooks de statut
Recevez dans votre système le statut des messages WhatsApp.
Configurez une URL pour recevoir des événements standardisés de création, livraison, lecture et erreur, et consultez l’historique des livraisons via l’API quel que soit le type de connexion choisi.
Flux
WPP Marketing notifie votre système lorsque le statut change.
Les webhooks de statut sont utiles pour l'audit, la réconciliation, les tableaux de bord internes, le support et les règles de votre propre système.
Le webhook informe du résultat d'un message ; ce n'est pas une requête d'envoi. Utilisez le Messaging API para envoyer des messages et le Events API pour déclencher des automatisations avec des événements commerciaux pris en charge.
Activez uniquement les statuts dont votre système a besoin pour éviter le bruit opérationnel.
La création, la livraison, la lecture ou l'erreur sont normalisées de la même manière, quelle que soit la connexion choisie.
Votre endpoint traite le payload et l'historique des livraisons devient disponible dans le tableau de bord et via GET /webhooks.
Événements disponibles et consultation des livraisons.
Les quatre événements utilisent le même contrat sur n'importe quelle connexion, et l'API permet de consulter le résultat de chaque tentative de livraison.
POST
MESSAGE_CREATED
Le message a été créé dans le flux et a reçu un identifiant pour le suivi.
Criação
POST
MESSAGE_DELIVERED
Le message a été remis au destinataire lorsque le canal renvoie une confirmation.
Entrega
POST
MESSAGE_READ
Message lu lorsque l'accusé de lecture est disponible.
Leitura
POST
MESSAGE_ERROR
Le message a rencontré une erreur lors de l'envoi, de la validation ou du traitement.
Erro
GET
/webhooks
Consulte l’historique des livraisons avec le statut, les tentatives, la réponse HTTP et la pagination. Requiert le scope webhooks:read.
Logs
Bonnes pratiques
Préparez votre point de terminaison pour recevoir des événements répétés et hors d'ordre.
Les webhooks sont des livraisons entre systèmes. Votre backend doit répondre rapidement, consigner les logs et traiter de manière idempotente.
Enregistrez une URL HTTPS publique et activez les événements dans le tableau de bord. Le contrat actuel n'envoie pas de signature HMAC ; configurez une protection et une validation appropriées pour le récepteur sans supposer l'existence d'une signature inexistante.
Répondez avec un HTTP 2xx dans les 15 secondes et traitez les tâches longues dans une file interne. Les redirections ne sont pas suivies.
Utilisez l’identifiant de l’événement, également envoyé dans Webhook-Id, pour éviter les traitements en double et accepter les événements hors ordre. Webhook-Attempt indique le numéro de tentative. Seuls les événements activés sont enregistrés et envoyés.
Consultez les tentatives et réponses HTTP sur GET /webhooks avec webhooks:read. Les enregistrements terminés, livrés ou en échec définitif sont conservés pendant 30 jours. Protégez les données personnelles et le contenu des messages dans vos propres logs.
Les échecs de connexion, timeouts et les réponses 408, 425, 429 ou 5xx peuvent entraîner jusqu'à sept tentatives au total, avec des intervalles de 1, 5 et 15 minutes, puis de 1, 6 et 24 heures. Retry-After est respecté jusqu'à 24 heures. Les autres erreurs 4xx interrompent la livraison.
Les webhooks de statut sont des retours de WPP Marketing. Pour envoyer des événements commerciaux de la boutique, utilisez l'Events API.
Vous voulez suivre les livraisons et les erreurs dans votre système ?
Configurez une URL dans le tableau de bord, choisissez les statuts et suivez les livraisons dans le rapport des webhooks.