Vad är webhooks?
Webhooks är automatiska HTTP-anrop som skickar data från din Shoporama-webbshop till en URL som du själv väljer. När en viss händelse inträffar – till exempel en ny beställning eller en ändring i lagerstatus – skickar Shoporama omedelbart ett meddelande till din server med all relevant data.
I stället för att ständigt fråga API:et ”har något nytt hänt?” meddelar webhooks dig proaktivt när det finns något att reagera på. Det ger kortare fördröjning, mindre belastning och en smidigare integration.
Händelser som stöds
Shoporama stöder webhooks för ett brett spektrum av händelser, grupperade i fyra kategorier:
Beställningar
- Order skapad — När en ny order kommer in
- Ny status — När en orders status ändras (t.ex. från ”Ny” till ”Skickad”)
- Betald — När betalningen för en order registreras
Produkter
- Produkt ändrad — När en produkt skapas eller uppdateras
- Lager ändrat — När lagerbeholdningen ändras
- Kategori ändrad — När kategorier skapas, ändras eller raderas
Kassaflöde
- Lagt till i varukorgen — När en kund lägger en produkt i varukorgen
- Varukorgen uppdaterad — När innehållet i varukorgen ändras
- Kassasteg — Besök på varukorgssidan, adresssidan, leveranssidan, bekräftelsessidan och tacksidan
- Beställning bekräftad — När beställningen slutgiltigt bekräftas
Kunder och övrigt
- Kund skapad — När en ny kund registreras
- Nyhetsbrevsprenumeration — När en besökare prenumererar på nyhetsbrevet
- Ny retur — När en kund skapar en returförfrågan
Säkerhet och tillförlitlighet
Varje webhook signeras med en unik hemlig nyckel (secret) som genereras automatiskt vid skapandet. Det gör det möjligt för din server att verifiera att anropet verkligen kommer från Shoporama och inte är förfalskat.
Shoporama levererar webhooks asynkront via en intern kö, så att händelser inte går förlorade även om din server tillfälligt är nere. Du kan när som helst se loggen över levererade webhooks, inklusive status, svarstid och eventuella fel.
Logg och felsökning
Alla webhook-leveranser loggas med detaljer som:
- Tidpunkt för avsändning
- Händelsetyp
- HTTP-statuskod från din server
- Svarstid
- Möjlighet att skicka om enskilda webhooks
Du kan filtrera loggen efter händelsetyp, status och datum — och du kan skicka test-webhooks för att verifiera att din integration fungerar korrekt innan du går live.
Statistik
För varje webhook kan du se statistik för de senaste 30 dagarna med antal leveranser, framgångsgrad och felfördelning. Det ger dig en snabb överblick över om dina integrationer fungerar stabilt.
Skapa via API:et
Förutom via adminpanelen kan webhooks även skapas och hanteras programmatiskt via REST-API:et. Det gör det möjligt för appar och integrationer att automatiskt konfigurera sina egna webhooks.
Typiska användningsscenarier
- ERP-integration: Skicka nya order direkt till ditt ERP-system så fort de skapas
- Lagervarningar: Få ett meddelande när en produkt börjar ta slut i lagret
- Marknadsföringsautomatisering: Utlös e-postflöden baserat på kundbeteende i kassan
- Slack-meddelanden: Skicka ett meddelande till din Slack-kanal vid varje ny beställning
- Anpassade instrumentpaneler: Skapa din egen instrumentpanel i realtid med live-orderdata