> For the complete documentation index, see [llms.txt](https://help.impact.com/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md).

# Créer et gérer les abonnements aux webhooks Advocate

Les webhooks sont du code qui s’exécute lorsqu’un événement se produit. Advocate vous permet d’utiliser des webhooks pour enregistrer une URL à laquelle nous enverrons une requête POST chaque fois qu’un événement se produit dans votre programme. Par exemple, lorsqu’un code de coupon personnalisé est créé pour un nouveau participant, un objet événement est créé. Il existe deux méthodes pour créer et gérer des webhooks : [via l’API Advocate](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs) ou sur la plateforme Advocate. Cet article d’aide explique comment gérer les webhooks sur la plateforme Advocate.

#### Créer un abonnement à un webhook

1. Dans la barre de navigation supérieure, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profil utilisateur] → Paramètres**.
2. Dans la colonne de gauche, sous *Paramètres Advocate*, sélectionnez **Webhooks**.
3. Sur la page *Abonnements aux webhooks* , sélectionnez **Créer un abonnement**.
4. Sous *URL de destination*, saisissez l’adresse unique utilisée par l’application pour envoyer des mises à jour en temps réel sur des événements spécifiques.
5. Facultativement, sous *Nom du webhook*, saisissez le nom du nouvel abonnement au webhook.
6. Sélectionnez **Enregistrer**.

#### Dépanner les journaux des webhooks

Lorsque vous enregistrez une URL à laquelle Advocate envoie une requête chaque fois qu’un événement se produit dans votre programme, vous pouvez consulter les journaux et résoudre les problèmes liés aux événements de webhook qui échouent.

**Accéder aux journaux de vos webhooks**

1. Dans la barre de navigation supérieure, sélectionnez ![](https://57104473-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Profil utilisateur] → Paramètres**.
2. Dans la colonne de gauche, sous *Paramètres Advocate*, sélectionnez **Webhooks**.
3. Sur la page *Abonnements aux webhooks* , sélectionnez **Afficher les journaux**.
4. Utilisez les filtres ci-dessous dans le *Journal des événements des webhooks* pour filtrer les webhooks.
   * Consultez la *Référence des filtres* ci-dessous pour en savoir plus.

<details>

<summary>Référence du filtre</summary>

| Filtre  | Description                                                                                                                                                                                                                      |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type    | Filtrez les webhooks selon leur [type d’événement](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Ce filtre est réglé par défaut sur *Tous les types*. |
| Période | Filtrez selon la période à laquelle le webhook a été mis à jour pour la dernière fois. Ce filtre est réglé par défaut sur *Toute la période*.                                                                                    |

</details>

**Afficher les détails d’un webhook**

1. Sélectionnez un webhook pour ouvrir la vue *Détails du webhook* .
2. Cette vue fournit des informations qui peuvent vous aider à résoudre les problèmes liés à un abonnement au webhook.
   * Consultez la *Référence des événements* ci-dessous pour en savoir plus.

<details>

<summary>Référence des événements</summary>

| Filtre                  | Description                                                                                                                                                                                                                                                                                                                                 |
| ----------------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type                    | Le webhook [type d’événement](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                      |
| ID du webhook           | L’identifiant unique du webhook.                                                                                                                                                                                                                                                                                                            |
| Date de création        | La date à laquelle le webhook a été créé.                                                                                                                                                                                                                                                                                                   |
| Données de l’événement  | La charge utile [du webhook](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                       |
| Abonnement(s)           | Les abonnements webhook auxquels le webhook a été envoyé, ainsi que leur état.                                                                                                                                                                                                                                                              |
| Détails de l’abonnement | Détails de la réponse reçue du point de terminaison de l’abonnement webhook. Ils peuvent inclure les tentatives de livraison du webhook, avec l’horodatage de chaque tentative, le code d’état HTTP reçu de la destination et la confirmation que la tentative a expiré parce que le serveur de destination a mis trop de temps à répondre. |

</details>

**Système de nouvelle tentative des webhooks en cas d’échec de livraison des événements**

* Les webhooks sont envoyés immédiatement après le déclenchement d’un événement. Si le point de terminaison ne répond pas correctement à une tentative de livraison (c’est-à-dire s’il renvoie un code d’état autre que 200), la livraison est considérée comme ayant échoué.
* Les livraisons ayant échoué feront l’objet d’une nouvelle tentative toutes les heures après l’échec précédent, jusqu’à ce qu’une livraison réussisse ou que 72 tentatives aient été effectuées (environ 3 jours au rythme d’une nouvelle tentative par heure).
* Les points de terminaison webhook qui renvoient systématiquement des erreurs sont automatiquement désactivés après le nombre d’erreurs suivant :

  | Code d’état | Erreurs reçues |
  | ----------- | -------------- |
  | Erreurs 4xx | 1000           |
  | Erreurs 5xx | 2000           |
  | Erreurs 3xx | 2000           |


---

# 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 by asking a question.

Perform an HTTP GET request on the following URL with the `ask` and `goal` query parameters:

```
GET https://help.impact.com/brand/fr/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md?ask=<question>&goal=<user_goal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is what the user is ultimately trying to achieve, the reason they need the answer. Sharing it helps GitBook give you a better, more relevant answer. A goal is most helpful when it describes the outcome the user wants rather than restating the question. For example, with `ask=how do I create an API token`, a goal like `automate deployments from our CI pipeline` lets GitBook tailor the answer to that use case.

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.
