Webhooks
NGO.tools schickt Ereignisse automatisch an Endpoints, die du hinterlegst, und an Tools aus dem Marktplatz. Auf dieser Seite legst du deine eigenen Endpoints an, wählst aus, welche Events sie bekommen, und behältst die Zustellung im Blick. Du findest sie unter Einstellungen › Allgemein › Webhooks.
Die Seite steht nur Administratoren deiner Organisation zur Verfügung.
So kommst du hin
Deine Endpoints im Überblick
Die Liste zeigt deine Webhook-Endpoints, die zuletzt angelegten zuerst. Über Suche findest du einen Endpoint anhand seiner Adresse.
- URL: die Adresse, an die NGO.tools die Events schickt. Lange Adressen werden gekürzt angezeigt.
- Events: die Events, die der Endpoint abonniert hat.
- Status: der aktuelle Zustand des Endpoints.
- Fehler: wie oft die Zustellung an diesen Endpoint zuletzt hintereinander fehlgeschlagen ist.
- Erstellt: wann der Endpoint angelegt wurde. Nach dieser Spalte kannst du die Liste sortieren.
Einen Endpoint anlegen
Trag unter Endpoint-URL die Adresse des Systems ein, das die Events empfangen soll. Das Feld ist Pflicht, erlaubt sind nur HTTPS-Adressen auf öffentlichen Domains. Beschreibung ist freiwillig und fasst bis zu 255 Zeichen.
Schaltest du Alle Events abonnieren ein, empfängt der Endpoint jedes aktuelle und jedes künftige Event.
Lässt du den Schalter aus, wählst du die Events einzeln. Sie sind nach Bereichen in Abschnitten gruppiert, zum Beispiel Kontakt angelegt oder Spende eingegangen. Mit Abschnitt einklappen klappst du einen Bereich zu. Ist der Schalter an, blendet NGO.tools diese Abschnitte aus.
Beim Anlegen und beim Bearbeiten muss mindestens ein Event gewählt sein. Fehlt die Auswahl, speichert NGO.tools den Endpoint nicht und weist dich darauf hin.
Einen Endpoint ändern
- Klicke beim Endpoint, den du ändern willst, auf Bearbeiten.#
Es öffnet sich Webhook-Endpoint bearbeiten.
Du siehst Endpoint-URL, Beschreibung und deine bisherige Event-Auswahl. Hat der Endpoint alle Events abonniert, ist Alle Events abonnieren eingeschaltet. Sonst ist der Schalter aus und du siehst die Abschnitte mit den einzeln gewählten Events.
Zusätzlich legst du unter Status fest, ob der Endpoint aktiv oder deaktiviert ist. Endpoint-URL und Status sind Pflichtfelder.
Die Zustellung testen
Mit Test-Ping schickt NGO.tools eine Testnachricht an den Endpoint. Der Test-Ping wird in die Warteschlange gestellt, das bestätigt dir eine Meldung.
Mit Letztes Event erneut senden schickst du das jüngste Event noch einmal, das der Endpoint abonniert hat. NGO.tools sucht es unter den 50 neuesten Events. Passt keines davon zum Endpoint, bekommst du einen Hinweis und es wird nichts gesendet.
Einen Endpoint löschen
- Klicke beim Endpoint, den du entfernen willst, auf Löschen.#
Es öffnet sich Eintrag löschen, in dem du das Löschen bestätigst.
Häufige Fragen
Warum sehe ich Webhooks nicht?
Die Seite steht nur Administratoren deiner Organisation zur Verfügung. Bitte eine Person mit Administratorrechten, den Endpoint für dich einzurichten.
Was passiert, wenn die Zustellung an meinen Endpoint dauerhaft fehlschlägt?
Dann schaltet NGO.tools den Endpoint automatisch ab und ändert seinen Status. Du erkennst das in der Liste an der Spalte Status.
Kann ich das Secret später noch einmal ansehen?
Nein. NGO.tools zeigt das Secret nur einmal, direkt nach dem Anlegen des Endpoints. Kopiere es in diesem Moment.
Was ist der Unterschied zwischen Test-Ping und Letztes Event erneut senden?
Der Test-Ping schickt eine Testnachricht an den Endpoint. Beim erneuten Senden schickt NGO.tools dagegen ein echtes Event noch einmal, und zwar das jüngste, das der Endpoint abonniert hat.
Sind das dieselben Events, die ich für Apps aus dem Marktplatz wähle?
Ja. Für deine eigenen Webhook-Endpoints und für installierte Apps wählst du die Events aus demselben Katalog.