> 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 bei jedem Ereignis in Ihrem Programm eine POST-Anfrage senden, z. B. wenn für einen neuen Teilnehmer ein personalisierter Gutscheincode erstellt wird. Dabei wird ein Ereignisobjekt erstellt. Es gibt zwei Möglichkeiten, 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. In diesem Hilfeartikel erfahren Sie, wie Sie Webhooks über die Advocate-Plattform verwalten.

#### Webhook-Abonnement erstellen

1. Wählen Sie in der oberen Navigationsleiste  ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Benutzerprofil] → Einstellungen**.
2. Wählen Sie in der linken Spalte unter *Advocate-Einstellungen*, **Webhooks**.
3. Wählen Sie auf der Seite *Webhook-Abonnements* , **Abonnement erstellen**.
4. Geben Sie unter *URL für POST*die eindeutige Adresse ein, über die die Anwendung Echtzeitaktualisierungen zu bestimmten Ereignissen sendet.
5. Optional können Sie unter *Webhook-Name*den Namen des neuen Webhook-Abonnements eingeben.
6. Wähle **Speichern**.

#### Webhook-Protokolle untersuchen

Wenn Sie eine URL registrieren, an die Advocate bei jedem Ereignis in Ihrem Programm eine POST-Anfrage sendet, können Sie die Protokolle einsehen und Fehler bei fehlgeschlagenen Webhook-Ereignissen untersuchen.

**Webhook-Protokolle aufrufen**

1. Wählen Sie in der oberen Navigationsleiste  ![](https://1698965099-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FwMLlMoFBtKJa8ptd3zaw%2Fuploads%2F210dEQa93qyQgoJDkieL%2FUser%20profile.svg?alt=media\&token=f84c5b17-fae4-4a30-990a-9de5e57a150b) **\[Benutzerprofil] → Einstellungen**.
2. Wählen Sie in der linken Spalte unter *Advocate-Einstellungen*, **Webhooks**.
3. Wählen Sie auf der Seite *Webhook-Abonnements* , **Protokolle anzeigen**.
4. Verwenden Sie die folgenden Filter unter *Webhook-Ereignisprotokoll* , um die Webhooks zu filtern.
   * Weitere Informationen finden Sie in der folgenden *Filterreferenz* .

<details>

<summary>Filterreferenz</summary>

| Filter   | Beschreibung                                                                                                                                                                                                      |
| -------- | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typ      | Nach dem Webhook- [Ereignistyp](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs)filtern. Standardmäßig ist dieser Filter auf *Alle Typen*. |
| Zeitraum | Nach dem Zeitraum filtern, in dem der Webhook zuletzt aktualisiert wurde. Standardmäßig ist dieser Filter auf *Gesamter Zeitraum*.                                                                                |

</details>

**Webhook-Details anzeigen**

1. Wählen Sie einen bestimmten Webhook aus, um die Ansicht *Webhook-Details* zu öffnen.
2. Diese Ansicht enthält Informationen, mit denen Sie Fehler bei einem Webhook-Abonnement untersuchen können.
   * Weitere Informationen finden Sie in der folgenden *Ereignisreferenz* .

<details>

<summary>Ereignisreferenz</summary>

| Filter            | Beschreibung                                                                                                                                                                                                                                                                                                                            |
| ----------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| Typ               | Der [Ereignistyp](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                                              |
| Webhook-ID        | Der eindeutige Bezeichner des Webhooks.                                                                                                                                                                                                                                                                                                 |
| Erstellungsdatum  | Das Datum, an dem der Webhook erstellt wurde.                                                                                                                                                                                                                                                                                           |
| Ereignisdaten     | Die Nutzlast des Webhooks [Nutzlast](https://integrations.impact.com/integration-guides/for-brands/advocate/advocate-api/api-webhooks-for-advocate-programs).                                                                                                                                                                           |
| Abonnement(s)     | Webhook-Abonnements, an die der Webhook gesendet wurde, und deren Status.                                                                                                                                                                                                                                                               |
| Abonnementdetails | Details zur Antwort, die vom Endpunkt des Webhook-Abonnements empfangen wurde. Dazu gehören beispielsweise Zustellversuche des Webhooks mit dem Zeitstempel des Versuchs, dem vom Ziel empfangenen HTTP-Statuscode und der Information, ob der Versuch wegen einer zu langen Wartezeit auf eine Antwort des Zielservers abgelaufen ist. |

</details>

**Webhook-Wiederholungssystem für fehlgeschlagene Ereigniszustellungen**

* Rest Hooks werden unmittelbar nach dem Auslösen eines Ereignisses zugestellt. Antwortet der Endpunkt nicht erfolgreich auf einen Zustellversuch (d. h. mit einem anderen Statuscode als 200), gilt die Zustellung als fehlgeschlagen.
* Fehlgeschlagene Zustellungen werden jede Stunde nach dem vorherigen fehlgeschlagenen Versuch erneut versucht, bis entweder eine Zustellung erfolgreich ist oder 72 Versuche unternommen wurden (etwa 3 Tage bei einer Wiederholung pro Stunde).
* Webhook-Endpunkte, die wiederholt 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=<question>&goal=<user_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.
