> 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 enverrons une requête 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 explique comment gérer les webhooks via la plateforme Advocate.
#### Créer un abonnement 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 la *Abonnements webhook* 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, ci-dessous *Nom du webhook*, saisissez le nom du nouvel abonnement webhook.
6. Sélectionnez **Enregistrer**.
#### Dépanner les journaux des webhooks
Lorsque vous enregistrez une URL vers laquelle Advocate effectue des envois à chaque fois qu’un événement se produit dans votre programme, vous pouvez consulter les journaux et dépanner tout événement webhook en échec.
**Accédez à vos journaux 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 la *Abonnements webhook* de la page, sélectionnez **Afficher les journaux**.
4. Utilisez les filtres ci-dessous *Journal des événements des webhooks* pour filtrer les webhooks.
* Consultez le *Référence des filtres* ci-dessous pour plus d’informations.
Référence des filtres
| Filtre | Description |
| ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Type | Filtrez 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 à 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 pouvant être utilisées pour dépanner un abonnement webhook.
* Consultez le *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 webhook auxquels le webhook a été envoyé et leur statut. |
| Détails de l’abonnement | Détails sur la réponse reçue du point de terminaison de l’abonnement webhook. Les détails peuvent inclure la tentative de livraison du webhook, indiquant l’horodatage de la tentative, le code de statut 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 rest hooks sont envoyés immédiatement après le déclenchement d’un événement. Si le point de terminaison ne répond pas avec succès à une tentative de livraison (c’est-à-dire s’il répond avec un code de statut 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 webhook qui renvoient systématiquement des erreurs seront automatiquement désactivés après le nombre d’erreurs suivant :
| Code de statut | 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.