> 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 ex. lorsqu'un code promo de type vanity 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 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. Sur l’ *Abonnements aux webhooks* page, sélectionnez **Créer un abonnement**.
4. Ci-dessous *Poster 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. En option, ci-dessous *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 POST 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 ayant échoué.
**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. Sur l’ *Abonnements aux webhooks* page, sélectionnez **Afficher les journaux**.
4. Utilisez les filtres ci-dessous *Journal des événements des webhooks* pour filtrer les webhooks.
* Consultez la *référence des filtres* ci-dessous pour plus d'informations.
référence des filtres
| Filtre | Description |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type | Filtrer le webhook [type d'événement](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Ce filtre est défini par défaut sur *Tous les types*. |
| Période | Filtrez la période au cours de laquelle le webhook a été mis à jour pour la dernière fois. Ce filtre est défini par défaut sur *Toute la période*. |
**Afficher les détails du webhook**
1. Sélectionnez un webhook spécifique pour ouvrir la vue *Détails du webhook* .
2. Cette vue fournit des informations qui peuvent être utilisées pour résoudre les problèmes d'un abonnement au webhook.
* Consultez la *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 aux webhooks auxquels le webhook a été envoyé et leur statut. |
| Détails de l'abonnement | Détails de la réponse reçue depuis le point de terminaison de l'abonnement au webhook. Les détails peuvent inclure la tentative de livraison du webhook, montrant 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 ayant échoué**
* Les rest hooks 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 renvoie pas un code d'état 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 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://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 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.