> ## Documentation Index
> Fetch the complete documentation index at: https://docs.qwoty.io/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Envoyez les événements Qwoty, comme un devis créé ou mis à jour, vers vos propres endpoints.

Un webhook envoie une requête HTTP `POST` à votre endpoint lorsqu'un événement se produit dans Qwoty, par exemple lorsqu'un devis est créé ou validé. Utilisez les webhooks pour tenir vos propres systèmes à jour sans interroger l'API en continu.

Cette page explique comment configurer les webhooks dans l'application. Pour le format du payload et la liste des noms d'événements, consultez [Webhooks](https://docs.qwoty.io/fr/developers/core-concepts/webhooks.md) dans la documentation développeurs.

> [!NOTE]
>
> Pour gérer les webhooks, vous avez besoin d'un rôle disposant de la permission de paramètres **Développeurs**. Consultez la [référence des permissions](https://docs.qwoty.io/fr/user-guide/settings/users/reference/permissions.md).

## Ouvrir la liste des webhooks

**1. Ouvrir les paramètres**

Cliquez sur **Paramètres** dans la navigation principale.

**2. Ouvrir Webhook**

Dans la section **Développeur**, cliquez sur **Webhook**.

La liste affiche chaque webhook avec son **Nom**, sa **Description** et sa **Dernière livraison**.

## Créer un webhook

**1. Cliquer sur Nouveau**

Cliquez sur **Nouveau** en haut à droite de la liste.

**2. Nommer le webhook**

Saisissez un **Nom** et, si vous le souhaitez, une **Description**.

**3. Saisir l'endpoint**

Saisissez l'**URL du point de terminaison** qui recevra les requêtes, par exemple `https://example.com/webhook`.

**4. Choisir l'objet et les événements**

Sélectionnez l'**Objet**, puis une ou plusieurs valeurs d'**Événement**. « Sélectionnez les événements que vous souhaitez envoyer à ce point de terminaison. »

**5. Ajouter un secret (facultatif)**

Saisissez un **Secret**. Qwoty l'inclut dans le champ `secret` de chaque payload : votre endpoint peut ainsi vérifier que la requête provient bien de Qwoty.

**6. Enregistrer**

Cliquez sur **Enregistrer**.

![Formulaire de nouveau webhook avec les champs Nom, Description, URL du point de terminaison, Objet, Événement et Secret](https://mintcdn.com/qwoty-45352a33/eWpiS0eDlFAhkSLr/images/app/settings-webhook-new.jpg?fit=max\&auto=format\&n=eWpiS0eDlFAhkSLr\&q=85\&s=129bd0ce8e63cce089da438dfb9b8d00)

## Objets et événements

Chaque webhook écoute un seul objet. Les événements disponibles dépendent de l'objet :

| Objet | Événements |
| - | - |
| **Devis** | Nouveau, Mise à jour, Validation, Suppression |
| **Client** | Nouveau, Mise à jour, Suppression |
| **Produit** | Nouveau, Mise à jour, Suppression |
| **Segment client** | Nouveau, Mise à jour, Suppression |
| **Commande** | Bientôt disponible (non sélectionnable) |
| **Contrat** | Bientôt disponible (non sélectionnable) |

Pour envoyer des événements sur plusieurs objets, créez un webhook par objet.

## Vérifier les livraisons

La colonne **Dernière livraison** affiche le résultat de la requête la plus récente :

| Valeur | Signification |
| - | - |
| **Jamais déclenché** | Aucun événement n'a encore été envoyé |
| **Réussie** | Votre endpoint a accepté la requête |
| **Échec** | La requête a échoué. Survolez la valeur pour en voir la raison : l'endpoint n'a pas répondu à temps, a renvoyé une erreur HTTP ou était injoignable |

Qwoty attend jusqu'à 10 secondes la réponse de votre endpoint.

## Modifier ou supprimer un webhook

Cliquez sur le menu **⋯** en fin de ligne et sélectionnez **Modifier** ou **Supprimer**.

## Ressources associées

> **[Webhooks (développeurs)](https://docs.qwoty.io/fr/developers/core-concepts/webhooks.md)**
>
> Format du payload et noms des événements.

> **[Tokens d'API](https://docs.qwoty.io/fr/user-guide/settings/developer/api-tokens.md)**
>
> Appelez l'API Qwoty depuis vos systèmes.

> **[Intégrations](https://docs.qwoty.io/fr/user-guide/settings/integrations/introduction.md)**
>
> Connecteurs prêts à l'emploi pour les outils de CRM, de facturation et de messagerie.

> **[Vue d'ensemble des paramètres](https://docs.qwoty.io/fr/user-guide/settings/introduction.md)**
>
> Toutes les sections des paramètres.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.