Webhook

Un webhook est un callback HTTP automatique qui notifie votre système en temps réel lorsqu'un événement se produit – comme la réception, la livraison ou la lecture d'un message. Au lieu de consulter l'API en permanence (polling), votre système est notifié proactivement par le serveur (push).

Qu'est-ce qu'un webhook ?

Un webhook est un mécanisme de communication entre applications web basé sur le principe du « push » : au lieu que votre application demande régulièrement à un serveur si quelque chose s'est passé (polling), le serveur envoie automatiquement une notification HTTP à votre application dès qu'un événement se produit.

Consultez notre guide de configuration des webhooks pour une mise en place pas à pas. Dans le contexte de la messagerie d'entreprise, les webhooks sont essentiels pour réagir en temps réel aux événements : message reçu d'un client, accusé de réception, lecture confirmée, changement de statut d'un bot, etc.

Comment fonctionnent les webhooks ?

Le principe est simple :

• Configuration – Vous enregistrez une URL de webhook (votre endpoint) auprès de la plateforme (ex: SendSeven)
• Événement – Un événement se produit (nouveau message reçu, message livré, etc.)
• Notification – La plateforme envoie immédiatement une requête HTTP POST à votre URL avec les données de l'événement en JSON
• Traitement – Votre système reçoit la notification et déclenche la logique correspondante
• Confirmation – Votre endpoint renvoie un code HTTP 200 pour confirmer la réception

Webhooks vs Polling

• Polling – Votre système interroge l'API toutes les X secondes. Simple à implémenter, mais inefficace (requêtes inutiles si pas de nouveaux événements), latence élevée, coûteux en ressources.
• Webhook – Notification instantanée à chaque événement. Efficace, faible latence, économe en ressources. Nécessite un endpoint accessible publiquement et une gestion des erreurs robuste.

Cas d'usage typiques

• Mettre à jour le statut d'une commande CRM quand le client confirme par WhatsApp
• Déclencher un ticket de support quand un message entrant est détecté
• Notifier l'équipe commerciale quand un lead répond à une campagne
• Synchroniser les données de conversation dans un data warehouse pour analytics
• Déclencher des workflows Zapier ou Make suite à des événements de messagerie, comme pour l'automatisation par chatbot

Sécurité des webhooks

Pour sécuriser votre endpoint webhook, implémentez : la validation de signature HMAC (SendSeven signe chaque requête), la liste blanche des IPs sources, HTTPS obligatoire, et un mécanisme de retry idempotent pour gérer les livraisons dupliquées.

Webhooks SendSeven

SendSeven fournit des webhooks pour tous les événements de messagerie : messages entrants, statuts de livraison, changements d'état des bots, événements de campagne. Documentation complète, exemples de code en Python, Node.js et PHP, et un testeur de webhook intégré dans le tableau de bord. Consultez aussi notre guide complet de l'API WhatsApp Business et toutes les fonctionnalités de la plateforme.