Für Administratoren
Webhooks
Mit Webhooks legst du Endpoints an, also Adressen deines eigenen Systems, die bei ausgewählten Ereignissen automatisch benachrichtigt werden. Jeden Endpoint kannst du mit einem Test-Ping prüfen, und das letzte passende Ereignis kannst du erneut senden.
Webhook-Endpoint hinzufügen
- Öffne in den Einstellungen den Menüpunkt Webhooks.#
Du siehst eine Tabelle mit den Spalten „URL“, „Events“, „Status“, „Fehler“ und „Erstellt“.
- Klicke oben auf Endpoint hinzufügen.#
Das Fenster „Webhook-Endpoint anlegen“ öffnet sich.
- Trage die Endpoint-URL ein.#
Das Feld ist ein Pflichtfeld. Erlaubt ist nur HTTPS auf öffentlichen Domains, höchstens 2048 Zeichen.
- Trag bei Bedarf eine Beschreibung ein.#
Das Feld ist optional und fasst höchstens 255 Zeichen.
- Wähle die Events aus.#
Wenn du Alle Events abonnieren aktivierst, empfängst du jedes aktuelle und zukünftige Event. Sonst klappst du die Kategorien auf und hakst die gewünschten Events an. Du kannst auch alle Events einer Kategorie auf einmal auswählen.
- Bestätige das Fenster.#
Der Endpoint wird mit dem Status „Aktiv“ angelegt, und in der Erfolgsmeldung steht das Secret.
- Kopiere das Secret sofort aus der Meldung und bewahre es sicher auf.#
Letztes Event erneut senden
- Öffne in den Einstellungen den Menüpunkt Webhooks.#
- Such in der Tabelle die Zeile des gewünschten Endpoints.#
- Klicke in dieser Zeile auf das Symbol mit den kreisförmigen Pfeilen (Letztes Event erneut senden).#
- Prüfe die Meldung.#
Bei „Replay wurde ausgelöst.“ wird das Ereignis erneut an den Endpoint zugestellt.
Test-Ping senden
- Öffne in den Einstellungen den Menüpunkt Webhooks.#
- Such in der Tabelle die Zeile des Endpoints, den du prüfen willst.#
- Klicke in dieser Zeile auf das Symbol mit dem Papierflieger (Test-Ping).#
- Warte auf die Bestätigung und prüfe dann dein System.#
Es erscheint die Meldung „Test-Ping wurde in die Warteschlange gestellt.“ Prüfe danach in deinem System, ob der Ping angekommen ist.
Häufige Fragen
Ich habe das Secret nicht kopiert. Kann ich es mir nochmal anzeigen lassen?
Nein. Das Secret wird nur einmal angezeigt, direkt nach dem Anlegen des Endpoints.
Welche URLs kann ich als Endpoint eintragen?
Nur HTTPS-Adressen auf öffentlichen Domains mit höchstens 2048 Zeichen.
Wie kann ich einen Endpoint vorübergehend abschalten, ohne ihn zu löschen?
Bearbeite den Endpoint über die Bearbeiten-Aktion in seiner Tabellenzeile. Im Fenster „Webhook-Endpoint bearbeiten“ setzt du den Status auf „Deaktiviert“. Dort änderst du auch URL, Beschreibung und Events.
Was zeigt die Spalte „Fehler“?
Die Zahl der aufeinanderfolgenden fehlgeschlagenen Zustellungen an diesen Endpoint.