HTTP-Webhook
Starten Sie eine Automation, wenn ein externes System Daten an eine URL sendet.
Funktionsweise
Der Trigger stellt einen URL-Endpunkt bereit. Wird er aufgerufen, startet der Workflow, und Header sowie Body der Anfrage stehen im Speicher bereit. Das ist der Standardweg, um das AI Kit an jedes andere System anzubinden, das HTTP senden kann – CRM-Systeme, Ticketsysteme, Monitoring-Werkzeuge, eigene Anwendungen.
Die URL ist je Workflow eindeutig und enthält einen gemeinsamen geheimen Schlüssel, sodass nur Aufrufer, die ihn kennen, den Workflow starten können.
Einstellungen
| Feld | Was es steuert | Erforderlich | Hinweise |
|---|---|---|---|
| Gemeinsamer Schlüssel | Geheimer Wert, der in die URL eingebettet ist. | erforderlich | Wird verschlüsselt gespeichert. Die Webhook-URL lautet …/webhook/{workspace}/{workflow}/{key}. |
| Anfrage-Header (optional) | Wo die HTTP-Header gespeichert werden. | optional | Nützlich für Entscheidungen zu Authentifizierung oder Weiterleitung im Workflow. |
| Anfrage-Inhalt (Body) | Wo der Body der Anfrage gespeichert wird. | erforderlich | Das ist meist das, was Ihr Workflow verarbeitet. |
📷 SCREENSHOT: Der Trigger „HTTP-Webhook-Empfänger“ mit dem Feld für den geheimen Schlüssel und der Vorschau der erzeugten URL darunter.
Beispielszenario
Auf ein neues Ticket reagieren. Ihr Ticketsystem kann beim Anlegen eines Tickets einen Webhook auslösen. Richten Sie ihn so ein, dass er die Webhook-URL des AI Kit aufruft. Der Workflow liest das Ticket aus dem Body, fasst es mit einem LLM zusammen und schreibt über HTTP-Anfrage einen Kommentar zurück.
Empfehlungen
- ✅ Verwenden Sie einen langen, zufälligen gemeinsamen Schlüssel. Behandeln Sie ihn wie ein Passwort.
- ✅ Wechseln Sie den Schlüssel regelmäßig – und sofort, wenn Sie vermuten, dass er bekannt geworden ist. Passen Sie gleichzeitig das aufrufende System an.
- ✅ Kann Ihr Aufrufer Anfragen signieren (HMAC), behalten Sie den gemeinsamen Schlüssel trotzdem bei. Mehrere Schutzebenen sind besser als eine.
- ⚠️ Der Endpunkt antwortet schnell, auch wenn der Workflow länger dauert. Aufrufer sollten sich nicht darauf verlassen, dass die Antwort das Ergebnis des Workflows enthält.
- ❌ Veröffentlichen Sie die URL samt Schlüssel nicht an öffentlich zugänglichen Stellen (READMEs, Screenshots, Fehlermeldungen).
Nächste Schritte
- Für ausgehende HTTP-Anfragen aus einem Workflow: HTTP-Anfrage.
- Für eingehende Mails: E-Mail-Posteingang.