#Prérequis

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...).

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

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

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.

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é.