Nouveau guide : comment réchauffer une IP dédiée sans nuire à votre réputation. Lire maintenant →
MigoSMTP
Webhooks et événements

Sachez à l'instant où quelque chose se produit

Recevez des événements signés pour chaque livraison, rebond, ouverture, clic et plainte, et rejouez ce que vous avez manqué.

L'IA résume les flux d'événements et signale les schémas de rebonds inhabituels dès qu'ils apparaissent.

Ajouter un endpoint
URL
https://example.com/hook
Secret
••••••••••
Enregistrer
Endpoint ajouté
HTTPS uniquement
Vérifié
Ajoutez un endpoint HTTPSIndiquez-nous une URL capable de recevoir des requêtes POST. Nous vérifions qu'elle répond avant l'envoi de tout événement réel.
Événements souscrits
deliveredMessage accepté
bouncedDéfinitifs et temporaires
complainedSignalements de spam
clickedActivité des liens
Par événement
Par flux
Choisissez les événements voulusNe souscrivez qu'à ce sur quoi vous agissez : delivered, bounced, complained, opened ou clicked.
Événements de livraison
Événements signés
/hooks/mail
200 OK
Analytique
200 OK
Synchro CRM
200 OK
Temps réel
Plusieurs endpoints
Les événements se diffusent en temps réelChaque événement est envoyé à tous les endpoints abonnés, pour que l'analytique, le CRM et les alertes restent synchronisés.
Payload
{ "event": "delivered" }
En-tête de signature
sha256=9f2c41…
Secret partagé
Horodaté
Comparaison en temps constant
Rejetez tout ce qui échoue à la vérification
HMAC-SHA256
Protégé contre le rejeu
Vérifiez chaque requêteChaque requête porte une signature HMAC construite avec votre secret, pour que vous puissiez prouver qu'elle vient de nous.
Santé de l'endpoint · /hooks/mail
IA
il y a 1 h
Maintenant
Erreurs en hausseLa plupart des échecs sont des 502 depuis votre dernier déploiement.
Suggestion : mettre les événements en file, puis les rejouer quand /hooks/mail est rétabli
Regroupe les échecs
Pause ou rejeu
L'IA repère tôt un endpoint défaillantPlutôt que d'attendre l'épuisement des nouvelles tentatives, l'IA remarque la hausse du taux d'erreur de votre endpoint et regroupe les échecs par cause. Elle propose une correction et peut mettre en pause l'événement qui pose problème.
Gestionnaire de webhook
Node
Python
PHP
Go
PHP
app.post("/hook", (req, res) => {
verify(req, SECRET)
res.sendStatus(200)
})
200 OK
Accusez réception vite
Idempotent
Un gestionnaire en quelques lignesVérifiez la signature, accusez réception rapidement, traitez ensuite. C'est tout ce qu'il faut à un consommateur fiable.
Endpoint
Événements
Diffusion
Signature
Tri par IA
Gestionnaire
Relais SMTPAPI RESTWebhooksIP dédiéesSignature DKIMAnalyse des e-mails entrantsModèlesAnalytiqueListes de suppressionSupervision de la réputationValidation d'e-mailsRôles d'équipe et journal d'auditRelais SMTPAPI RESTWebhooksIP dédiéesSignature DKIMAnalyse des e-mails entrantsModèlesAnalytiqueListes de suppressionSupervision de la réputationValidation d'e-mailsRôles d'équipe et journal d'audit
Fonctionnalités

Livraison fiable des événements

Chaque issue

Delivered, deferred, bounced, opened, clicked, complained et unsubscribed.

Payloads signés

Vérifiez que chaque requête vient bien de MigoSMTP.

Nouvelles tentatives avec backoff

Les livraisons échouées sont relancées automatiquement.

Rejeu

Renvoyez les événements depuis le journal après une panne.

Filtres d'événements

Ne souscrivez qu'aux événements dont vous avez besoin.

Logs de livraison

Voyez la requête, la réponse et le statut de chaque tentative.

Fonctionnement

Un événement se produitUn message est livré, reporté, rebondit, est ouvert, cliqué ou signalé comme spam.
MigoSMTP signe et envoieL'événement est encapsulé dans un payload JSON signé et envoyé à votre endpoint HTTPS.
Votre endpoint vérifieVotre gestionnaire contrôle la signature, puis accuse réception avec une réponse 2xx.
Nouvelle tentative et rejeuLes livraisons échouées sont relancées, et vous pouvez rejouer les événements depuis le journal après une panne.
ÉTAPE 1

Ajoutez un endpoint

Saisissez votre URL HTTPS et choisissez les événements.

ÉTAPE 2

Vérifiez la signature

Contrôlez l'en-tête de signature de chaque requête.

ÉTAPE 3

Traitez et accusez réception

Renvoyez une réponse 2xx pour confirmer la réception.

Voir en action

Une plateforme, du premier envoi à la boîte de réception

Passez d'une étape à l'autre pour voir ce que vous contrôlez à chacune. Interface illustrative. Tous les chiffres et adresses affichés sont des données d'exemple.

app.migosmtp.com / sendDonnées d'exemple
En file
184,320
Envoyés aujourd'hui
6,418,905
Débit
412/s
acceptémessage à you@example.com
acceptémessage à team@example.com
en filelot de 25 000 destinataires
acceptémessage à ops@example.com
Exploitation

Gardez vos systèmes en phase avec vos e-mails

Mettez à jour votre base de données, déclenchez des workflows et alertez votre équipe sans polling.

  • Sélection des événements par endpoint
  • Nouvelles tentatives automatiques et rejeu manuel
  • Logs complets des requêtes et réponses
  • Secrets renouvelables
En un coup d'œil
TransportHTTPS POST
FormatJSON
SécuritéEn-tête de signature
Nouvelles tentativesAutomatique, avec backoff
Aperçu

Que sont les webhooks et événements ?

Les webhooks e-mail sont des rappels HTTP qui notifient votre application quand quelque chose arrive à un message envoyé. MigoSMTP envoie un payload JSON signé à votre endpoint HTTPS pour des événements comme delivered, deferred, bounced, opened, clicked, complained et unsubscribed. Votre système réagit immédiatement au lieu d'interroger sans cesse l'API sur l'état. Les payloads contiennent l'ID du message, le destinataire, le type d'événement, l'horodatage et, pour les échecs, la raison renvoyée par le serveur récepteur. Ces champs permettent de rapprocher les événements de vos propres données sans recherche supplémentaire ni conjecture.

Vous enregistrez un endpoint, choisissez les événements qu'il doit recevoir et vérifiez l'en-tête de signature de chaque requête. Renvoyez une réponse 2xx pour confirmer la réception. Si votre endpoint échoue, les livraisons sont relancées avec backoff, et vous pouvez rejouer les événements depuis le journal après une panne. Les détails de requête et de réponse de chaque tentative sont conservés pour déboguer rapidement. Les secrets peuvent être renouvelés, et les filtres d'événements gardent chaque endpoint ciblé. Les tentatives échouées affichent la requête, la réponse et l'heure, ce qui rend le débogage d'un gestionnaire rapide et fondé sur des preuves.

Les données d'événements permettent à un système d'envoi d'apprendre. Mettre à jour la suppression, suspendre une campagne lors d'un pic de plaintes ou alerter le support d'un reçu qui a rebondi dépend d'événements reçus à temps. Notre couche IA peut résumer les flux à fort volume et signaler les schémas inhabituels, pour que votre équipe repère un problème en quelques minutes plutôt qu'après la plainte d'un client. Le rejeu et les logs font qu'une lacune dans vos propres systèmes ne devient pas une lacune dans vos données.

Cas d'usage

Cas d'usage courants des webhooks et événements

Garder votre base de données synchronisée

Marquez les commandes comme notifiées à la livraison et signalez les contacts lors d'un rebond définitif. Les webhooks suppriment les tâches de polling et gardent l'état de l'application exact.

Gestion automatique de la suppression

Sur un événement de rebond ou de plainte, ajoutez aussitôt l'adresse à votre propre table de non-envoi, pour que les autres systèmes qui écrivent à la même personne s'arrêtent aussi.

Alerter les équipes de support

Envoyez une alerte Slack ou un ticket quand une réinitialisation de mot de passe rebondit. Le support peut alors joindre le client par un autre canal avant qu'il n'abandonne. Cela économise des heures de travail manuel.

Récupérer après une interruption

Si votre endpoint était hors ligne pendant un déploiement, rejouez les événements manqués depuis le journal et remettez vos données dans le bon état. Rien n'est perdu entre-temps.

Mettre à jour le statut des commandes et tickets

Marquez une commande comme notifiée ou un ticket comme répondu dès l'arrivée de l'événement de livraison.

Alimenter votre entrepôt de données

Diffusez les événements vers votre propre analytique pour que les résultats e-mail côtoient les données produit et de revenus.

Choisir une méthode

Webhooks ou polling de l'API ?

Les deux fournissent des données d'événements. Ils conviennent à des situations différentes.

WebhooksPolling de l'API
FonctionnementNous poussons les événements vers votre endpointVotre code interroge selon un calendrier
RapiditéQuasi temps réelDépend de votre intervalle de polling
ChargeUniquement quand quelque chose se produitRequêtes constantes, le plus souvent vides
FiabilitéNouvelles tentatives et rejeu couvrent les pannesVous devez suivre ce que vous avez déjà lu
Idéal pourStatut en direct et automatisationRattrapage et rapports planifiés

Beaucoup d'équipes utilisent les webhooks pour les mises à jour en direct et l'API pour rattraper ce qu'elles ont manqué.

Fonctions IA

Webhooks et événements assistés par IA

Copilote

Résumés des flux d'événements

Un copilote condense des milliers d'événements en un court digest, par exemple quel fournisseur reporte et quelle campagne génère des plaintes, avec des liens vers les messages derrière chaque point.

Prédictif

Détection d'anomalies sur les événements

Des modèles apprennent les taux normaux de rebonds, de plaintes et de reports, et vous alertent quand un flux s'en écarte. Vous choisissez qui est notifié et si une automatisation s'exécute.

Assistance

Assistant de débogage des payloads

Collez un log de livraison échouée : l'assistant explique la cause probable, comme une signature non conforme ou un délai dépassé, et suggère une correction à tester. C'est vous qui faites la modification.

Prêt pour les agents

Accès aux événements prêt pour les agents

Via un serveur MCP, les agents IA peuvent lire l'historique des événements et les logs de livraison avec des portées en lecture seule. Les actions d'écriture exigent des portées explicites et, si vous le souhaitez, une approbation humaine.

Les fonctions IA sont une aide : elles résument et alertent, et toute action automatisée est configurée et approuvée par votre équipe.

Bonnes pratiques

Bonnes pratiques pour les webhooks et événements

Vérifiez la signature à chaque fois

Rejetez les requêtes dont l'en-tête de signature ne correspond pas. Renouvelez le secret périodiquement, et immédiatement s'il a pu être exposé.

Répondez vite, travaillez en asynchrone

Accusez réception avec un 2xx dès que le payload est stocké en sécurité, puis traitez-le depuis une file. Les gestionnaires lents causent des délais dépassés et des nouvelles tentatives en double.

Prévoyez doublons et désordre

Les livraisons peuvent se répéter et arriver dans le désordre. Utilisez l'ID du message et l'horodatage pour dédupliquer et ignorer les changements d'état périmés.

Ne souscrivez qu'à ce que vous utilisez

Filtrez les événements par endpoint. Moins de requêtes inutiles signifie moins de charge sur vos serveurs et une supervision plus simple. Gardez des intégrations légères et faciles à déboguer.

Surveillez votre propre endpoint

Alertez en cas d'échecs répétés dans le log de livraison. Une panne silencieuse signifie une dérive silencieuse des données jusqu'à ce que quelqu'un rejoue la période manquante.

Accusez réception vite, traitez ensuite

Renvoyez vite une réponse 2xx et déportez le travail lourd vers une file, pour que les gestionnaires lents ne déclenchent pas de nouvelles tentatives.

FAQ

Webhooks et événements : questions fréquentes

Besoin d'aide pour câbler un endpoint ? Notre équipe peut l'examiner avec vous avant le lancement.

Qu'est-ce qu'un webhook e-mail ?

Un webhook e-mail est une requête HTTP que votre fournisseur d'e-mail envoie à votre serveur quand un événement se produit, comme la livraison ou le rebond d'un message. Il permet à votre application de réagir en temps réel sans interroger l'API en continu. Il remplace les tâches de polling et maintient vos données à jour.

Comment vérifier la signature d'un webhook ?

Chaque requête inclut un en-tête de signature généré avec le secret de votre endpoint. Recalculez la signature à partir du corps brut de la requête de votre côté et comparez. Rejetez la requête si elles diffèrent. La documentation contient des exemples de code.

Quels événements puis-je recevoir ?

Delivered, deferred, bounced, opened, clicked, complained et unsubscribed. Vous pouvez abonner chaque endpoint à un sous-ensemble, pour qu'un service reçoive les rebonds et un autre les événements d'engagement. Ne choisissez que ceux sur lesquels vos systèmes agissent, comme les rebonds pour la suppression et les clics pour l'analytique, afin de garder un trafic réduit et pertinent vers votre endpoint.

Que se passe-t-il si mon endpoint est indisponible ?

Les livraisons échouées sont relancées avec backoff, et vous pouvez rejouer les événements depuis le journal une fois rétabli. Chaque tentative, avec sa requête et sa réponse, est enregistrée pour que vous voyiez ce qui a échoué. Vérifiez que votre gestionnaire répond vite et consigne les échecs.

Les événements webhook sont-ils livrés dans l'ordre ?

Ne comptez pas sur un ordre strict. Concevez des gestionnaires qui tolèrent doublons et événements désordonnés grâce à l'ID du message et à l'horodatage. L'ordre des événements peut différer selon les fournisseurs et les nouvelles tentatives, et un même message peut générer plusieurs événements.

Que sont les ouvertures par des robots ?

Certains systèmes de messagerie récupèrent automatiquement les images, ce qui est enregistré comme une ouverture même si personne n'a lu le message. Nous les séparons des ouvertures humaines quand nous le pouvons, mais le suivi des ouvertures reste une estimation. Considérez les ouvertures comme un indicateur approximatif. Comptez les clics et les réponses comme des signaux d'engagement plus solides.

Comment tester un endpoint webhook ?

Envoyez un événement d'exemple depuis le tableau de bord vers votre URL et vérifiez que votre gestionnaire contrôle la signature et renvoie un 2xx. Consultez le log de livraison pour voir la requête et votre réponse. Utilisez un endpoint de préproduction avec un secret de test avant la production. Faites-le avant de pointer la production vers l'endpoint.

Comment l'IA s'intègre-t-elle aux webhooks et événements ?

L'IA peut résumer les flux d'événements, signaler les schémas inhabituels de rebonds ou de plaintes et aider à déboguer les livraisons échouées. Elle recommande des actions mais ne modifie pas votre configuration sauf si vous définissez une règle. Examinez les logs récents avant de connecter de nouveaux endpoints.

Comment tester un endpoint ?

Envoyez un événement d'exemple depuis le tableau de bord.

L'ordre est-il garanti ?

Concevez des gestionnaires qui tolèrent doublons et événements désordonnés, en utilisant l'ID du message et l'horodatage pour dédupliquer.

Commencez à envoyer en quelques minutes.

Créez un compte, ajoutez votre domaine et envoyez votre premier e-mail.