Introduction

Les webhooks vous permettent d'être notifié (via une requête HTTP POST) lorsqu'un événement spécifique se produit sur l'un des emails que vous avez envoyés. Vous pouvez configurer l'URL de votre endpoint webhook dans le tableau de bord de Mailflot, section Webhooks.

Événements supportés

Actuellement, Mailflot supporte l'événement suivant :

• email.bounced : Déclenché lorsqu'un email rebondit (Hard Bounce ou Soft Bounce). Indique que l'email n'a pas pu être livré au destinataire.

Structure du Payload

Lorsqu'un événement se produit, Mailflot envoie une requête POST à votre URL configurée avec le payload JSON suivant :

{
  "event": "email.bounced",
  "email_id": 42,
  "recipient": "adresse_inexistante@example.com",
  "bounce_type": "Hard Bounce",
  "diagnostic_code": "550 5.1.1 The email account that you tried to reach does not exist.",
  "timestamp": "2023-10-24T10:30:00Z"
}

Bonnes pratiques

• Code de retour HTTP : Votre serveur doit retourner un code HTTP 200 OK ou 201 Created pour confirmer la réception du webhook.
• Délai d'attente (Timeout) : Mailflot attend une réponse dans un délai de 5 secondes. Assurez-vous de traiter le payload de manière asynchrone si votre logique de traitement est lente (par exemple, mettez-le en file d'attente).
• Nouvelles tentatives (Retries) : Si votre serveur ne répond pas ou retourne un code d'erreur (500, 502, etc.), Mailflot ne tentera pas de renvoyer le webhook dans sa version actuelle.