Webhooks i Shoporama

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

Hva er webhooks?

En webhook er et automatisk varsel som Shoporama sender til en URL du spesifiserer når en bestemt hendelse inntreffer. Tenk på det som et "omvendt API". I stedet for at du spør Shoporama "er det noen nye bestillinger?", forteller Shoporama deg det automatisk.

Uten webhooks: Tjenesten din spør Shoporama hvert 5. minutt: "Er det noen nye bestillinger?". Dette er ineffektivt og forårsaker unødvendig belastning.

Med webhooks: Shoporama varsler deg umiddelbart når det er en ny bestilling. Det er raskt og kjører i sanntid.

Tilgjengelige webhook-hendelser

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

Bestillingshendelser

Produkt- og kategorihendelser

Kunde- og nyhetsbrevhendelser

Checkout-hendelser (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-adressen som skal motta webhook-data
5. Velg hendelsene du vil lytte til (du kan velge flere)
6. Klikk på Lagre

Du kan også sende en testhendelse med test.ping-hendelsen direkte fra loggsiden for å sjekke at mottakeren fungerer.

Format for webhook-nyttelasten

Når en hendelse utløses, sender Shoporama en HTTP POST-forespørsel til URL-adressen din 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 datafeltet varierer avhengig av hendelsen. For ordrehendelser får du informasjon om ordren, for produkthendelser får du informasjon om produktet og så videre. Dataobjektet tilsvarer det som REST API returnerer for det aktuelle objektet.

HTTP-overskrifter

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 HMACSHA-256-signatur i formatet sha256=... beregnet ut fra forespørselsteksten og den hemmelige nøkkelen til webhooken

Verifiser signaturen

Hvis du vil være sikker på at forespørselen faktisk kommer fra Shoporama, kan du verifisere X-Webhook-Signature-overskriften med den hemmelige nøkkelen du kan se på webhooken din i Shoporama-administrator. 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 din

Mottakerens tjeneste bør 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.

Bruke webhooks

Typisk bruk av webhooks:

• Lagerintegrasjon: Send nye bestillinger automatisk til lageret, f.eks. når de er betalt
• Slack/Teams-varsling: bli varslet om nye bestillinger i kanalen din via order_created
• Lagersynkronisering: oppdater eksternt system når lageret fyres
• CRM-synkronisering: opprett kunden i Klaviyo, ActiveCampaign eller ditt eget CRM med customer_created
• Automatisering: utløs arbeidsflyter i Zapier, Make eller lignende

Logger og videresending

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 tømmes automatisk og kontinuerlig.

Ofte stilte spørsmål

Hvor finner jeg listen over webhooks?

Klikk på tannhjulet i Shoporama-administratoren og gå til Webhooks via de tre punktene. Du kan også lese veiledningen vår om hvordan du ser opprettede webhooks i butikken din.

Hvor raskt vises webhooken?

Webhooks settes i kø og sendes vanligvis ut i løpet av noen få sekunder. I rushtider kan det være en liten forsinkelse, men aldri mer enn ett minutt eller to.

Finnes det en "order_sent"-hendelse?

Nei, det gjør det ikke. Det finnes ingen separat hendelse for "sendt". Når du markerer en ordre som sendt, utløses new_status med den nye statusen i nyttelasten. Lytt til den hendelsen, og sjekk data.status hvis du vil reagere på statusendringer.

Skal hendelser skrives med punktum eller understrek?

Understrek. 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, det kan du. Bare velg flere hendelser når du oppretter eller redigerer webhooken. Bruk X-Webhook-Event-overskriften eller hendelsesfeltet i nyttelasten i mottakeren 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å design mottakeren din slik at den tåler at en og annen webhook kommer senere enn forventet, eller hent manglende bestillinger via REST API som en sikkerhetskopi.

Hvordan vet jeg at det faktisk er Shoporama som ringer?

Bekreft X-Webhook-Signature-overskriften med webhookens hemmelige nøkkel. Den vises på webhooken i Shoporama-administratoren. Sammenlign med en HMAC SHA-256 over den mottatte brødteksten. Hvis du ikke finner samsvar, avviser du forespørselen.

Kan jeg bruke webhooks med REST API?

Ja, og det er ofte en god idé. Bruk webhooks for å bli varslet, og bruk REST API 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 for å unngå unødvendig trafikk til nedlagte nettadresser.

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