#Introduction

#Qu'est ce qu'un webhook ?

Un webhook permet de déclencher une action suite à un événement.
Ils sont en règle générale utilisés pour faire communiquer des systèmes ou applications de manière automatique (ex: notifications, alertes, gestion des erreurs etc...).

#Webhooks et Poool

Poool vous permet de récupérer des données et d'afficher des messages d'erreur personnalisés sur les widgets newsletter et formulaire.

#Utiliser les webhooks

#1. Définir une route

Commencez par créer une route POST pour le webhook sur votre application serveur (e.g. https://example.com/webhooks).

#2. Activer le service dans le dashboard Poool

Dans votre dashboard, accédez aux réglages de votre application, via les sous-menus du produit Access.
Activez le service Webhooks dans la partie "Connecteurs solutions tierces".
Il est ainsi possible de définir deux webhooks différents, pour les inscriptions newsletter et pour l'envoi du contenu des formulaires.
Renseignez l'url de votre route dans le/les champ(s) prévu(s) à cet effet et enregistrez vos modifications.

#3. Configurez votre route

Il est nécessaire de configurer le body de la réponse de votre webhook afin de pouvoir personnaliser les messages renvoyés au paywall.
La réponse doit respecter les conditions suivantes :
  • status : 2xx. Les codes de statut en dehors de la plage 2xx ne seront pas traités.
  • content-type : application/json.
  • body : Le body de la réponse. Voir la description des différents webhooks disponibles.
⚠️ Tant que vous renvoyez un statut 200 avec un payload contenant des erreurs, l'utilisateur ne pourra pas débloquer le contenu.