Depuis l'application
- Ouvrez Paramètres → Webhooks et cliquez sur Créer un webhook.
- Indiquez l'URL de notification : une adresse
https://accessible depuis Internet (les adresses locales ou privées sont refusées). Elle doit répondre en moins de 10 secondes. - Cochez les événements à recevoir (liste complète) et validez.
Le secret de signature n'est affiché qu'une seule fois. Copiez-le immédiatement dans un gestionnaire de mots de passe : il sert à vérifier que les appels viennent bien de Mailpro. Perdu ? Utilisez « Renouveler le secret ».
Le webhook est actif environ 10 minutes après sa création, le temps que nos serveurs se synchronisent.
Tester
Dans la liste, menu Plus d'actions → Envoyer un ping de test : choisissez un type d'événement, un exemple de données est envoyé immédiatement à votre URL. Voir l'historique des livraisons affiche chaque tentative (date, statut HTTP, latence, numéro de tentative) et permet de réessayer une livraison.
Depuis l'API
Les mêmes opérations existent pour vos intégrations : POST /api/v3/Webhook (création, renvoie le secret une seule fois), POST /api/v3/Webhook/{id}/test, GET /api/v3/Webhook/{id}/deliveries, POST /api/v3/Webhook/{id}/rotate-secret, DELETE /api/v3/Webhook/{id}. Détails et exemples dans le portail développeurs.
Limites
- 20 webhooks par compte, 50 événements par webhook.
- Un webhook désactivé (manuellement ou après 10 échecs consécutifs) se réactive d'un clic : que se passe-t-il en cas d'échec ?
- La suppression efface aussi l'historique des livraisons, définitivement.