> 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).
# Advocate-Webhook-Abonnements 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 per POST senden, wenn in Ihrem Programm ein Ereignis eintritt, z. B. wenn ein Vanity-Gutscheincode für einen neuen Teilnehmer erstellt wird, wird ein Ereignisobjekt 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. Dieser Hilfeartikel erklärt, wie Sie Webhooks über die Advocate-Plattform verwalten.
#### Eine 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 jedes Mal sendet, wenn in Ihrem Programm ein Ereignis eintritt, können Sie die Protokolle überprüfen und fehlerhafte Webhook-Ereignisse beheben.
**Greifen Sie auf Ihre Webhook-Protokolle zu**
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 *Webhooks-Ereignisprotokoll* um die Webhooks zu filtern.
* Siehe die *Filterreferenz* unten für weitere Informationen.
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 die *Ereignisreferenz* unten für weitere Informationen.
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 ihr Status. |
| Abonnementdetails | Details zur Antwort, die vom Webhook-Abonnement-Endpunkt empfangen wurde. Zu den Details können der Zustellversuch des Webhooks gehören, einschließlich des Zeitstempels des Versuchs, des vom Ziel erhaltenen HTTP-Statuscodes und ob der Versuch aufgrund der zu langen Antwortzeit des Zielservers einen Timeout erlitten hat. |
**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 anderen Statuscode als 200 antwortet), wird die Zustellung als fehlgeschlagen betrachtet.
* Fehlgeschlagene Zustellungen werden stündlich nach dem vorherigen fehlgeschlagenen Versuch erneut versucht, bis entweder eine erfolgreiche Zustellung erfolgt oder 72 Versuche unternommen wurden (ungefähr 3 Tage bei einer Rate von 1 Wiederholungsversuch pro Stunde).
* Webhook-Endpunkte, die dauerhaft 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.