Vad är webhooks?
Webhooks är automatiska HTTP-anrop som skickar data från din Shoporama-webbutik till en URL som du väljer. När en viss händelse inträffar - till exempel en ny order eller en ändring av lagerstatus - skickar Shoporama omedelbart ett meddelande till din server med all relevant information.
Istället för att ständigt fråga API:et "har det hänt något nytt?", berättar webhooks proaktivt när det finns något att reagera på. Detta resulterar i lägre latens, mindre belastning och en mer elegant integration.
Händelser som stöds
Shoporama stöder webhooks för ett brett utbud av händelser, grupperade i fyra kategorier:
Beställningar
- Order skapad - När en ny order kommer in
- Ny status - När statusen för en order ändras (t.ex. från "Ny" till "Skickad")
- Betald - När betalningen för en order registreras
Produkter
- Produktändring - När en produkt skapas eller uppdateras
- Stock changed - När lagernivån ändras
- Category changed - När kategorier skapas, ändras eller tas bort
Flöde för utcheckning
- Tillagdi korgen - När en kund lägger till en produkt i korgen
- Korgen uppdaterad - När korgen ändras
- Steg i kassan - Besök på varukorgssidan, adressidan, leveranssidan, godkännandesidan och tacksidan
- Order godkänd - När ordern slutligen är godkänd
Kunder och övrigt
- Kund skapad - När en ny kund registreras
- Newsletter sign-up - När en besökare anmäler sig till nyhetsbrevet
- Ny retur - När en kund skapar en returbegäran
Säkerhet och tillförlitlighet
Varje webhook är signerad med en unik hemlighet som genereras automatiskt vid skapandet. Detta gör att din server kan verifiera att samtalet verkligen kommer från Shoporama och inte är förfalskat.
Shoporama levererar webhooks asynkront via en intern kö, så händelser går inte förlorade även om din server tillfälligt är nere. Du kan när som helst visa loggen över levererade webhooks, inklusive status, svarstid och eventuella fel.
Logg och felsökning
Alla webhook-leveranser loggas med information som t.ex:
- Tidpunkt för avsändning
- Typ av händelse
- 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 testwebhooks för att verifiera att din integration fungerar korrekt innan du går live.
Statistik
För varje webhook kan du visa statistik över de senaste 30 dagarna med antal leveranser, framgångsgrad och felfördelning. Detta ger dig en snabb överblick över om dina integrationer fungerar som de ska.
Skapa via API:et
Förutom via adminpanelen kan webhooks också skapas och hanteras programmatiskt via REST API. Detta gör att appar och integrationer kan skapa sina egna webhooks automatiskt.
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 lager
- Marketing automation: Utlösa e-postflöden baserat på kundens beteende i kassan
- Slack-meddelanden: Skicka ett meddelande till din Slack-kanal med varje ny order
- Anpassade dashboards: Bygg din egen dashboard i realtid med orderdata i realtid