# Quand un webhook est reçu

Le trigger **Quand un Webhook est reçu** permet de déclencher une automation à la réception d'un Webhook.\
Pour définir le schéma du Webhook, vous avez deux options :

* [Paramétrer le Webhook directement depuis Ksaar](#parametrer-le-webhook-directement-depuis-ksaar) : vous pouvez définir manuellement le schéma du webhook que vous souhaitez utiliser en entrant les informations requises.
* [Paramétrer le Webhook depuis un autre outil](#parametrer-le-webhook-depuis-un-autre-outil) : si vous choisissez cette option, vous devez envoyer un Webhook d'exemple à l'URL du webhook. Une fois envoyé, vous pouvez tester le Webhook et si la requête est reçue avec succès, vous pouvez utiliser le schéma du Webhook d'exemple.

Une fois que le schéma du Webhook est défini, vous pouvez attribuer un nom à votre Webhook (ce nom facilite la sélection des variables à utiliser dans vos actions) et mettre à jour le schéma du Webhook en cliquant sur **Déterminer à nouveau la structure de la donnée**.

Vous pouvez utiliser le schéma du Webhook dans les actions de votre automation pour traiter les données reçues via le Webhook.

### Paramétrer le Webhook directement depuis Ksaar

Vous pouvez définir manuellement le schéma du webhook que vous souhaitez utiliser en cliquant sur paramétrer le webhook depuis Ksaar :

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FRo4G1ubRYdqg5GSOP1KB%2Fimage.png?alt=media&#x26;token=45a61b0c-cef5-4342-8edd-8e425bf324c2" alt="" width="563"><figcaption><p>Paramétrer le Webhook depuis Ksaar</p></figcaption></figure>

Puis, déterminez manuellement le schéma de votre webhook.&#x20;

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FpjJ2iMQFpd0VtonuztJw%2FCapture%20d%E2%80%99e%CC%81cran%202023-06-20%20a%CC%80%2010.27.43.png?alt=media&#x26;token=6e47b32b-586c-4531-a4b8-43e9dec00d71" alt="" width="563"><figcaption><p>Exemple de schéma</p></figcaption></figure>

Une fois le schéma du webhook établi, vous pouvez utiliser les variables de votre webhook dans les actions de votre automations.

### Paramétrer le Webhook depuis un autre outil

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FiJd3aTCJtON1TL1U5yvM%2Fimage.png?alt=media&#x26;token=1872dafb-2c47-417b-bec3-29fe5eebec5a" alt="" width="563"><figcaption><p>Paramétrer le webhook depuis un autre outil</p></figcaption></figure>

Si vous choisissez cette option, vous devez envoyer un Webhook d'exemple à l'URL unique qui vous a été créé.&#x20;

Par exemple, vous pouvez collez l'URL de votre webhook dans votre navigateur, y ajouter \
"?Entreprise=Ksaar" à la fin de l'URL et appuyer sur entrée.

Si la requête est bien reçue, votre navigateur affichera {"received": true}.&#x20;

Sur Ksaar, vous pourrez ensuite cliquer sur le bouton "Tester le Webhook" pour afficher le schéma reçu.

<figure><img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2Fa5rodGAzio7drFuShFY2%2FCapture%20d%E2%80%99e%CC%81cran%202023-06-22%20a%CC%80%2009.24.22.png?alt=media&#x26;token=f49dc799-ce3b-4f31-a4c7-9467e40f8503" alt="" width="563"><figcaption><p>Exemple de requête d'exemple </p></figcaption></figure>

Ce schéma peut ensuite être utilisé en cliquant sur "Utiliser ce schéma". Une fois le schéma du webhook établi, vous pouvez utiliser les variables de votre webhook dans les actions de votre automations.

<details>

<summary>Envoyer un webhook d'exemple avec Reqbin</summary>

1️⃣ Allez sur <https://reqbin.com/>.&#x20;

2️⃣ Collez l'URL du webhook fourni par Ksaar dans le champ texte prévu à cet effet en haut de votre écran.

3️⃣ Sélectionnez l'option **POST.**

4️⃣ Cliquez sur **Content** et dans le cadre prévu à cet effet, écrivez/collez un schéma.

<img src="https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2Fq2sqUnxgDF9Ez97wJwiZ%2FCapture%20d%E2%80%99e%CC%81cran%202023-06-27%20a%CC%80%2011.34.01.png?alt=media&#x26;token=814518ca-9892-48b3-942f-af4c36b02ec3" alt="" data-size="original">

5️⃣ Cliquez sur **Send**. Après avoir envoyé le webhook d'exemple, vous devriez recevoir un message de réussite ou d'échec :&#x20;

![](https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2FIs7Ji6djw0kypmCgvWpW%2FCapture%20d%E2%80%99e%CC%81cran%202023-06-27%20a%CC%80%2011.36.35.png?alt=media\&token=8ea9e9ac-ca56-40d1-a56c-6a682b8efbf7)

6️⃣ Sur Ksaar, cliquez sur **Tester le webhook** pour visualiser le schéma que vous avez envoyé. Vous pouvez ensuite l'utiliser en cliquant sur **Utiliser ce schéma**.

![](https://2063331370-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2F-MQBQ-Fk5qKATOA2R2_R%2Fuploads%2F3s4w1Ij27d7ItA6fgHbS%2FCapture%20d%E2%80%99e%CC%81cran%202023-06-27%20a%CC%80%2011.37.09.png?alt=media\&token=2f0f08e3-4445-41c9-8bb5-00afd8c38100)

</details>
