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
- 01Åbn et workflow, og tilføj Webhook fra nodekataloget.
- 02Udfyld de påkrævede felter, og knyt værdier fra tidligere trin.
- 03Kør noden med et lille testsæt, og kontrollér outputtet.
- 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
| Felt | Betydning | Område |
|---|---|---|
| Importformat | Indstil værdien i nodepanelet. | Standard |
| Importversion | Indstil værdien i nodepanelet. | Standard |
| Svar til den afsendende app | Svaret bekræfter modtagelsen. De næste trin fortsætter derefter. | Standard |
| Svartekst | Indstil 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-URL | Indstil værdien i nodepanelet. | Beskyttet |
| API-nøgle | Genereres automatisk. Forespørgsler skal sende nøglen med enten i headeren `X-Anymize-Api-Key` eller som `Authorization: Bearer <key>`. | Beskyttet |
| HTTP-metode | Valg: 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 |
| Godkendelse | Anbefalet: API-nøgle. Skift kun, hvis den der kalder bruger en anden metode. | Standard |
| Adgangsdata fra workflow-secret | Vælg et workflow-secret med adgangskoden, header-værdien eller JWT-signaturnøglen. Kun secret-navnet gemmes i workflowet. | Beskyttet |
| Brugernavn | Indstil værdien i nodepanelet. | Standard |
| Header-navn | Indstil værdien i nodepanelet. | Standard |
| Tilladte JWT-algoritmer | Kommasepareret liste over tilladte HMAC-algoritmer. Signaturnøglen kommer fra workflow-secret'et. | Standard |
| Svar-tilstand | Valg: Med det samme (200 OK), Når sidste trin er færdigt, Egen webhook-svar-blok til sidst | Standard |
| Svar-statuskode | Indstil værdien i nodepanelet. | Standard |
| Svar-data | Valg: Alle poster, Første post (JSON), Første post (fil), Ingen body | Standard |
| 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-format | Valg: JSON, Tekst, HTML, XML | Standard |
| Svar-headers | Indstil 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-crawlere | Indstil værdien i nodepanelet. | Standard |
| Send indhold uændret videre | Slå 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 signatur | Til tjenester, der signerer deres forespørgsler kryptografisk (f.eks. Stripe, GitHub). Slå til, når din afsender sender en signatur med. | Standard |
| Signatur-secret | Vælg workflow-secret'et med den fælles nøgle, som afsenderen signerer forespørgslen med. | Beskyttet |
| Navn på signatur-headeren | I hvilken HTTP-header din afsender sender signaturen. Standard er X-Signature, skift kun, hvis din tjeneste bruger et andet navn. | Standard |
| Signatur-metode | Hvilken metode din afsender bruger til at signere (står i dens webhook-dokumentation). I tvivl: SHA-256. | Standard |
Input og output
| Input | Betydning | Type |
|---|---|---|
| Standard | Udløseren kræver intet input. | JSON |
| Output | Betydning | Type |
|---|---|---|
| body | Den parsede JSON-body fra requesten. | json |
| headers | Alle HTTP-headers. | json |
| query | Query-parametre (?foo=bar). | json |
| params | Sti-parametre fra /:userId/details. | json |
| method | Requestens 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.