Définition
Un webhook est une requête HTTP qu'une plateforme envoie à une URL que vous fournissez chaque fois qu'un événement se produit, par exemple un message délivré, lu ou en échec, ou l'arrivée d'une réponse client, afin que votre système en soit informé immédiatement sans avoir à interroger la plateforme (polling).
Vous enregistrez un point de terminaison (par exemple https://example.com/hooks/messaging). Lorsqu'un événement se produit, la plateforme envoie une requête POST avec un corps JSON qui le décrit : identifiant du message, statut, horodatage, canal et détails d'erreur. Votre serveur doit répondre rapidement avec un code 2xx et traiter l'événement de manière asynchrone.
Concevez pour les conditions réelles : les webhooks peuvent arriver en retard, dans le désordre ou plusieurs fois. Utilisez l'identifiant du message et le statut pour dédoublonner, ne faites jamais reculer un statut (par exemple de READ à DELIVERED) et gardez un traitement idempotent qui supporte les nouvelles tentatives.
Sécurité : n'acceptez que le HTTPS, vérifiez une signature ou un secret partagé sur chaque requête et ne vous fiez pas au contenu tant qu'il n'est pas vérifié. Des conventions du secteur comme la spécification Standard Webhooks décrivent les pratiques courantes de signature et de nouvelles tentatives.
Dans la messagerie, les webhooks alimentent les accusés de réception, les taux de lecture, les réponses entrantes, les désinscriptions et les décisions de basculement de canal.
OmniChannels.ai envoie des webhooks pour les statuts de livraison (SUBMITTED, SENT, DELIVERED, READ, FAILED, REJECTED), normalisés dans un format unique pour tous les canaux.
Exemple
{"messageId":"msg_123","channel":"whatsapp","status":"DELIVERED","timestamp":"2026-10-10T09:15:02Z"}