Webhook-trigger

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

Webhook-trigger

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

1

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

2

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

1

Extern systeem verzendt HTTP POST-verzoek naar webhook-URL

2

Webhook valideert authenticatie (indien geconfigureerd)

3

Request-payload wordt geparseerd (JSON)

4

Workflow start met payloadgegevens beschikbaar als {{trigger}}

5

Webhook reageert onmiddellijk met 200 OK

6

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

• Integration Trigger — Gebruik native integratiegebeurtenissen

• HTTP Request Node — Doe verzoeken aan externe API's

• Code Node — Valideer en transformeer webhookgegevens

• Aan de slag — Bouw je eerste workflow

Webhook-trigger

Webhook-trigger