Webhook-trigger

Overzicht

De Webhook-trigger biedt een unieke HTTP-eindpunt dat externe systemen kunnen aanroepen om je workflow te starten. Het is de brug tussen Langdock Workflows en elke externe service of applicatie die HTTP-verzoeken kan verzenden.

Het beste voor: realtime-integraties, gebeurtenissen van externe systemen, API-gestuurde workflows en het verbinden van services zonder native integraties.

Wanneer de Webhook-trigger te gebruiken

Perfect voor:

Ontvangen van gebeurtenissen van externe services (GitHub, Stripe, aangepaste apps)
Realtime gegevensverwerking van externe systemen
Bouwen van aangepaste integraties
Verbinding maken met services die webhooks ondersteunen (inclusief andere workflows)
API-gestuurde workflows geïnitieerd door andere systemen

Niet ideaal voor:

Gegevensverzameling gericht op gebruikers (gebruik Form Trigger)
Geplande terugkerende taken (gebruik Scheduled Trigger)
Native integratie-gebeurtenissen (gebruik Integration Trigger)

Configuratie

Basisconfiguratie

Wanneer je een Webhook-trigger toevoegt, ontvang je automatisch:

Unieke webhook-URL: Een beveiligd eindpunt voor het ontvangen van verzoeken
Webhook-ID: Identificator voor je webhook

Beveiligingsopties

Geheime authenticatie

Configureer een geheim om je webhook-eindpunt te beveiligen:

Stel een geheime waarde in de webhook-configuratie in
Neem dit geheim op in de request-header of body wanneer je de webhook aanroept
Alleen verzoeken met het juiste geheim zullen de workflow activeren

Geen geheim (standaard)

Webhook is publiek toegankelijk
Iedereen met de URL kan het activeren
Goed voor testen en gebruikssituaties met lage beveiliging

Beste praktijk: Gebruik altijd een geheim voor productie-webhooks om ongeautoriseerde toegang te voorkomen.

Hoe het werkt

Extern systeem verzendt HTTP POST-verzoek naar webhook-URL

Webhook valideert authenticatie (indien geconfigureerd)

Request-payload wordt geparseerd (JSON)

Workflow start met payloadgegevens beschikbaar als {{trigger}}

Webhook reageert onmiddellijk met 200 OK

Workflow verwerkt asynchroon

Belangrijk: webhooks reageren onmiddellijk (binnen ~100 ms) en verwerken de workflow asynchroon. Vertrouw niet op de webhook-respons voor workflowresultaten.

Verzoeken doen naar je webhook

Basisverzoek

curl

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

Voorbeeldgebruikscases

GitHub-webhookintegratie

Voorbeeldstroom:

Webhook-trigger (GitHub push-gebeurtenissen)
→ Agent: Analyseer commit-berichten
→ Voorwaarde: Controleer of documentatie is bijgewerkt
  → Ja: Genereer documentatie opnieuw
  → Nee: Ga door
→ Melding: Stuur status van deployment

GitHub-webhookconfiguratie:

URL: Je webhook-URL
Gebeurtenissen: Push, Pull Request
Inhoudstype: application/json

Stripe-betaalwebhook

Voorbeeldstroom:

Webhook-trigger (Stripe-gebeurtenissen)
→ Code: Valideer Stripe-handtekening
→ Voorwaarde: Controleer gebeurtenistype
  → payment_succeeded: Werk gebruikersaccount bij
  → payment_failed: Stuur melding voor opnieuw proberen
  → subscription_canceled: Deactiveer toegang

Integratie met aangepaste applicatie

Voorbeeldstroom:

Webhook-trigger
→ Code: Valideer en transformeer gegevens
→ HTTP-verzoek: Verrijk gegevens vanuit externe API
→ Agent: Analyseer en categoriseer
→ Actie: Maak record aan in CRM

Slack-commando-integratie

Voorbeeldstroom:

Webhook-trigger (van Slack slash-commando)
→ Agent: Verwerk natuurlijke taalcommando
→ HTTP-verzoek: Voer actie uit in extern systeem
→ HTTP-respons: Stuur resultaat terug naar Slack

Toegang tot webhook-gegevens

Toegang tot de webhook-payload met behulp van de trigger variabele:

voorbeelden

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

Toegang in workflow:

voorbeelden

Gebeurtenis: {{trigger.output.event}}
Bestelling: {{triggeroutput.order_id}}
Klant: {{trigger.output.customer_name}}
Eerste item: {{trigger.output.items[0].product}}

Responscodes

Code

Betekenis

Wanneer het gebeurt

200

Succes

Workflow succesvol geactiveerd

400

Ongeldig verzoek

Ongeldige JSON of ontbrekende vereiste velden

401

Ongeautoriseerd

Authenticatie mislukt

403

Verboden

Workflow is gepauzeerd of inactief

500

Serverfout

Interne fout bij verwerken van webhook

Volgende stappen

VorigeFormuliertrigger VolgendeGids