Webhooks

Les webhooks vous permettent de recevoir des notifications HTTP en temps réel lorsque des événements se produisent dans votre compte Emailit, par exemple quand un e-mail est livré, rejeté, ou quand un contact est créé.

Au lieu d’interroger l’API pour détecter les changements, les webhooks transmettent les données vers votre serveur au moment où les événements se produisent, vous permettant de créer des intégrations et des flux de travail réactifs.

Fonctionnement

1. Vous créez un point de terminaison webhook dans votre application qui accepte les requêtes POST
2. Vous enregistrez l’URL dans le tableau de bord Emailit ou via l’API
3. Lorsqu’un événement auquel vous êtes abonné se produit, Emailit envoie une requête POST à votre URL avec la charge utile de l’événement
4. Votre point de terminaison répond avec un code de statut 2xx pour confirmer la réception

Structure des événements

Chaque événement webhook suit une structure cohérente :

{
  "event_id": "evt_2bH7kNwP5mQaV1sXgIdKe6pZr",
  "type": "email.delivered",
  "data": {
    "object": {
      ...
    }
  }
}

Événements disponibles

Emailit envoie des notifications webhook pour les types de ressources suivants :

• E-mails — événements du cycle de vie de livraison (accepté, livré, rejeté, etc.)
• Domaines — création, mise à jour et suppression de domaines
• Audiences — événements de gestion d’audiences
• Abonnés — événements du cycle de vie des abonnés
• Contacts — événements de gestion des contacts
• Modèles — création, mise à jour et suppression de modèles
• Suppressions — modifications de la liste de suppression
• Vérifications d’e-mails — résultats de vérification
• Listes de vérification d’e-mails — événements de listes de vérification en lot

Consultez Types d’événements pour la liste complète.

Étapes suivantes

• Types d’événements — Liste complète de tous les types d’événements disponibles
• Requêtes webhook — Structure des requêtes HTTP webhook
• Signature de requête — Vérifier l’authenticité des webhooks à l’aide de signatures