Webhook-Trigger

​

Überblick

​

Wann du den Webhook-Trigger verwenden solltest

• Empfangen von Events von externen Services (GitHub, Stripe, eigene Apps)
• Echtzeit-Datenverarbeitung von externen Systemen
• Erstellen benutzerdefinierter Integrationen
• Verbinden von Services, die Webhooks unterstützen (einschließlich anderer Workflows)
• API-gesteuerte Workflows, die von anderen Systemen initiiert werden

• Benutzerbezogene Datenerfassung (verwende Formular-Trigger)
• Geplante wiederkehrende Aufgaben (verwende geplanten Trigger)
• Native Integrations-Events (verwende Integrations-Trigger)

​

Konfiguration

​

Basis-Einrichtung

• Eindeutige Webhook-URL: Ein sicherer Endpoint zum Empfangen von Anfragen
• Webhook-ID: Kennung für deinen Webhook

​

Sicherheitsoptionen

1. Secret hinzufügen (optional)
   • Setze einen Secret-Wert in der Webhook-Konfiguration
   • Füge dieses Secret in den Request-Header oder Body ein, wenn du den Webhook aufrufst
   • Nur Anfragen mit dem korrekten Secret triggern den Workflow
2. Kein Secret (Standard)
   • Webhook ist öffentlich zugänglich
   • Jeder mit der URL kann ihn triggern
   • Gut für Tests und Low-Security-Anwendungsfälle

​

Wie es funktioniert

1. Externes System sendet HTTP POST-Anfrage an Webhook-URL
2. Webhook validiert Authentifizierung (falls konfiguriert)
3. Request-Payload wird geparst (JSON)
4. Workflow startet mit Payload-Daten verfügbar als {{trigger}}
5. Webhook antwortet sofort mit 200 OK
6. Workflow verarbeitet asynchron

​

Anfragen an deinen Webhook senden

​

Basis-Anfrage

curl -X POST https://app.langdock.com/api/workflows/webhooks/abc123 \
  -H "Content-Type: application/json" \
  -d '{"key": "value"}'

​

Beispiel-Anwendungsfälle

​

GitHub Webhook-Integration

Webhook-Trigger (GitHub Push-Events)
→ Agent: Analysiere Commit-Nachrichten
→ Condition: Prüfe, ob Dokumentation aktualisiert wurde
  → Ja: Regeneriere Docs
  → Nein: Fortfahren
→ Benachrichtigung: Sende Deployment-Status

• URL: Deine Webhook-URL
• Events: Push, Pull Request
• Content-Type: application/json

​

Stripe-Zahlungs-Webhook

Webhook-Trigger (Stripe Events)
→ Code: Validiere Stripe-Signatur
→ Condition: Prüfe Event-Typ
  → payment_succeeded: Aktualisiere Benutzer-Account
  → payment_failed: Sende Retry-Benachrichtigung
  → subscription_canceled: Deaktiviere Zugriff

​

Benutzerdefinierte Anwendungs-Integration

Webhook-Trigger
→ Code: Validiere und transformiere Daten
→ HTTP Request: Reichere Daten von externer API an
→ Agent: Analysiere und kategorisiere
→ Action: Erstelle Datensatz im CRM

​

Slack-Command-Integration

Webhook-Trigger (von Slack Slash-Command)
→ Agent: Verarbeite natürlichsprachlichen Befehl
→ HTTP Request: Führe Aktion in externem System aus
→ HTTP Response: Sende Ergebnis zurück zu Slack

​

Auf Webhook-Daten zugreifen

{{trigger.output.user_id}}
{{trigger.output.event_type}}
{{trigger.output.data.amount}}

Event: {{trigger.output.event}}
Bestellung: {{trigger.output.order_id}}
Kunde: {{trigger.output.customer_name}}
Erstes Item: {{trigger.output.items[0].product}}

​

Response-Codes

​

Nächste Schritte