Die folgenden Einstellungen zeigen den aktuellen Beta-Stand. Die Bilder und Rechenbeispiele dienen zur Orientierung; verwende für Deinen Betrieb die fachlich passenden Werte.
📣 Ein Ereignis meldet sich von selbst
Ein Webhook informiert ein anderes System, wenn ein ausgewähltes Ereignis in Deinem Account eintritt. Statt regelmäßig nach neuen Daten zu fragen, erhält die Verbindung eine Nachricht von Keyline.
Unter Konfiguration → Webhooks verwaltest Du die Ziele und ihre Auslöser. Ein Webhook ist keine Maschinenformel und keine eigene Produktionsleistung. Er verbindet einen Vorgang in Keyline mit einer Verarbeitung außerhalb von Keyline.
Beispiel: Wird ein Material angelegt, soll ein angebundenes System darüber informiert werden und anschließend seinen eigenen Abgleich starten. Der Webhook meldet das Ereignis; was das andere System daraus macht, wird dort eingerichtet.
🎯 Name, Zieladresse und HTTP-Methode
Webhook-Ziel und Authentifizierungsarten
Wähle Neuen Webhook erstellen und vergib einen verständlichen Namen, etwa „Materialmeldung ans Testsystem“. Unter Endpunkt URL steht die vollständige Empfangsadresse des anderen Systems.
Daneben wählst Du die HTTP-Methode. Angeboten werden GET, POST, PATCH und DELETE. Die Auswahl muss zur erwarteten Schnittstelle des Empfängers passen. Die Methode beschreibt die Anfrage an das Zielsystem – sie ist kein Befehl, in Keyline einen Datensatz zu löschen.
Für ein abgestimmtes Beispiel wäre POST https://example.com/keyline/events denkbar. Das ist eine Beispieladresse. Den realen Endpunkt erhältst Du von der Person, die das empfangende System betreut.
🔐 Authentifizierung und Zertifikate
Das Formular unterscheidet drei Arten von Empfängern:
Offener Endpunkt: Das Ziel erwartet keine zusätzliche Anmeldung über Basic Auth oder Bearer Token.
Basic Auth: Das Ziel nutzt eine HTTP-Anmeldung mit Benutzername und Passwort.
Bearer Token: Das Ziel erwartet ein Token im HTTP-Header
Authorization.
Diese Auswahl muss zu der tatsächlich eingerichteten Authentifizierung des Zielsystems passen. Die Zugangsdaten müssen in der Verbindung hinterlegt sein; das bloße Umschalten der Methode erzeugt kein gültiges Passwort oder Token. Wenn Dir dafür keine Eingabemöglichkeit angeboten wird, stimme die Einrichtung mit Deinem Integrationsbetreuer ab.
SSL Zertifikate prüfen steuert die Zertifikatsprüfung für die Verbindung. Verwende für reguläre Anbindungen eine korrekt eingerichtete HTTPS-Adresse und lasse die Prüfung aktiv. Ein Zertifikatsproblem wird am Zielsystem behoben.
⚡ Trigger bestimmen den Auslöser
Ein gespeicherter Webhook benötigt mindestens einen passenden Trigger, damit er bei einem echten Ereignis aufgerufen wird. Öffne im Aktionsmenü Trigger bearbeiten und trage den technischen Ereignisnamen ein.
Das Formular nennt beispielsweise warehouse.material_created. Mit einem solchen Trigger reagiert der Webhook auf genau dieses Ereignis im zugehörigen Account. Mehrere Trigger können denselben Endpunkt nutzen.
Die Bezeichnung muss exakt zur verfügbaren Ereignisdefinition passen. Das Freitextfeld ist keine freie Beschreibung wie „Wenn etwas im Lager passiert“. Stimme den konkreten Ereignisnamen und die benötigten Daten mit der Schnittstellenbetreuung ab.
Ein Eintrag ohne Trigger erscheint in der Liste als Keine Trigger. Ein vollständig eingerichteter Eintrag, der noch nicht aufgerufen wurde, steht auf Warte.
🧪 Test und Zustellstatus lesen
Die Testaktion sendet ein künstliches Testereignis an den hinterlegten Endpunkt. Sie ist damit eine echte ausgehende Anfrage und sollte mit dem empfangenden System abgestimmt sein. Du brauchst dafür keinen Kundenjob zu ändern.
Die Übersicht zeigt den letzten Aufruf und den Status. Aktiv bedeutet, dass der letzte Aufruf erfolgreich zugestellt wurde. Problem bedeutet, dass beim letzten Aufruf ein Fehler registriert wurde. Ein Fehler kann beispielsweise an Zieladresse, Anmeldung oder Antwort des Empfängers liegen.
Ein erfolgreicher Test beweist die Erreichbarkeit dieses Testaufrufs. Prüfe zusätzlich einen fachlich passenden echten Vorgang. Ein Test ohne passende Trigger ersetzt nicht die Einrichtung der realen Ereignisse.
🔗 Was wird außerhalb von Keyline benötigt?
Der Empfänger muss die Nachricht entgegennehmen und fachlich verarbeiten. Keyline verschickt JSON und ergänzt einen Signatur-Header X-Keyline-Signature. Die Prüfung dieser Signatur gehört zur technischen Einrichtung der empfangenden Verbindung.
Benötigt das Ziel nach einer Meldung weitere Daten aus Keyline, braucht es dafür einen passenden API-Zugang. Ein Webhook-Ziel und ein Keyline-API-Key haben unterschiedliche Richtungen: Der Webhook sendet nach außen; der API Key erlaubt einer Verbindung den Zugriff auf Keyline.
Prüfe bei einer Änderung deshalb immer beide Seiten: Welche Ereignisse sendet Keyline, an welches Ziel, mit welcher Anmeldung, und was macht das Ziel anschließend daraus? Ein Webhook allein führt noch keinen vollständigen Geschäftsprozess aus.
Passend dazu: API Keys
