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.
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.
Utilisez une URL sécurisée, publique et stable pour recevoir les événements de retour.
Répondez avec HTTP 200 ou 204 après avoir reçu l’évènement et traitez les tâches longues dans une file interne.
Utilisez des identifiants de message et d'événement pour éviter les doublons lors des renvois.
Enregistrer le payload, la date, le statut HTTP et le résultat du traitement pour audit.
Utilisez MESSAGE_ERROR pour alerter le support ou l'équipe opérationnelle des erreurs renvoyées par toute connexion.
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.