Webhooks i Shoporama
Guide för att ställa in webhooks i Shoporama som skickar data till externa system vid vissa händelser.
Med webhooks kan du låta Shoporama 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. Här går vi igenom vad webhooks är och hur du ställer in 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?" (onödig belastning)
Med webhooks: Shoporama meddelar dig omedelbart när det finns en ny order (effektivt och i realtid)
Tillgängliga webhook-händelser
Du kan ställa in webhooks för följande händelser:
| Händelse | Beskrivning av händelsen |
|---|---|
order.skapad | En ny order har skapats |
order.betald | En order är markerad som betald |
order.skickad | En order är markerad som skickad |
produkt.uppdaterad | En produkt har uppdaterats |
Skapa en webhook
- Gå till Inställningar (kugghjulet)
- Klicka på de tre prickarna och välj Webhooks
- Klicka på "Skapa ny webhook"
- Ange den URL som ska ta emot webhook-data
- Välj den händelse som du vill lyssna på
- Klicka på Spara
Exempel på nyttolast för webhook
När en händelse utlöses skickar Shoporama en HTTP POST-begäran till din URL med data i JSON-format. Här är ett exempel för order.created:
{ "event": "order.created", "order_id": 12345, "webshop_id": 5842, "timestamp": "2024-01-15T10:30:00+01:00" }
Din mottagande tjänst bör svara med HTTP-status 200 för att bekräfta mottagandet.
Använda webhooks
Typiska användningsområden för webhooks:
- Lagerintegration - skicka nya beställningar automatiskt till lagret
- Slack/Teams-meddelande - få meddelande om nya beställningar i din kanal
- Anpassad integration - synkronisera ordrar med ditt eget system
- Automatisering - trigga arbetsflöden i Zapier, Make eller liknande
Tips för att använda
Använd ett verktyg som webhook .site för att testa dina webhooks innan du implementerar din slutliga mottagare.
Behöver du hjälp med något? Kontakta oss på support@shoporama.dk.