> For the complete documentation index, see [llms.txt](https://ksaar.gitbook.io/ksaar-documentation/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://ksaar.gitbook.io/ksaar-documentation/les-automations/quand-un-webhook-est-recu.md).

# 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="/files/dxZPo07clfjfSYS1JYb6" 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="/files/aMan3qrJT2XqCm8Imat3" 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="/files/7rMt8dKPw98wkISCWeRC" 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="/files/itB8hoAXa3RGtnTmGiSQ" 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="/files/mXoAlbz8NcQ2VV1i5gTK" 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;

![](/files/CvweHfB28RJRZbPIue7R)

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

![](/files/yeia12CB2sCuUClsow8q)

</details>


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://ksaar.gitbook.io/ksaar-documentation/les-automations/quand-un-webhook-est-recu.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.