Tout ce qui mérite d'être su, rien qui ne le mérite pas.
Quels événements propose-t-il ?
Les deux plus courants sont les accusés de réception (DLR), qui indiquent si chaque message a bien été reçu et pourquoi il n'a pas été distribué, et les messages entrants, qui permettent de configurer des flux bidirectionnels et de gérer les messages STOP. Voir /answers/what-is-dlr et /answers/what-is-mo-vs-mt.
Pourquoi la pression bat les sondages
Interroger régulièrement une API pour connaître son statut engendre un gaspillage de requêtes et une latence accrue ; un webhook transmet l’événement dès qu’il se produit, permettant ainsi à vos tentatives de rappel d’OTP, au routage de votre assistance et à vos outils d’analyse de réagir en temps réel. Voir /developers/webhooks.
Vérifiez et sécurisez-le
Comme n'importe qui peut envoyer une requête POST à une URL publique, signer les charges utiles des webhooks (par exemple avec HMAC-SHA256) et vérifier la signature avant de faire confiance à un événement, et toujours servir le point de terminaison via HTTPS. Voir /answers/hmac-sha256-dlr-signing et /tools/webhook-signature-validator.
Rendez-le résilient
Renvoie un code 2xx rapide et traite les requêtes de manière asynchrone, en tenant compte des nouvelles tentatives et des doublons occasionnels (gérez donc les événements de manière idempotente), et surveille les échecs afin de ne jamais manquer une requête. Voir /developers/webhooks.