Webhooks
Des callbacks HTTP vers votre serveur quand le statut d'un envoi change : pas de polling, des données en temps réel.
Points clés
- Vérifiez toujours la signature HMAC des requêtes entrantes : elle garantit que le payload provient vraiment de NotifyHub.
- Répondez 2xx rapidement et traitez le payload de manière asynchrone : les réponses lentes sont retentées.
- Utilisez le journal des livraisons webhook pour le débogage : il montre le payload, la réponse de votre serveur et les nouvelles tentatives.
À quoi sert cette page
Les Webhooks avertissent votre système quand quelque chose se produit dans NotifyHub, typiquement les changements de statut des envois (livré, échoué...). Vous enregistrez l'URL de votre serveur et les événements qui vous intéressent : à chaque événement, NotifyHub envoie une requête HTTP signée avec le payload complet.
Comment l'utiliser
Le tableau liste les endpoints avec URL, événements souscrits, statut et dernier déclenchement. Vous pouvez activer/désactiver un endpoint avec le toggle (utile pendant la maintenance de votre serveur) ou le supprimer. Les requêtes sont signées HMAC : le secret pour la vérification vous est fourni à la création de l'endpoint.
Livraisons et nouvelles tentatives
Chaque appel à votre endpoint est tracé dans la page des livraisons webhook, avec le payload envoyé, le code de réponse et le nombre de tentatives : en cas d'erreur de votre serveur, NotifyHub retente automatiquement, et vous pouvez aussi relancer manuellement une livraison échouée. Si votre endpoint reste indisponible longtemps, consultez le journal pour récupérer les événements perdus.