Webhooks i Shoporama

Med webhooks kan du få Shoporama att automatiskt skicka ett meddelande till en extern tjänst när något händer i din butik. Till exempel när en ny beställning skapas, när en produkt uppdateras eller när en kund loggar in för första gången. Här går vi igenom vad webhooks är, vilka händelser du kan lyssna på och hur du skapar dem.

Vad är webhooks?

En webhook är en automatisk notis som Shoporama skickar till en URL som du anger när en viss händelse inträffar. Tänk på det som ett ”omvänt API”. Istället för att du frågar Shoporama ”finns det nya beställningar?”, meddelar Shoporama dig det automatiskt.

Utan webhooks: Din tjänst frågar Shoporama var 5:e minut: "Finns det nya beställningar?". Det är ineffektivt och skapar onödig belastning.

Med webhooks: Shoporama skickar ett meddelande till dig omedelbart när det finns en ny beställning. Det är snabbt och sker i realtid.

Tillgängliga webhook-händelser

Du kan ställa in webhooks för följande händelser. Observera att händelsenamnen använder understreck (order_created), inte punkt.

Orderhändelser

Produkt- och kategorievenemang

Kund- och nyhetsbrevshändelser

Kassahändelser (kundens väg genom kassan)

Skapa en webhook

1. Gå till Inställningar (kugghjulet)
2. Klicka på de tre punkterna och välj Webhooks
3. Klicka på "Skapa ny webhook"
4. Ange den URL som ska ta emot webhook-data
5. Välj de händelser du vill lyssna på (du kan välja flera)
6. Klicka på Spara

Du kan också skicka en testhändelse med händelsen test.ping direkt från loggsidan, så att du kan kontrollera att din mottagare fungerar.

Format på webhook-payload

När en händelse utlöses skickar Shoporama en HTTP POST-förfrågan till din URL med data i JSON-format. Alla webhooks har samma 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
  }
}

Innehållet i datafältet varierar beroende på händelsen. För orderhändelser får du information om ordern, för produkthändelser information om produkten och så vidare. Dataobjektet motsvarar det som REST API:et returnerar för det aktuella objektet.

HTTP-rubriker

Varje webhook-förfrågan innehåller dessa rubriker som du kan använda för verifiering och vidarebefordran:

• Content-Type: application/json
• X-Webhook-Event, namnet på händelsen, t.ex. order_created
• X-Webhook-Signature, en HMAC SHA-256-signatur i formatet sha256=... beräknad utifrån begäran-kroppen och webhookens hemliga nyckel

Verifiera signaturen

Om du vill vara säker på att förfrågan faktiskt kommer från Shoporama, verifiera X-Webhook-Signature-rubriken med den hemliga nyckeln som du kan se på din webhook i Shoporama-admin. Exempel 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 från din mottagare

Din mottagande tjänst måste svara med HTTP-status 2xx (vanligtvis 200) för att bekräfta mottagandet. Andra statuskoder loggas som fel, och du kan skicka om misslyckade leveranser från loggsidan.

Användning av webhooks

Vanliga användningsområden för webhooks:

• Lagerhotellintegration: skicka nya order automatiskt till lagerhotellet, t.ex. vid betald
• Slack/Teams-notifikation: få besked om nya order i din kanal vid order_created
• Lagersynkronisering: uppdatera externt system när lagret är slut
• CRM-synkronisering: skapa kunden i Klaviyo, ActiveCampaign eller eget CRM vid customer_created
• Automatisering: utlös arbetsflöden i Zapier, Make eller liknande

Loggar och omsändning

För varje webhook kan du se en logg över alla leveranser (svarskoder, varaktighet, payload och fel). Du kan filtrera på händelsetyp, status och datum. Misslyckade leveranser kan skickas om manuellt med ett klick. Loggar rensas löpande automatiskt.

Vanliga frågor

Var hittar jag webhook-listan?

Klicka på kugghjulet i din Shoporama-admin och gå till Webhooks via de tre punkterna. Du kan också läsa vår guide för att se skapade webhooks i din butik.

Hur snabbt kommer webhooken fram?

Webhooks läggs i en kö och skickas vanligtvis inom några sekunder. Vid hög belastning kan det förekomma en viss fördröjning, men aldrig mer än en minut eller två.

Finns det en "order_sent"-händelse?

Nej. Det finns ingen separat händelse för "skickad". När du markerar en order som skickad utlöses new_status med den nya statusen i payloaden. Lyssna på den händelsen och kontrollera data.status om du vill reagera på statusändringar.

Ska händelser skrivas med punkt eller understreck?

Understreck. Korrekt: order_created. Felaktigt: order.created. Den enda händelsen med punkt är test.ping, som används för testleveranser.

Kan jag lyssna på flera händelser i samma webhook?

Ja. Välj bara flera händelser när du skapar eller redigerar webhooken. Använd X-Webhook-Event-rubriken eller händelsefältet i nyttolasten i din mottagare för att skilja dem åt.

Vad händer om min server är nere?

Leveransen loggas som misslyckad. Du kan skicka den igen manuellt från loggsidan när din server är igång igen. Vi gör inga automatiska omförsök, så utforma din mottagare så att den tål att en webhook ibland anländer senare än väntat, eller hämta saknade order via REST API:et som backup.

Hur vet jag att det verkligen är Shoporama som ringer?

Verifiera X-Webhook-Signature-rubriken med din webhooks hemliga nyckel. Den visas på din webhook i Shoporama-admin. Jämför med en HMAC SHA-256 över den mottagna kroppen. Om de inte stämmer överens, avvisa begäran.

Kan jag använda webhooks tillsammans med REST API:et?

Ja, och det är ofta en bra idé. Använd webhooks för att få meddelanden och använd REST API:et för att hämta fullständiga data eller utföra åtgärder baserat på händelsen.

Hur många webhooks kan jag skapa?

Det finns ingen fast gräns i Shoporama. Skapa så många du behöver, men rensa bort webhooks som inte längre används så att du undviker onödig trafik mot nedlagda URL:er.

Behöver du hjälp? Kontakta oss på support@shoporama.dk.