Les webhooks dans SendPulse permettent de recevoir des notifications en temps rĂ©el sur des Ă©vĂ©nements liĂ©s aux emails, facilitant ainsi la synchronisation avec d’autres systèmes. Pour crĂ©er un webhook, accĂ©dez aux paramètres du compte dans l’onglet API et cliquez sur CrĂ©er un webhook. Il suffit de spĂ©cifier l’URL de votre gestionnaire et de sĂ©lectionner les Ă©vĂ©nements d’intĂ©rĂŞt. Parmi les Ă©vĂ©nements disponibles, on trouve la livraison, l’ouverture, le clic sur un lien, le signalement comme spam ou la dĂ©sinscription. Lorsqu’un Ă©vĂ©nement se produit, un POST est envoyĂ© Ă votre URL avec des donnĂ©es au format JSON, vous permettant ainsi de traiter les informations rapidement et efficacement.
Les webhooks dans SendPulse constituent un outil puissant pour synchroniser les emails avec d’autres systèmes. Grâce Ă ces mĂ©canismes, vous pouvez recevoir des notifications automatisĂ©es sur divers Ă©vĂ©nements liĂ©s Ă l’activitĂ© des abonnĂ©s et la livraison des emails. Ce tutoriel vous guidera Ă travers le processus de crĂ©ation et d’exploitation des webhooks pour amĂ©liorer votre gestion des emails et automatiser certaines tâches.
Qu’est-ce qu’un webhook ?
Un webhook est une méthode permettant de recevoir des notifications concernant certains événements. Dans le contexte de SendPulse, vous pouvez configurer des notifications relatives à la livraison des emails et aux interactions des abonnés, telles que l’ouverture d’emails ou les désabonnements. Cela vous permet de réagir rapidement aux actions de vos utilisateurs et d’optimiser vos campagnes.
Comment créer un webhook dans SendPulse
Pour établir une connexion avec les webhooks SMTP, rendez-vous dans la section Paramètres du compte sous l’onglet API et cliquez sur Créer un webhook. Il vous faudra spécifier l’URL de votre gestionnaire où vous souhaitez recevoir les événements et indiquer quels événements vous aimeriez recevoir.
Événements pouvant déclencher un webhook
Les Ă©vĂ©nements suivants dĂ©clenchent l’envoi des webhooks dans le service SMTP :
- LivrĂ© : L’email a Ă©tĂ© remis avec succès Ă son destinataire.
- Non livrĂ© : L’email n’a pas pu ĂŞtre remis Ă son destinataire.
- Ouvert : Le destinataire a ouvert l’email.
- Clic sur un lien : Le destinataire a cliquĂ© sur un lien contenu dans l’email.
- MarquĂ© comme spam : Le destinataire a signalĂ© l’email comme spam.
- DĂ©sabonnement : Le destinataire s’est dĂ©sabonnĂ© des futurs emails.
- Réabonnement : Le destinataire, auparavant désabonné, a confirmé son abonnement.
- Erreur de hard bounce : L’email ne peut ĂŞtre livrĂ© en raison d’une erreur permanente.
- Erreur de soft bounce : L’email ne peut pas ĂŞtre livrĂ© en raison d’une erreur temporaire.
Format des données envoyées par le webhook
Le webhook est dĂ©clenchĂ© toutes les 30 secondes ou lorsque SendPulse a collectĂ© 500 Ă©vĂ©nements Ă envoyer. Lorsqu’il est dĂ©clenchĂ©, SendPulse envoie une requĂŞte POST en format JSON Ă l’URL spĂ©cifiĂ©e. Les donnĂ©es sont envoyĂ©es dans un format structurĂ©, comprenant des dĂ©tails tels que l’Ă©vĂ©nement, l’horodatage, l’identifiant du message, le destinataire, l’expĂ©diteur et le sujet de l’email.
Exemple d’intégration avec PHP
Pour accepter les demandes de webhook dans un script PHP, vous pouvez utiliser le code suivant :
Ce code permet de recevoir et d’analyser les donnĂ©es JSON envoyĂ©es par le webhook, vous offrant ainsi la possibilitĂ© de les utiliser dans votre application.
Pour plus d’informations sur les webhooks dans SendPulse, consultez la documentation : Webhooks SMTP SendPulse.
Comparaison des fonctionnalités des webhooks dans SendPulse
| Fonctionnalité | Description |
|---|---|
| Configuration | AccĂ©dez aux paramètres de compte pour crĂ©er un webhook et spĂ©cifiez l’URL de votre gestionnaire. |
| Types d’Ă©vĂ©nements | DĂ©clencheur de notifications pour les Ă©vĂ©nements tels que livraison, ouverture et dĂ©sinscription. |
| Format de donnĂ©es | RequĂŞtes envoyĂ©es sous format JSON contenant des informations sur l’Ă©vĂ©nement. |
| FrĂ©quence d’envoi | Notifications envoyĂ©es toutes les 30 secondes ou après l’accumulation de 500 Ă©vĂ©nements. |
| Gestion des erreurs | Informez-vous sur les erreurs de rĂ©ception d’emails, comme les bounces durs ou doux. |
| Exemples de webhook | Inclut les événements comme ouvertures et clics sur des liens pour un suivi précis. |


