Webhooks i Shoporama

Webhooks gör det möjligt för 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 order 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 ett automatiskt meddelande 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 några nya beställningar?", Berättar Shoporama det automatiskt.

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

Med webhooks: Shoporama meddelar dig direkt när det finns en ny order. Det är snabbt och körs 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 punkter.

Orderhändelser

Händelser för produkt och kategori

Kund- och nyhetsbrevshändelser

Checkout-händelser (kundens väg genom kassan)

Skapa en webhook

1. Gå till Inställningar (kugghjulet)
2. Klicka på de tre prickarna 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 som du vill lyssna på (du kan välja flera)
6. Klicka på Spara

Du kan också skicka en testhändelse med test.ping-händelsen direkt från loggsidan för att kontrollera att mottagaren fungerar.

Format för webhookens nyttolast

När en händelse utlöses skickar Shoporama en HTTP POST-begäran 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 returnerar för det objektet.

HTTP-rubriker

Varje webhook-begäran innehåller dessa rubriker som du kan använda för verifiering och routing:

• Content-Type: applikation/json
• X-Webhook-Event, namnet på händelsen, t.ex. order_created
• X-Webhook-Signature, en HMACSHA-256-signatur i formatet sha256=. .. beräknad från begärans kropp och webhookens hemliga nyckel

Verifiera signatur

Om du vill vara säker på att begäran faktiskt kommer från Shoporama kan du verifiera X-Webhook-Signature-huvudet 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 bör 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ända webhooks

Typiska användningsområden för webhooks:

• Lagerintegration: skicka nya order automatiskt till lagret, t.ex. när de har betalats
• Slack/Teams-meddelande: få meddelande om nya beställningar i din kanal genom order_created
• Lagersynkronisering: uppdatera det externa systemet när lagret stängs
• CRM-synkronisering: skapa kunden i Klaviyo, ActiveCampaign eller ditt eget CRM med customer_created
• Automation: trigga arbetsflöden i Zapier, Make eller liknande

Loggar och återsändning

För varje webhook kan du visa en logg över alla leveranser (svarskoder, varaktighet, nyttolast och fel). Du kan filtrera efter händelsetyp, status och datum. Misslyckade leveranser kan skickas om manuellt med ett klick. Loggar rensas kontinuerligt automatiskt.

Vanliga frågor och svar

Var hittar jag listan över webhooks?

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

Hur snabbt dyker webhooken upp?

Webhooks köas och skickas vanligtvis ut inom några sekunder. Vid rusningstid kan det förekomma en liten fördröjning, men aldrig mer än en minut eller två.

Finns det en "order_sent"-händelse?

Nej, det finns det inte. 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 punkter eller understreck?

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

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

Ja, det kan du. Välj helt enkelt flera händelser när du skapar eller redigerar webhooken. Använd X-Webhook-Event-headern eller event-fältet i payloaden i din mottagare för att skilja dem åt.

Vad händer om min server är nere?

Leveransen loggas som misslyckad. Du kan skicka om den manuellt från loggsidan när din server är uppe igen. Vi försöker inte automatiskt igen, så utforma din mottagare så att den kan tolerera att en webhook ibland kommer senare än väntat, eller hämta saknade ordrar via REST API som en säkerhetskopia.

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

Verifiera X-Webhook-Signature-huvudet med din webhooks hemliga nyckel. Det kommer att visas på din webhook i Shoporama-administratören. Jämför med en HMAC SHA-256 över den mottagna kroppen. Om du inte matchar avvisar du begäran.

Kan jag använda webhooks med REST API?

Ja, och det är ofta en bra idé. Använd webhooks för att få meddelanden och använd REST API 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 hård gräns i Shoporama. Skapa så många du behöver, men städa upp webhooks som inte längre används för att undvika onödig trafik till nedlagda webbadresser.

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