#Prérequis

#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 Subscribe

Dans subscribe, nous utilisons beaucoup les webhooks pour vous transmettre toutes sortes de notifications d'événements (abonné mis à jour, abonnement créé, modifié, etc...).

#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

Vous devez ensuite aller sur votre dashboard Poool. Dans la partie "Paramètres" allez sur "Webhooks sécurisés".
D'ici, vous pouvez créer un nouvel endpoint qui recevra les events sélectionnés.
Choisissez donc tous les events auquel vous souhaitez vous abonner, mettez l'url du endpoint fraîchement créé dans le champ "URL du webhook" et cliquez sur "Créer".
Une fois cette étape terminé, vous verrez sur la liste des webhook votre nouvel endpoint créé, avec un champ secret.
Ce secret sert à confirmer l'origine de l'évènement comme venant directement de Poool.

#3. Configurez votre route

Dans un premier temps et pour éviter que quelqu'un d'autre que nous puisse utiliser votre endpoint, nous allons utiliser le secret récupéré précedemment afin de vérifier que nous sommes bien les auteurs de la requête.
Vous pouvez donc traiter les webhooks que vous recevez comme suit:

Lorsque nous vous envoyons un event, nous observons la réponse de votre serveur pour vérifier que la requête a bien été traitée correctement.
Il est donc important de retourner une réponse HTTP 200 OK si tout s'est bien passé.