> 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 vers laquelle nous effectuerons un POST chaque fois qu’un événement se produit dans votre programme, par exemple lorsqu’un code promo 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 dans la plateforme Advocate. Cet article d’aide expliquera comment gérer les webhooks via la plateforme Advocate.
#### Créer un abonnement au webhook
1. Dans la barre de navigation supérieure, sélectionnez  **\[Profil utilisateur] → Paramètres**.
2. Dans la colonne de gauche ci-dessous *Paramètres Advocate*, sélectionnez **Webhooks**.
3. Dans la *Abonnements aux webhooks* de la page, sélectionnez **Créer un abonnement**.
4. Ci-dessous *Publier vers l’URL*, saisissez l’adresse unique que l’application utilise 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**.
#### Résoudre les problèmes des journaux de webhook
Lorsque vous enregistrez une URL vers laquelle Advocate effectue un envoi chaque fois qu’un événement se produit dans votre programme, vous pouvez consulter les journaux et résoudre les problèmes liés à tout événement webhook qui échoue.
**Accédez à vos journaux de webhook**
1. Dans la barre de navigation supérieure, sélectionnez  **\[Profil utilisateur] → Paramètres**.
2. Dans la colonne de gauche ci-dessous *Paramètres Advocate*, sélectionnez **Webhooks**.
3. Dans la *Abonnements aux webhooks* de la page, sélectionnez **Afficher les journaux**.
4. Utilisez les filtres ci-dessous *Journal des événements des webhooks* pour filtrer les webhooks.
* Reportez-vous au *référentiel des filtres* ci-dessous pour plus d’informations.
référentiel des filtres
| Filtre | Description |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type | Filtrer par webhook [type d'événement](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Ce filtre est par défaut sur *Tous les types*. |
| Période | Filtrez la période à laquelle le webhook a été mis à jour pour la dernière fois. Ce filtre est par défaut sur *Toute période*. |
**Afficher les détails du webhook**
1. Sélectionnez un webhook spécifique pour ouvrir la *Détails du webhook* vue.
2. Cette vue fournit des informations qui peuvent être utilisées pour résoudre les problèmes d’un abonnement au webhook.
* Reportez-vous au *Référence de l’événement* ci-dessous pour plus d’informations.
Référence de l’événement
| 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 | Le webhook [charge utile](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| Abonnement(s) | Abonnements au webhook auxquels le webhook a été envoyé et leur statut. |
| Détails de l’abonnement | Détails de la réponse reçue du point de terminaison de l’abonnement au webhook. Les détails peuvent inclure la tentative de livraison du webhook, en affichant l’horodatage de la tentative, le code d’état HTTP reçu de la destination, et si la tentative a expiré parce que la requête a mis trop de temps à recevoir une réponse du serveur de destination. |
**Système de nouvelle tentative des webhooks pour les livraisons d’événements échouées**
* Les hooks REST sont livré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.-à-d. ne répond pas avec un code d’état autre que 200), la livraison sera considérée comme échouée.
* Les livraisons échouées seront retentées toutes les heures après la tentative échouée précédente jusqu’à ce qu’une livraison réussie soit effectuée ou jusqu’à ce que 72 tentatives aient été effectuées (environ 3 jours à raison d’une nouvelle tentative par heure).
* Les points de terminaison de webhook qui renvoient systématiquement des erreurs seront 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=&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.