Webhook
Tous les termes email que vous devez maîtriser pour le marketing par email et la délivrabilité, expliqués clairement et simplement.
Email technique
Définition
Un webhook est un callback HTTP qui délivre des données en temps réel à votre application lorsque des événements spécifiques se produisent dans un autre système. Contrairement aux API traditionnelles où vous interrogez pour obtenir des mises à jour, les webhooks poussent les données vers votre endpoint immédiatement lorsqu'ils sont déclenchés, permettant des notifications instantanées pour les événements email comme les livraisons, rebonds, ouvertures et clics.
Cas d'utilisation courants
Notifications de rebond : Supprimez instantanément les rebonds définitifs de votre liste pour protéger la réputation de l'expéditeur
Suivi des ouvertures et clics : Déclenchez le scoring d'engagement en temps réel et les alertes commerciales
Traitement des désabonnements : Mettez automatiquement à jour le statut d'abonné à travers tous les systèmes
Gestion des plaintes spam : Supprimez immédiatement les plaignants pour éviter les dommages de délivrabilité
Confirmation de livraison : Vérifiez le placement en boîte de réception réussi pour les emails transactionnels
Résultats de validation email : Recevez les résultats de vérification async pour les gros jobs batch
Automatisation de l'hygiène de liste : Signalez les adresses qui rebondissent temporairement de façon répétée pour examen
Déclencheurs d'automatisation marketing : Lancez des séquences de nurturing basées sur des interactions email spécifiques
Pourquoi les webhooks sont importants
Les webhooks transforment la façon dont vous interagissez avec les données email en éliminant le besoin d'interrogation constante. Au lieu d'interroger répétitivement une API pour vérifier les nouveaux événements (ce qui gaspille des ressources et introduit des délais), les webhooks délivrent l'information à l'instant où elle devient disponible. Cette capacité temps réel est essentielle pour les opérations sensibles au temps comme supprimer les adresses rebondies avant votre prochaine campagne ou déclencher des séquences de suivi basées sur l'engagement des destinataires. Pour les marketeurs par email et les développeurs, les webhooks permettent une automatisation sophistiquée qui était auparavant impossible. Lorsque quelqu'un clique sur un lien dans votre email, un webhook peut instantanément mettre à jour votre CRM, déclencher une notification commerciale, ou inscrire le contact dans une séquence de nurturing ciblée. Cette réponse immédiate au comportement utilisateur améliore dramatiquement les taux d'engagement et de conversion. Les webhooks réduisent également les coûts d'infrastructure et la complexité. Les approches basées sur l'interrogation nécessitent des ressources dédiées pour vérifier continuellement les mises à jour, même quand rien n'a changé. Avec les webhooks, vous ne traitez les données que lorsque des événements se produisent réellement, rendant votre système plus efficace et scalable. Cette architecture pilotée par événements est désormais une pratique standard pour l'infrastructure email moderne.
Comment fonctionnent les webhooks
Les webhooks opèrent sur un mécanisme simple mais puissant : lorsqu'un événement prédéfini se produit, le système source envoie une requête HTTP POST à une URL que vous spécifiez. Cette URL, appelée endpoint webhook, reçoit une payload JSON contenant des informations détaillées sur l'événement. Pour les systèmes email, cela signifie que votre application est notifiée au moment où un email rebondit, est ouvert, ou déclenche tout autre événement suivi. Le processus commence lorsque vous enregistrez votre URL d'endpoint auprès du fournisseur de services email et sélectionnez quels événements vous souhaitez recevoir. Lorsqu'un abonné ouvre votre email, par exemple, l'ESP détecte cette action et construit immédiatement une payload contenant le type d'événement, l'horodatage, l'email du destinataire et d'autres métadonnées pertinentes. Cette payload est ensuite envoyée à votre endpoint via une requête HTTPS POST. Votre serveur doit accuser réception en retournant un code de statut HTTP 200. Si le webhook échoue à être délivré (en raison d'une indisponibilité du serveur ou de problèmes réseau), la plupart des fournisseurs implémentent une logique de retry avec backoff exponentiel. Cela assure que vous recevez finalement toutes les données d'événements même si des défaillances temporaires surviennent. L'ensemble du processus se complète généralement en millisecondes, vous donnant une visibilité quasi-instantanée sur vos performances email.
Bonnes pratiques
Validez les signatures webhook pour assurer que les requêtes proviennent de votre ESP, pas d'attaquants
Répondez avec HTTP 200 immédiatement, puis traitez la payload de manière asynchrone
Implémentez l'idempotence pour gérer gracieusement les livraisons dupliquées sans corruption de données
Utilisez une file de messages pour tamponner les webhooks entrants pendant les pics de trafic
Loguez toutes les payloads entrantes pour le débogage et l'audit avant le traitement
Configurez la surveillance et les alertes pour la disponibilité et les taux d'erreur de l'endpoint webhook
Gérez les retries gracieusement en vérifiant et ignorant les IDs d'événements dupliqués
Utilisez exclusivement des endpoints HTTPS et faites tourner les secrets webhook périodiquement
Questions fréquentes
Quelle est la différence entre webhooks et APIs ?
Les APIs nécessitent que vous demandiez activement des données (modèle pull), tandis que les webhooks envoient automatiquement des données quand des événements se produisent (modèle push). Avec une API, vous interrogez le serveur périodiquement en demandant « de nouveaux événements ? » Avec les webhooks, le serveur vous dit immédiatement quand quelque chose se produit. Les webhooks sont plus efficaces pour les notifications temps réel, tandis que les APIs sont meilleures pour la récupération de données à la demande.
Comment sécuriser mon endpoint webhook ?
Implémentez plusieurs couches de sécurité : utilisez exclusivement HTTPS, validez les signatures webhook en utilisant la clé secrète fournie par votre ESP, vérifiez les adresses IP source si votre fournisseur les publie, et implémentez la limitation de débit pour prévenir les abus. La plupart des services email incluent un en-tête de signature (comme X-Webhook-Signature) que vous devriez vérifier contre votre secret avant de traiter toute payload.
Que se passe-t-il si mon endpoint webhook est indisponible ?
La plupart des fournisseurs de services email implémentent une logique de retry automatique avec backoff exponentiel. Si votre endpoint retourne une erreur ou timeout, le fournisseur réessaiera la livraison plusieurs fois sur plusieurs heures ou jours. Cependant, après avoir épuisé les retries, les événements peuvent être perdus. Pour prévenir la perte de données, assurez une haute disponibilité pour votre endpoint et envisagez d'utiliser un service webhook géré ou une file de messages comme tampon.
Quelle rapidité de réponse mon endpoint doit-il avoir aux webhooks ?
Votre endpoint devrait retourner une réponse HTTP 200 dans les 5-10 secondes pour prévenir les erreurs de timeout. La meilleure pratique est d'accuser réception immédiatement, puis de traiter la payload de manière asynchrone en utilisant une file de jobs en background. Cela empêche le traitement lent de causer des échecs webhook et permet à votre système de gérer des volumes élevés d'événements concurrents sans goulots d'étranglement.
Termes associés
Articles associés
Prêt à vérifier vos emails ?
Commencez à utiliser BillionVerify dès aujourd'hui. Vérifiez les emails avec 99,9% de précision.
Aucune carte de crédit requise · 100+ vérifications gratuites par jour · Configuration en 5 minutes