> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhooks

> Send hendelser om sendinger, ordrer og sporing fra Zippendo til ditt eget system - navn, endpoint-URL, hendelser, leveringslogg, testmelding, redigering, sletting og kontroll av signatur.

**Webhooks** lar ditt eget system vite med en gang noe skjer i Zippendo: en sending opprettes eller sendes, en ordre endres, eller en pakke får en ny sporingshendelse. Zippendo sender en melding til en adresse (URL) på serveren din. Du setter dem opp under **Webhooks** i Innstillinger. Mottakersiden bygges vanligvis av en utvikler.

Dette er ikke de andre typene webhooks du kan møte i Zippendo:

| Type | Hvor | Retning |
| - | - | - |
| **Webhooks** (denne siden) | Innstillinger → **Webhooks** | Zippendo → serveren din |
| Sporings-webhooks fra transportører | På en transportør | Transportør → Zippendo. Se [Sporings-webhooks fra transportører](/docs/no/how-to/tracking-webhooks). |
| Ordre-webhooks fra Shopify | På en Shopify-ordrekanal | Shopify → Zippendo. Zippendo setter dem opp. Se [Shopify-innstillinger](/docs/no/how-to/shopify-settings). |
| Ordre-webhooks fra WooCommerce | På en WooCommerce-ordrekanal | WooCommerce → Zippendo. Se [Koble til WooCommerce](/docs/no/how-to/connect-woocommerce). |
| Ordrer fra egendefinert kanal | På en egendefinert ordrekanal | Ditt system → Zippendo. Se [API for egendefinert kanal](/docs/no/how-to/custom-channel-api). |

For å sende hendelser til Slack, Klaviyo og lignende apper uten å bygge noe, bruk [Koble til Slack, Klaviyo og andre apper](/docs/no/how-to/connect-an-integration) i stedet.

Omvisning i Innstillinger: [Innstillinger, team og merkevarer](/docs/no/tutorials/settings-team-brands). Hva hver melding inneholder: [Kom i gang med webhooks](/docs/no/quickstarts/webhooks). Meldinger som ikke kommer frem: [Webhook-leveringer feiler](/docs/no/knowledge-base/webhook-delivery-failures).

<Info>
  Webhooks er inkludert i alle planer: Free opptil 5 webhooks, Standard opptil 10, Growth opptil 25, Pro opptil 100, Enterprise ubegrenset.
</Info>

## Hvor du finner det

Åpne organisasjonsmenyen nederst i sidemenyen, klikk **Administrer**, deretter fanen **Webhooks**. Knappen for å opprette en er **Legg til webhook** øverst til høyre.

<Frame caption="Listen Webhooks: navn, URL, hendelser, status og handlinger">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/01-webhooks-list-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=7a119ab12381b3e39093e23fa184fda4" alt="Fanen Webhooks i Innstillinger med én webhook i listen og Legg til webhook i toppen" className="block dark:hidden" width="2880" height="1800" data-path="images/no/how-to/webhooks/01-webhooks-list-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/01-webhooks-list-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=d2aae5e0c60138878b223403d0184a19" alt="Fanen Webhooks i Innstillinger med én webhook i listen og Legg til webhook i toppen" className="hidden dark:block" width="2880" height="1800" data-path="images/no/how-to/webhooks/01-webhooks-list-dark.png" />
</Frame>

## Listen Webhooks

| Kolonne | Hva den viser |
| - | - |
| **Navn** | Navnet du skrev inn. |
| **Merkevare** | Merkevaren til webhooken, eller tom hvis den gjelder hele organisasjonen. Vises bare hvis organisasjonen din har merkevarer. |
| **URL** | Adressen Zippendo sender til. |
| **Hendelser** | De to første hendelsene den sender, for eksempel **Sending opprettet**. Resten er skjult. |
| **Status** | **Aktiv** eller **Inaktiv**. |
| **Opprettet** | Når den ble opprettet. |

Hver rad har **Leveringslogg**, **Send test**, **Rediger** og **Slett**. Å klikke på raden åpner **Rediger webhook**.

For å finne en webhook klikker du **Filtre** over listen. Du kan søke etter navn, velge **Aktiv** (**Ja** eller **Nei**) og, hvis du har merkevarer, en **Merkevare**. Klikk **Legg til filtre** for å bruke dem. Mer om lister: [Søk og filtre](/docs/no/how-to/search-and-filters).

Uten webhooks viser listen **Ingen webhooks** og en knapp **Opprett din første webhook**.

## Opprett en webhook

<Steps>
  <Step title="Åpne vinduet">
    Klikk **Legg til webhook**, eller **Opprett din første webhook** når listen er tom. Vinduet **Opprett webhook** åpnes.
  </Step>

  <Step title="Navn og adresse">
    Fyll ut **Navn \*** og **Endpoint URL \***. Bruk en adresse som starter med `https://`.
  </Step>

  <Step title="Velg hendelsene">
    Kryss av for hendelsene du vil ha, eller klikk **Velg alle**. Kryss av for **Sporing oppdatert** hvis systemet ditt trenger hver sporingsskanning.
  </Step>

  <Step title="Opprett den">
    Klikk **Opprett webhook**. Du ser **Webhooken er opprettet**.
  </Step>
</Steps>

<Frame caption="Opprett webhook: Navn, Endpoint URL og hendelsene">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/02-create-webhook-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=3d959344c6610e0f4afb5c1adcbcb3dd" alt="Vinduet Opprett webhook med Navn, Endpoint URL, Velg alle og avkrysningsboksene for sendingshendelser" className="block dark:hidden" width="2880" height="2800" data-path="images/no/how-to/webhooks/02-create-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/02-create-webhook-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=fb393faae9f7a567782e7eb2c394adaa" alt="Vinduet Opprett webhook med Navn, Endpoint URL, Velg alle og avkrysningsboksene for sendingshendelser" className="hidden dark:block" width="2880" height="2800" data-path="images/no/how-to/webhooks/02-create-webhook-dark.png" />
</Frame>

| Felt | Påkrevd | Hva du skriver inn |
| - | - | - |
| **Navn \*** | Ja | Et navn du kjenner igjen, for eksempel «Ordrevarsler». Opptil 100 tegn. |
| **Endpoint URL \*** | Ja | Den fullstendige adressen på serveren din, for eksempel `https://example.com/webhooks`. |
| **Merkevare** | Nei | Vises bare hvis organisasjonen din har merkevarer. Velg en merkevare, og **Denne webhooken mottar bare hendelser fra denne merkevaren.** Standardvalget, **Ingen merkevare (hele organisasjonen)**, mottar hendelsene fra alle merkevarer. |
| **Hendelser \*** | Ja, minst én | Hendelsene som skal sendes. Se listen nedenfor. |

**Opprett webhook** er grået ut til du har fylt ut navnet, adressen og minst én hendelse. Hvis opprettingen feiler med **Du har nådd grensen i planen din. Oppgrader planen eller fjern noe du ikke bruker lenger.**, slett en webhook du ikke bruker lenger, eller oppgrader planen din.

### Hendelsene

Det finnes ni hendelser, i tre grupper. Det tekniske navnet i den andre kolonnen er det systemet ditt mottar.

<Frame caption="Velg alle krysser av for alle hendelser, inkludert Sporing oppdatert">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/03-events-tracking-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=c9398001d27c077a0ce23b1d67674283" alt="Vinduet Opprett webhook med alle ni hendelser avkrysset, inkludert Sporing oppdatert" className="block dark:hidden" width="2880" height="2800" data-path="images/no/how-to/webhooks/03-events-tracking-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/03-events-tracking-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=cfaea3c94d551ce107b10963294c497c" alt="Vinduet Opprett webhook med alle ni hendelser avkrysset, inkludert Sporing oppdatert" className="hidden dark:block" width="2880" height="2800" data-path="images/no/how-to/webhooks/03-events-tracking-dark.png" />
</Frame>

| Hendelse | Navnet systemet ditt mottar | Sendes når |
| - | - | - |
| **Sending opprettet** | `shipment.created` | En sending opprettes. |
| **Sending oppdatert** | `shipment.updated` | En sending endres. |
| **Sending sendt** | `shipment.dispatched` | En sending sendes og har fått fraktetiketten sin. |
| **Sending kansellert** | `shipment.cancelled` | En sending slettes. |
| **Feil på sending** | `shipment.error` | Sending av en sending til transportøren feiler. |
| **Ordre opprettet** | `order.created` | En ordre opprettes gjennom API-et. |
| **Ordre oppdatert** | `order.updated` | En ordre endres i Zippendo eller gjennom API-et. |
| **Ordre kansellert** | `order.cancelled` | En ordre slettes i Zippendo eller gjennom API-et. |
| **Sporing oppdatert** | `tracking.updated` | En pakke får en ny sporingshendelse. |

Ordrer som kommer inn fra en tilkoblet nettbutikk, og endringene nettbutikken sender senere, sender ikke ordrehendelser. Systemet ditt får likevel høre om dem gjennom sendingshendelsene: Zippendo oppretter en sending for hver ordre det importerer.

**Send test** sender en testmelding som heter `webhook.test`. Du kan ikke krysse av for den som en hendelse.

## Rediger eller sett en webhook på pause

Klikk på raden, eller **Rediger**, for å åpne **Rediger webhook**. Den har de samme feltene som **Opprett webhook**, pluss **Aktiv**. Klikk **Lagre endringer** når du er ferdig.

<Frame caption="Rediger webhook: de samme feltene, pluss Aktiv">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/04-edit-webhook-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=e17b4e4439c16be0963c25ac5a631dcc" alt="Vinduet Rediger webhook med Navn, Endpoint URL, en avkrysningsboks Aktiv og hendelsene" className="block dark:hidden" width="2880" height="1800" data-path="images/no/how-to/webhooks/04-edit-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/04-edit-webhook-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=8a02b86a186306461074d9b5fb378bcc" alt="Vinduet Rediger webhook med Navn, Endpoint URL, en avkrysningsboks Aktiv og hendelsene" className="hidden dark:block" width="2880" height="1800" data-path="images/no/how-to/webhooks/04-edit-webhook-dark.png" />
</Frame>

Fjern avkrysningen for **Aktiv** for å slutte å sende uten å slette webhooken eller **Leveringslogg**. Kolonnen **Status** viser da **Inaktiv**. Kryss av igjen for å begynne å sende.

## Leveringslogg

**Leveringslogg** på en rad viser de siste forsøkene på å levere til den adressen.

<Frame caption="Leveringslogg: hendelse, status, varighet, forsøk, feil og tid">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/05-delivery-log-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=8737c7eba8106998958497676b101a78" alt="Leveringslogg med hendelsesnavn, svarstatus, varighet, forsøk og tid" className="block dark:hidden" width="2880" height="1800" data-path="images/no/how-to/webhooks/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/05-delivery-log-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=e4023f135fdda0e301c7bf9946823d38" alt="Leveringslogg med hendelsesnavn, svarstatus, varighet, forsøk og tid" className="hidden dark:block" width="2880" height="1800" data-path="images/no/how-to/webhooks/05-delivery-log-dark.png" />
</Frame>

| Kolonne | Hva den viser |
| - | - |
| **Hendelse** | Hendelsen som ble sendt, for eksempel `shipment.created` eller `webhook.test`. |
| **Status** | Statuskoden serveren din svarte med, grønn for suksess og rød for feil, eller **Ikke tilgjengelig** hvis det ikke kom noe svar. |
| **Varighet** | Hvor lang tid serveren din brukte på å svare. |
| **Forsøk** | Hvilket forsøk dette var. |
| **Feil** | Hva som gikk galt, hvis noe. |
| **Tid** | Når forsøket ble gjort. |

Zippendo venter i opptil 10 sekunder på at serveren din skal svare. Hvis den ikke svarer, eller svarer med en feil, prøver Zippendo igjen, opptil 5 ganger til sammen, og venter litt lenger hver gang. Hvert forsøk er en rad i loggen.

## Send en testmelding

Klikk **Send test** på en rad. Du ser **Testhendelsen er sendt**. Testmeldingen ser slik ut:

```json theme={null}
{
  "event": "webhook.test",
  "timestamp": "2026-06-22T09:30:00.000Z",
  "data": {
    "webhookId": "cm9x2k4lq0001",
    "message": "This is a test event from Zippendo"
  }
}
```

Åpne **Leveringslogg** for å se om serveren din mottok den.

## Slett en webhook

Klikk **Slett** på en rad. **Slett webhook** ber deg skrive navnet på webhooken med store bokstaver og deretter klikke **Slett**. Webhooken og **Leveringslogg** fjernes, og du ser **Webhooken er slettet**.

<Frame caption="Slett webhook: skriv navnet med store bokstaver for å bekrefte">
  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/06-delete-webhook-light.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=16ab32c942b00f4dad731724046f1046" alt="Vinduet Slett webhook med et felt for å skrive navnet for å bekrefte" className="block dark:hidden" width="2880" height="1800" data-path="images/no/how-to/webhooks/06-delete-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/T2PzVtgxuu9jb3pz/images/no/how-to/webhooks/06-delete-webhook-dark.png?fit=max&auto=format&n=T2PzVtgxuu9jb3pz&q=85&s=163c7c6b069f54d1aecc5732cea16d03" alt="Vinduet Slett webhook med et felt for å skrive navnet for å bekrefte" className="hidden dark:block" width="2880" height="1800" data-path="images/no/how-to/webhooks/06-delete-webhook-dark.png" />
</Frame>

## For utviklere: meldingsformat og signatur

Hver melding er en `POST` med en JSON-body `{ "event", "timestamp", "brandId", "data" }` og disse headerne:

| Header | Verdi |
| - | - |
| `Content-Type` | `application/json` |
| `X-Webhook-Signature` | HMAC-SHA256 av selve innholdet, hex, med hemmeligheten til webhooken som nøkkel |
| `X-Webhook-Event` | Navnet på hendelsen |
| `X-Webhook-Id` | Én ID per levering. Hvert nytt forsøk på den samme leveringen sender den samme ID-en, så du kan bruke den til å hoppe over duplikater. |

Zippendo oppretter hemmeligheten når du oppretter webhooken. Appen viser den ikke: les den med forespørselen Get webhook i [API-referansen](/docs/api-reference/overview) (listeforespørselen utelater den). Kontroller signaturen før du leser innholdet. Et gjennomarbeidet eksempel finnes i [Kom i gang med webhooks](/docs/no/quickstarts/webhooks). Ordrer som sendes inn i en egendefinert ordrekanal, signeres på samme måte, med en `X-Zippendo-Signature`-header: [API for egendefinert kanal](/docs/no/how-to/custom-channel-api).

<Tip>
  Svar raskt med en 2xx-status og gjør arbeidet etterpå. Bruk `https://`-adresser. Webhooks som ikke er **Aktiv**, mottar ingenting.
</Tip>

## Relatert

* [Opprett et API-token](/docs/no/how-to/create-an-api-token): systemet ditt spør Zippendo, i stedet for at Zippendo forteller systemet ditt.
* [Sporings-webhooks fra transportører](/docs/no/how-to/tracking-webhooks): transportører som sender sporing til Zippendo.
* [Koble til Slack, Klaviyo og andre apper](/docs/no/how-to/connect-an-integration): ingen egen server nødvendig.
* [Shopify-innstillinger](/docs/no/how-to/shopify-settings) / [Koble til WooCommerce](/docs/no/how-to/connect-woocommerce): webhookene for nettbutikken som Zippendo setter opp for deg.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.