DokumentasjonWorkflowsUtløsere
Webhook node
Starter workflowen når en HTTP-forespørsel treffer webhook-URL-en din. Body, headere, query-parametere og sti-parametere sendes videre som output, perfekt for integrasjoner med Zapier, Make, Slack-knapper eller egne apper. Se oppsett, input og output, testkjøring og løsning av vanlige feil.
11 min lesetidOppdatert
Hva noden gjør
Starter workflowen når en HTTP-forespørsel treffer webhook-URL-en din. Body, headere, query-parametere og sti-parametere sendes videre som output, perfekt for integrasjoner med Zapier, Make, Slack-knapper eller egne apper.
Bruk Webhook som et tydelig avgrenset trinn i en anymize-workflow.
- Starter en ny workflow-kjøring.
- Gir 1 output til senere trinn.
- Kjører som et vanlig trinn i flyten.
Sett opp noden
- 01Åpne en workflow og legg til Webhook fra nodekatalogen.
- 02Fyll ut obligatoriske felt og koble verdier fra tidligere trinn.
- 03Kjør noden med et lite testdatasett og kontroller outputtet.
- 04Koble det vellykkede outputtet og aktiver etter en fullstendig test.
Handlinger og moduser
Webhook har ett tydelig formål. Innstillingene vises når du velger noden.
Innstillinger
| Felt | Betydning | Område |
|---|---|---|
| Importformat | Konfigurer verdien i nodepanelet. | Standard |
| Importversjon | Konfigurer verdien i nodepanelet. | Standard |
| Svar til avsenderappen | Svaret bekrefter mottaket. De neste trinnene fortsetter etterpå. | Standard |
| Svartekst | Konfigurer verdien i nodepanelet. | Standard |
| Hvilke felter sender webhooken din? | Eksempler: email, name, amount. Hvert felt blir sitt eget output, så du kan dra det rett over på andre noder, uten JSON-fikling. | Standard |
| Webhook-URL | Konfigurer verdien i nodepanelet. | Beskyttet |
| API-nøkkel | Genereres automatisk. Forespørsler må sende nøkkelen 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-tillegg (valgfritt) | Legges bakerst på webhook-URL-en din, f.eks. /kunde/detaljer. Skriver du /:name, kommer verdien inn på den plassen som et felt i workflowen din senere. | Standard |
| Autentisering | Anbefalt: API-nøkkel. Bytt bare hvis kalleren din bruker en annen metode. | Standard |
| Tilgangsdata fra workflow-secret | Velg et workflow-secret med passordet, header-verdien eller JWT-signeringsnøkkelen. Bare secret-navnet lagres i workflowen. | Beskyttet |
| Brukernavn | Konfigurer verdien i nodepanelet. | Standard |
| Header-navn | Konfigurer verdien i nodepanelet. | Standard |
| Tillatte JWT-algoritmer | Kommaseparert liste over tillatte HMAC-algoritmer. Signeringsnøkkelen kommer fra workflow-secretet. | Standard |
| Svar-modus | Valg: Med en gang (200 OK), Når siste trinn er ferdig, Egen webhook-svar-blokk til slutt | Standard |
| Statuskode for svar | Konfigurer verdien i nodepanelet. | Standard |
| Svar-data | Valg: Alle oppføringer, Første oppføring (JSON), Første oppføring (fil), Ingen body | Standard |
| Hvilket felt skal returneres? | Kun når Svar-data står på "Første oppføring": oppgi feltnavnet hvis verdi returneres alene (i stedet for hele objektet). | Standard |
| Svar-format | Valg: JSON, Tekst, HTML, XML | Standard |
| Svar-headere | Konfigurer verdien i nodepanelet. | Standard |
| Tillatte nettsteder (valgfritt) | Fra hvilke nettsteder får nettleseren kalle denne webhooken? Skill flere med komma, * tillater alle. | Standard |
| Bare disse avsender-adressene (valgfritt) | Slipp bare gjennom forespørsler fra bestemte IP-adresser. Skill flere med komma, hele områder går også (f.eks. 10.0.0.0/8). Tomt = alle avsendere tillatt. | Standard |
| Ignorer bots og link-preview-crawlere | Konfigurer verdien i nodepanelet. | Standard |
| Send innholdet uendret videre | På når bodyen ikke er JSON (f.eks. ren tekst eller XML), da blir den ikke delt opp, men sendt videre rått. | Standard |
| Filfeltnavn (for filopplastinger) | Bare for fil-/binæropplastinger: Skriver du inn et navn her, havner den opplastede fila under dette feltet i workflowen din. | Standard |
| Sjekk signaturen på forespørselen | For tjenester som signerer forespørslene sine kryptografisk (f.eks. Stripe, GitHub). Slå på når avsenderen din sender med en signatur. | Standard |
| Signatur-secret | Velg workflow-secretet med den delte nøkkelen som avsenderen signerer forespørselen med. | Beskyttet |
| Navn på signatur-headeren | I hvilken HTTP-header avsenderen din sender signaturen. Standard er X-Signature, endre bare hvis tjenesten din bruker et annet navn. | Standard |
| Signatur-metode | Hvilken metode avsenderen din bruker til å signere (står i deres webhook-dokumentasjon). I tvil: SHA-256. | Standard |
Input og output
| Input | Betydning | Type |
|---|---|---|
| Standard | Denne utløseren trenger ingen input. | JSON |
| Output | Betydning | Type |
|---|---|---|
| body | Den parsede JSON-bodyen i forespørselen. | json |
| headers | Alle HTTP-headere. | json |
| query | Query-parametere (?foo=bar). | json |
| params | Sti-parametere fra /:userId/details. | json |
| method | HTTP-metoden i forespørselen. | text |
Eksempel og testkjøring
Eksempel-body: start med et lite og gjenkjennelig datasett. Kontroller outputtet og bruk bare felt som faktisk finnes.
Eksempel på testkjøring
{
"event": "signup",
"user": {
"id": "usr_abc123",
"email": "max.mustermann@example.com",
"name": "Max Mustermann"
},
"source": "landing-page"
}Tilgang og sikkerhet
Før aktivering bør du kontrollere hvilke data som går inn i trinnet og hva outputtet inneholder.
Lagre nøkler og påloggingsdata i den beskyttede tilkoblingsadministrasjonen. Ikke lim dem inn i vanlige felt, testdata eller beskrivelser.
Løs vanlige feil
- Ingen output: kontroller siste kjøring og feltene fra forrige node.
- Tom variabel: åpne outputtet fra forrige trinn og bruk et felt fra de faktiske testdataene.
- Workflowen starter ikke: aktiver den og kontroller utløserens modus.