DokumentationWorkflowsUdløsere

Webhook node

Starter workflowet, når en HTTP-forespørgsel rammer din webhook-URL. Body, headers, query-parametre og sti-parametre sendes videre som output, perfekt til integrationer med Zapier, Make, Slack-knapper eller dine egne apps. Se opsætning, input og output, testforløb og løsning af typiske fejl.

11 min. læsningOpdateret

Hvad noden gør

Starter workflowet, når en HTTP-forespørgsel rammer din webhook-URL. Body, headers, query-parametre og sti-parametre sendes videre som output, perfekt til integrationer med Zapier, Make, Slack-knapper eller dine egne apps.

Brug Webhook som et klart afgrænset trin i et anymize-workflow.

  • Starter en ny workflow-kørsel.
  • Leverer 1 output til efterfølgende trin.
  • Kører som et normalt trin i forløbet.

Opsæt noden

  1. 01Åbn et workflow, og tilføj Webhook fra nodekataloget.
  2. 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
  3. 03Kør noden med et lille testsæt, og kontrollér outputtet.
  4. 04Forbind det vellykkede output, og aktivér først efter en samlet test.

Handlinger og tilstande

Webhook har én klart afgrænset opgave. Indstillingerne vises, når du vælger noden.

Indstillinger

FeltBetydningOmråde
ImportformatIndstil værdien i nodepanelet.Standard
ImportversionIndstil værdien i nodepanelet.Standard
Svar til den afsendende appSvaret bekræfter modtagelsen. De næste trin fortsætter derefter.Standard
SvartekstIndstil værdien i nodepanelet.Standard
Hvilke felter sender din webhook?Eksempler: email, name, amount. Hvert felt bliver sit eget output, så du kan trække det direkte over på andre noder, uden JSON-fnidder.Standard
Webhook-URLIndstil værdien i nodepanelet.Beskyttet
API-nøgleGenereres automatisk. Forespørgsler skal sende nøglen med enten i headeren `X-Anymize-Api-Key` eller som `Authorization: Bearer <key>`.Beskyttet
HTTP-metodeValg: GET, POST, PUT, PATCH, DELETE, HEAD, Alle (ANY)Standard
Eget URL-tillæg (valgfrit)Føjes bagest på din webhook-URL, f.eks. /kunde/details. Skriver du /:name, lander værdien dér senere som et felt i dit workflow.Standard
GodkendelseAnbefalet: API-nøgle. Skift kun, hvis den der kalder bruger en anden metode.Standard
Adgangsdata fra workflow-secretVælg et workflow-secret med adgangskoden, header-værdien eller JWT-signaturnøglen. Kun secret-navnet gemmes i workflowet.Beskyttet
BrugernavnIndstil værdien i nodepanelet.Standard
Header-navnIndstil værdien i nodepanelet.Standard
Tilladte JWT-algoritmerKommasepareret liste over tilladte HMAC-algoritmer. Signaturnøglen kommer fra workflow-secret'et.Standard
Svar-tilstandValg: Med det samme (200 OK), Når sidste trin er færdigt, Egen webhook-svar-blok til sidstStandard
Svar-statuskodeIndstil værdien i nodepanelet.Standard
Svar-dataValg: Alle poster, Første post (JSON), Første post (fil), Ingen bodyStandard
Hvilket felt skal returneres?Kun når Svar-data står på "Første post": angiv her feltnavnet, hvis værdi alene returneres (i stedet for hele objektet).Standard
Svar-formatValg: JSON, Tekst, HTML, XMLStandard
Svar-headersIndstil værdien i nodepanelet.Standard
Tilladte websites (valgfrit)Fra hvilke websites må browseren kalde denne webhook? Adskil flere med komma, * tillader alle.Standard
Kun disse afsender-adresser (valgfrit)Tillad kun forespørgsler fra bestemte IP-adresser. Adskil flere med komma, hele intervaller går også (f.eks. 10.0.0.0/8). Tomt = alle afsendere tilladt.Standard
Ignorér bots & link-preview-crawlereIndstil værdien i nodepanelet.Standard
Send indhold uændret videreSlå til, når body'en ikke er JSON (f.eks. ren tekst eller XML), så bliver den ikke skilt ad, men sendt rå videre.Standard
Fil-feltnavn (til fil-uploads)Kun til fil-/binær-uploads: skriver du et navn her, lander den uploadede fil under dette felt i dit workflow.Standard
Tjek forespørgslens signaturTil tjenester, der signerer deres forespørgsler kryptografisk (f.eks. Stripe, GitHub). Slå til, når din afsender sender en signatur med.Standard
Signatur-secretVælg workflow-secret'et med den fælles nøgle, som afsenderen signerer forespørgslen med.Beskyttet
Navn på signatur-headerenI hvilken HTTP-header din afsender sender signaturen. Standard er X-Signature, skift kun, hvis din tjeneste bruger et andet navn.Standard
Signatur-metodeHvilken metode din afsender bruger til at signere (står i dens webhook-dokumentation). I tvivl: SHA-256.Standard

Input og output

InputBetydningType
StandardUdløseren kræver intet input.JSON
OutputBetydningType
bodyDen parsede JSON-body fra requesten.json
headersAlle HTTP-headers.json
queryQuery-parametre (?foo=bar).json
paramsSti-parametre fra /:userId/details.json
methodRequestens HTTP-metode.text

Eksempel og testkørsel

Eksempel-body: start med et lille og genkendeligt datasæt. Kontrollér outputtet, og brug kun felter, der faktisk findes.

Eksempel på testkørsel

{
  "event": "signup",
  "user": {
    "id": "usr_abc123",
    "email": "max.mustermann@example.com",
    "name": "Max Mustermann"
  },
  "source": "landing-page"
}

Adgang og sikkerhed

Gennemgå hvilke data der kommer ind i trinnet, og hvad outputtet indeholder.

Gem nøgler og loginoplysninger i den beskyttede forbindelsesstyring. Indsæt dem aldrig i almindelige felter, testdata eller beskrivelser.

Løs typiske fejl

  • Intet output: kontrollér den seneste kørsel og felterne fra den forrige node.
  • Tom variabel: åbn outputtet fra det forrige trin, og brug et felt fra de faktiske testdata.
  • Workflowet starter ikke: aktivér det, og kontrollér udløserens tilstand.