Webhooks
Ein Webhook benachrichtigt ein fremdes System, wenn in einem Grid etwas passiert.
Die Beschreibung in der Oberfläche:
Webhooks sind automatische Nachrichten, die gesendet werden, wenn etwas passiert. Sie haben eine Nachricht oder Payload und werden an eine eindeutige URL gesendet.
Zwei Richtungen, zwei Orte
| Richtung | Wo eingerichtet |
|---|---|
| ApptiveGrid → Fremdsystem | Space-Einstellungen → Webhooks — diese Seite |
| Fremdsystem → ApptiveGrid | Flow-Auslöser Webhook |
Beide heißen „Webhook", tun aber Entgegengesetztes.
Webhook anlegen
- Öffnen Sie Space Einstellungen → Webhooks.
- Klicken Sie auf Webhook erstellen.
- Vergeben Sie unter Name des Webhooks eine Bezeichnung. Vorgabe ist Mein Webhook.
- Legen Sie unter Den Flow auslösen, wenn das Ereignis fest.
- Tragen Sie die Ziel-URL ein und Speichern Sie.
Über Bearbeiten und Löschen verwalten Sie bestehende Webhooks.
Sprechend benennen
Bei mehreren Webhooks sagt „Mein Webhook" nichts. Benennen Sie nach Ziel und Zweck — „Warenwirtschaft: neue Bestellung".
Ereignisse
| Ereignis | Auslöser | Zusätzlich wählen |
|---|---|---|
| Neuer Eintrag | Ein Eintrag entsteht | Space, Grid |
| Eintrag verändert | Ein Eintrag wird geändert | Space, Grid |
| Neuer Eintrag per Formular | Ein Formular legt an | Space, Grid, Formular |
| Eintrag verändert per Formular | Ein Formular ändert | Space, Grid, Formular |
Über Space auswählen, Grid auswählen, Event auswählen und Formular auswählen grenzen Sie ein.
Veraltete Ereignisse
Ältere Webhooks können Ereignisse verwenden, die im Dialog mit veraltet gekennzeichnet sind. Sie funktionieren weiter, sollten bei einer Überarbeitung aber ersetzt werden.
Webhook oder Flow?
Beide reagieren auf dieselben Ereignisse. Der Unterschied:
| Webhook | Flow | |
|---|---|---|
| Zweck | Rohdaten weitergeben | Etwas tun |
| Logik | keine | Bedingungen, Schleifen, mehrere Schritte |
| Empfänger | ein System | beliebig viele Aktionen |
| Voraussetzung | Empfänger kann JSON verarbeiten | – |
Für die meisten Fälle ist ein Flow der richtige Weg
Ein Webhook schickt nur Daten weiter. Wollen Sie filtern („nur bei Beträgen über 1000 €"), anreichern oder mehrere Dinge auslösen, brauchen Sie einen Flow — dort ist der Schritt HTTP-Anfrage das Gegenstück zum Webhook, aber mit Logik davor.
Ein Webhook lohnt sich, wenn ein System schlicht jede Änderung mitbekommen soll.
Grenzen
Anzahl je Space ist tarifabhängig
Ist die Grenze erreicht, erscheint Weitere Webhooks anlegen mit einem Upgrade-Hinweis.
Keine Zustellkontrolle in der Oberfläche
Anders als bei Flow-Ausführungen gibt es keine Historie, die zeigt, ob ein Webhook angekommen ist. Schlägt die Zustellung fehl, bemerken Sie das nur am Zielsystem.
Wo Nachvollziehbarkeit wichtig ist, ist ein Flow die bessere Wahl — dort sehen Sie jede Ausführung samt Fehlern.
Sicherheit
Die Ziel-URL bekommt Ihre Daten
Der Webhook sendet den Inhalt des Eintrags an die eingetragene Adresse. Prüfen Sie:
- Ist die Adresse korrekt und aktuell?
- Wird über HTTPS übertragen?
- Darf der Empfänger diese Daten überhaupt erhalten?
Bei personenbezogenen Daten gehört das datenschutzrechtlich geprüft.
Nicht mehr benötigte Webhooks entfernen
Ein Webhook feuert weiter, auch wenn das Zielsystem längst abgeschaltet ist. Sehen Sie die Liste regelmäßig durch — besonders nach Systemwechseln.