Entrii Hjelpesenter
NB EN

Slik setter du opp en webhook-mal

Steg-for-steg guide for å opprette webhook-maler i Entrii — HTTP-kall med JSON-payload, flettefelt, integrasjonsautentisering og testkall.

Webhook-maler sender et HTTP-kall til et eksternt system når en hendelse inntreffer i Entrii — for eksempel når en bestilling når en gitt status. Du definerer URL, metode og JSON-body med flettefelt, og Entrii sender den oppløste payloaden til mottakeren.

Når bruker du webhook-maler?

  • Koble Entrii til automasjonsverktøy som Make, Zapier eller egne API-er når en bestilling oppdateres.

  • Sende strukturert JSON med bestillingsdata til et internt system eller partner.

  • Utløse tilpassede integrasjoner levert som plugins med ferdige webhook-presets.

Webhook vs. e-post og SMS

E-post og SMS er meldinger til mennesker. En webhook-mal sender data til en HTTP-endepunkt — innholdet er JSON, ikke tekst til kunde. Du konfigurerer URL, HTTP-metode, headere og JSON-body i stedet for emne og meldingstekst.

Steg av 6

    • Mottaker-URL (webhook-endepunkt) fra det eksterne systemet

    • Eventuell API-nøkkel eller autentisering — enten som header på malen eller via en Entrii-integrasjon

    • Tilgang til Entrii backoffice med rettigheter til Maler

    Du har gått gjennom alle steg

  2. Du kan opprette webhook-malen manuelt eller fra et webhook-preset levert av en installert plugin:

    1. Gå til Maler → Meldingsmaler.

    2. For preset: klikk Opprett fra webhook-preset, velg preset (f.eks. fra Make-plugin) og gi malen et navn. JSON-body og kategori forhåndsutfylles — du setter URL på neste steg.

    3. For manuell opprettelse: klikk Opprett, velg type Webhook og kategori (Bestilling er vanligst). Lagre og gå til redigering.

    Du har gått gjennom alle steg

    1. Angi Webhook-URL — full adresse inkludert eventuelle spørreparametre API-et krever.

    2. Velg HTTP-metode (vanligvis POST). Ved GET sendes ikke JSON-body til URL-en, men forhåndsvisningen viser likevel den oppløste payloaden.

    3. Valgfritt: velg Integrasjon (for autentisering) når pluginen støtter utgående webhook-auth. Headere fra malen slås sammen med integrasjonens og overstyrer like navn.

    4. Legg til HTTP-headere ved behov (f.eks. Authorization). Ikke legg hemmeligheter i maler som deles bredt i organisasjonen.

    5. Rediger JSON-body med flettefelt i verdier, f.eks. {{ order.order_number }}. Bruk Flettefelt (ordliste) for å finne tilgjengelige tags for valgt kategori.

    Du har gått gjennom alle steg

    • Velg en eksempelbestilling for forhåndsvisning når kategorien er Bestilling.

    • Sjekk Resolvér JSON (som sendes) i forhåndsvisningspanelet — her ser du payloaden etter at flettefelt er erstattet.

    • Klikk Send testkall for å sende et reelt HTTP-kall til endepunktet. Resultatet viser status, sendt payload og svar fra mottakeren.

    Du har gått gjennom alle steg

    • Åpne relevant bestillingsstatus under Bestillingsstatuser.

    • Legg til malen under fanen Meldingsmaler.

    • Velg salgskanal (global eller spesifikk) og sorteringsrekkefølge.

    Du har gått gjennom alle steg

    • Bekreft at malen er aktiv og at koblingen under bestillingsstatusen er korrekt.

    • Utfør en testbestilling som utløser statusen, og verifiser at mottakersystemet får forventet JSON.

    • Sjekk dokumentasjon fra preset (hvis brukt) for eventuelle ekstra krav til URL eller payload.

    Du har gått gjennom alle steg

Tips for JSON-payload

  • Body må være et gyldig JSON-objekt eller -liste — ikke ren tekst.

  • Flettefelt kan stå i strengverdier, f.eks. "orderNumber": "{{ order.order_number }}".

  • JSON-body er ikke språkversjonert — én payload-struktur for alle språk.

  • Ved feil HTTP-status fra mottaker logges feilen — bruk testkall for å feilsøke før produksjon.

Relaterte artikler

Introduksjon til maler

Oversikt over maltyper i Entrii — meldingsmaler, dokumentmaler, billettmaler og bibliotek — og hvordan du kommer i gang

Slik bruker du merge-tags/makroer i meldingsmaler

Oversikt over flettefelt i meldingsmaler — per kategori og undergruppe (ticket, order, brand osv.).

Slik lager du en e-postmal

Steg-for-steg guide for å opprette e-postmaler i Entrii — inkludert intern e-postmelding og forskjellen på kunde- og int