> 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. Mit Advocate können Sie Webhooks verwenden, um eine URL zu registrieren, an die wir jedes Mal einen POST senden, wenn in Ihrem Programm ein Ereignis eintritt, z. B. wenn für einen neuen Teilnehmer ein Vanity-Gutscheincode erstellt wird, wird ein Ereignisobjekt erstellt. Es gibt zwei Methoden, um Webhooks zu erstellen und zu verwalten: [ü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. Dieser Hilfsartikel erklärt, 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. Unten *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 überprüfen und fehlgeschlagene 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 die *Filterreferenz* unten für weitere Informationen an.
Filterreferenz
| Filter | Beschreibung |
| -------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typ | Filter für den Webhook [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 *Gesamter Zeitraum*. |
**Webhook-Details anzeigen**
1. Wählen Sie einen bestimmten Webhook aus, um die Ansicht *Webhook-Details* zu öffnen.
2. Diese Ansicht bietet Informationen, die zur Fehlerbehebung bei einem Webhook-Abonnement verwendet werden können.
* Siehe die *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). |
| Abonnements | Webhook-Abonnements, an die der Webhook gesendet wurde, und deren Status. |
| Abonnementdetails | Details zur Antwort, die vom Endpunkt des Webhook-Abonnements erhalten wurde. Die Details können den Zustellversuch des Webhooks umfassen, einschließlich des Zeitstempels des Versuchs, des vom Ziel empfangenen HTTP-Statuscodes und ob der Versuch aufgrund einer zu langen Antwortzeit des Zielservers abgebrochen wurde. |
**Webhook-Wiederholungssystem für fehlgeschlagene Ereigniszustellungen**
* REST-Hooks werden sofort nach Auslösen eines Ereignisses zugestellt. Wenn der Endpunkt auf einen Zustellversuch nicht erfolgreich antwortet (d. h. mit einem Statuscode ungleich 200 antwortet), gilt die Zustellung als fehlgeschlagen.
* 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 Wiederholung pro Stunde).
* Webhook-Endpunkte, die wiederholt Fehler zurückgeben, werden nach der folgenden Anzahl von Fehlern automatisch deaktiviert:
| Statuscode | Erhaltene 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 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/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 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.