Webhooks i Shoporama

Webhooks gir deg muligheten til å få Shoporama til automatisk å sende en melding til en ekstern tjeneste når det skjer noe i nettbutikken din. For eksempel når en ny ordre opprettes, når et produkt oppdateres eller når en kunde logger seg inn for første gang. Her går vi gjennom hva webhooks er, hvilke hendelser du kan lytte på, og hvordan du oppretter dem.

Hva er webhooks?

En webhook er en automatisk melding som Shoporama sender til en URL du angir når en bestemt hendelse skjer. Tenk på det som en «omvendt API». I stedet for at du spør Shoporama «er det nye bestillinger?», forteller Shoporama deg det automatisk.

Uten webhooks: Tjenesten din spør Shoporama hvert 5. minutt: «Er det nye bestillinger?». Det er ineffektivt og gir unødvendig belastning.

Med webhooks: Shoporama sender deg en melding umiddelbart når det er en ny ordre. Det er raskt og skjer i sanntid.

Tilgjengelige webhook-hendelser

Du kan sette opp webhooks for følgende hendelser. Merk at hendelsesnavnene bruker understreker (order_created), ikke punktum.

Ordre-hendelser

Produkt- og kategori-hendelser

Kunde- og nyhetsbrev-hendelser

Kassehendelser (kundens vei gjennom kassen)

Opprett en webhook

1. Gå til Innstillinger (tannhjulet)
2. Klikk på de tre prikkene og velg Webhooks
3. Klikk på «Opprett ny webhook»
4. Angi URL-en som skal motta webhook-data
5. Velg hendelsene du vil lytte på (du kan velge flere)
6. Klikk på Lagre

Du kan også sende en testhendelse med hendelsen test.ping direkte fra loggsiden, slik at du kan sjekke at mottakeren din fungerer.

Format på webhook-payload

Når en hendelse utløses, sender Shoporama en HTTP POST-forespørsel til din URL med data i JSON-format. Alle webhooks har samme struktur:

{
  "event": "order_created",
  "action": "create",
  "timestamp": "2026-05-01T10:30:00+02:00",
  "webshop_id": 1234,
  "data": {
    "order_id": 56789,
    "order_no": 1042,
    "email": "kunde@eksempel.dk",
    "total": 549.50
  }
}

Innholdet i data-feltet varierer avhengig av hendelsen. For ordre-hendelser får du informasjon om ordren, for produkt-hendelser informasjon om produktet og så videre. Dataobjektet tilsvarer det REST API-et returnerer for det aktuelle objektet.

HTTP-headere

Hver webhook-forespørsel inneholder disse overskriftene, som du kan bruke til verifisering og ruting:

• Content-Type: application/json
• X-Webhook-Event, navnet på hendelsen, f.eks. order_created
• X-Webhook-Signature, en HMAC SHA-256-signatur i formatet sha256=... beregnet ut fra forespørselsteksten og webhookens hemmelige nøkkel

Verifiser signaturen

Hvis du vil være sikker på at forespørselen faktisk kommer fra Shoporama, må du verifisere X-Webhook-Signature-headeren med den hemmelige nøkkelen du finner i webhooken din i Shoporama-admin. Eksempel i PHP:

$payload = file_get_contents('php://input');
$expected = 'sha256=' . hash_hmac('sha256', $payload, $secret);
if (!hash_equals($expected, $_SERVER['HTTP_X_WEBHOOK_SIGNATURE'])) {
    http_response_code(401);
    exit;
}

Svar fra mottakeren

Mottakertjenesten din må svare med HTTP-status 2xx (vanligvis 200) for å bekrefte mottakelsen. Andre statuskoder logges som feil, og du kan sende mislykkede leveranser på nytt fra loggsiden.

Bruk av webhooks

Typiske bruksområder for webhooks:

• Lagerhotel-integrasjon: send nye ordrer automatisk til lagerhotellet, f.eks. ved betalt
• Slack/Teams-varsling: få beskjed om nye ordrer i kanalen din ved order_created
• Lagersynkronisering: oppdater eksternt system når lagerbeholdningen endres
• CRM-synkronisering: opprett kunden i Klaviyo, ActiveCampaign eller eget CRM ved customer_created
• Automatisering: utløs arbeidsflyter i Zapier, Make eller lignende

Logg og resending

For hver webhook kan du se en logg over alle leveranser (svarkoder, varighet, nyttelast og feil). Du kan filtrere etter hendelsestype, status og dato. Mislykkede leveranser kan sendes på nytt manuelt med ett klikk. Loggene ryddes løpende automatisk.

Ofte stilte spørsmål

Hvor finner jeg listen over webhooks?

Klikk på tannhjulet i Shoporama-administrasjonen din, og gå til Webhooks via de tre prikkene. Du kan også lese vår guide for å se opprettede webhooks i butikken din.

Hvor raskt kommer webhooken frem?

Webhooks legges i en kø og sendes vanligvis ut i løpet av få sekunder. Ved stor belastning kan det oppstå en liten forsinkelse, men aldri mer enn et minutt eller to.

Er det en «order_sent»-hendelse?

Nei. Det finnes ikke en egen hendelse for «sendt». Når du merker en ordre som sendt, utløses new_status med den nye statusen i nyttelasten. Lytt etter den hendelsen og sjekk data.status hvis du vil reagere på statusendringer.

Skal hendelser skrives med punktum eller understrek?

Understreker. Riktig: order_created. Feil: order.created. Den eneste hendelsen med punktum er test.ping, som brukes til testleveranser.

Kan jeg lytte til flere hendelser i samme webhook?

Ja. Bare velg flere hendelser når du oppretter eller redigerer webhooken. Bruk X-Webhook-Event-headeren eller event-feltet i nyttelasten i mottakeren din for å skille dem fra hverandre.

Hva skjer hvis serveren min er nede?

Leveransen logges som mislykket. Du kan sende den på nytt manuelt fra loggsiden når serveren din er oppe igjen. Vi prøver ikke automatisk på nytt, så utform mottakeren din slik at den tåler at en webhook av og til ankommer senere enn forventet, eller hent manglende bestillinger via REST API-et som backup.

Hvordan vet jeg at det faktisk er Shoporama som ringer?

Verifiser X-Webhook-Signature-headeren med din webhooks hemmelige nøkkel. Den vises på din webhook i Shoporama-admin. Sammenlign med en HMAC SHA-256 over den mottatte body. Hvis det ikke stemmer, avvis forespørselen.

Kan jeg bruke webhooks sammen med REST API-et?

Ja, og det er ofte en god idé. Bruk webhooks for å få varsel, og bruk REST API-et for å hente fullstendige data eller utføre handlinger basert på hendelsen.

Hvor mange webhooks kan jeg opprette?

Det er ingen fast grense i Shoporama. Opprett så mange du trenger, men rydd opp i webhooks som ikke lenger brukes, slik at du unngår unødvendig trafikk mot nedlagte URL-er.

Trenger du hjelp? Kontakt oss på support@shoporama.dk.