> 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/de/what-would-you-like-to-learn-about/advocate-program/advocate-program-settings/create-and-manage-advocate-webhook-subscriptions.md).
# Webhook-Abonnements für Advocate erstellen und verwalten
Webhooks sind Code, der ausgeführt wird, wenn ein Ereignis eintritt. Advocate ermöglicht es Ihnen, Webhooks zu verwenden, um eine URL zu registrieren, an die wir per POST senden, sobald in Ihrem Programm ein Ereignis eintritt, z. B. wenn für einen neuen Teilnehmer ein Vanity-Gutscheincode erstellt wird, wird ein Event-Objekt erstellt. Es gibt zwei Methoden zum Erstellen und Verwalten von Webhooks: [über die Advocate API](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs) oder in der Advocate-Plattform. In diesem Hilfeartikel wird erläutert, wie Sie Webhooks über die Advocate-Plattform verwalten.
#### Webhook-Abonnement erstellen
1. Wählen Sie in der oberen Navigationsleiste  **\[Benutzerprofil] → Einstellungen**.
2. In der linken Spalte unten *Advocate-Einstellungen*, wählen Sie **Webhooks**.
3. Auf der *Webhook-Abonnements* Seite, wählen Sie **Abonnement erstellen**.
4. Unter *An URL senden*, geben Sie die eindeutige Adresse ein, die die Anwendung verwendet, um Echtzeit-Updates zu bestimmten Ereignissen zu senden.
5. Optional, unten *Webhook-Name*, geben Sie den Namen des neuen Webhook-Abonnements ein.
6. Wählen Sie **Speichern**.
#### Webhook-Protokolle beheben
Wenn Sie eine URL registrieren, an die Advocate bei jedem Ereignis in Ihrem Programm sendet, können Sie die Protokolle prüfen und alle fehlgeschlagenen Webhook-Ereignisse beheben.
**Auf Ihre Webhook-Protokolle zugreifen**
1. Wählen Sie in der oberen Navigationsleiste  **\[Benutzerprofil] → Einstellungen**.
2. In der linken Spalte unten *Advocate-Einstellungen*, wählen Sie **Webhooks**.
3. Auf der *Webhook-Abonnements* Seite, wählen Sie **Protokolle anzeigen**.
4. Verwenden Sie die folgenden Filter *Webhook-Ereignisprotokoll* um die Webhooks zu filtern.
* Siehe *Filterreferenz* unten für weitere Informationen an.
Filterreferenz
| Filter | Beschreibung |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typ | Nach dem Webhook filtern [Ereignistyp](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). Dieser Filter ist standardmäßig auf *Alle Typen*. |
| Zeitraum | Filtern Sie nach dem Zeitraum, in dem der Webhook zuletzt aktualisiert wurde. Dieser Filter ist standardmäßig auf *Gesamte Zeit*. |
**Webhook-Details anzeigen**
1. Wählen Sie einen bestimmten Webhook aus, um die *Webhook-Details* Ansicht zu öffnen.
2. Diese Ansicht bietet Informationen, die zur Fehlerbehebung bei einem Webhook-Abonnement verwendet werden können.
* Siehe *Ereignisreferenz* unten für weitere Informationen an.
Ereignisreferenz
| Filter | Beschreibung |
| ----------------- | ------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------ |
| Typ | Der Webhook [Ereignistyp](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| Webhook-ID | Die eindeutige Kennung des Webhooks. |
| Erstellungsdatum | Das Datum, an dem der Webhook erstellt wurde. |
| Ereignisdaten | Der Webhook [Nutzdaten](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs). |
| Abonnement(e) | Webhook-Abonnements, an die der Webhook gesendet wurde, und deren Status. |
| Abonnementdetails | Details zur Antwort, die vom Endpunkt des Webhook-Abonnements empfangen wurde. Zu den Details können der Zustellversuch des Webhooks gehören, einschließlich des Zeitstempels des Versuchs, des vom Ziel empfangenen HTTP-Statuscodes und ob der Versuch aufgrund einer zu langen Antwortzeit des Zielservers zeitüberschritten ist. |
**Webhook-Wiederholungsmechanismus für fehlgeschlagene Ereigniszustellungen**
* Webhooks werden sofort nach Auslösung eines Ereignisses zugestellt. Wenn der Endpunkt auf einen Zustellversuch nicht erfolgreich reagiert (d. h. mit einem Statuscode ungleich 200 antwortet), wird die Zustellung als fehlgeschlagen betrachtet.
* Fehlgeschlagene Zustellungen werden nach dem vorherigen fehlgeschlagenen Versuch stündlich erneut versucht, bis entweder eine erfolgreiche Zustellung erfolgt oder 72 Versuche unternommen wurden (etwa 3 Tage bei einer Rate von 1 Wiederholungsversuch pro Stunde).
* Webhook-Endpunkte, die durchgehend Fehler zurückgeben, werden nach der folgenden Anzahl von Fehlern automatisch deaktiviert:
| Statuscode | Empfangene Fehler |
| ---------- | ----------------- |
| 4xx-Fehler | 1000 |
| 5xx-Fehler | 2000 |
| 3xx-Fehler | 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/de/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.