Hvad er webhooks?
Webhooks er automatiske HTTP-kald, der sender data fra din Shoporama-webshop til en URL, du selv vælger. Når en bestemt hændelse sker — for eksempel en ny ordre eller en ændring i lagerstatus — sender Shoporama øjeblikkeligt en besked til din server med alle relevante data.
I stedet for konstant at spørge API'et "er der sket noget nyt?", fortæller webhooks dig proaktivt, når der er noget at reagere på. Det giver lavere forsinkelse, mindre belastning og en mere elegant integration.
Understøttede hændelser
Shoporama understøtter webhooks for en bred vifte af hændelser, grupperet i fire kategorier:
Ordrer
- Ordre oprettet — Når en ny ordre kommer ind
- Ny status — Når en ordres status ændres (fx fra "Ny" til "Afsendt")
- Betalt — Når betalingen for en ordre registreres
Produkter
- Produkt ændret — Når et produkt oprettes eller opdateres
- Lager ændret — Når lagerbeholdningen ændres
- Kategori ændret — Når kategorier oprettes, ændres eller slettes
Checkout-flow
- Tilføjet til kurv — Når en kunde lægger et produkt i kurven
- Kurv opdateret — Når kurven ændres
- Checkout-trin — Besøg af kurvside, adresseside, forsendelsesside, godkendelsesside og takkeside
- Ordre godkendt — Når ordren endeligt godkendes
Kunder og andet
- Kunde oprettet — Når en ny kunde registreres
- Nyhedsbrev tilmelding — Når en besøgende tilmelder sig nyhedsbrevet
- Ny returnering — Når en kunde opretter en returanmodning
Sikkerhed og pålidelighed
Hver webhook signeres med en unik hemmelighed (secret), som genereres automatisk ved oprettelse. Det gør det muligt for din server at verificere, at kaldet virkelig kommer fra Shoporama og ikke er forfalsket.
Shoporama leverer webhooks asynkront via en intern kø, så hændelser går ikke tabt, selv hvis din server midlertidigt er nede. Du kan til enhver tid se loggen over leverede webhooks, inklusive status, responstid og eventuelle fejl.
Log og fejlsøgning
Alle webhook-leveringer logges med detaljer som:
- Tidspunkt for afsendelse
- Hændelsestype
- HTTP-statuskode fra din server
- Responstid
- Mulighed for at gensende individuelle webhooks
Du kan filtrere loggen på hændelsestype, status og dato — og du kan sende test-webhooks for at verificere, at din integration fungerer korrekt, inden du går live.
Statistik
For hver webhook kan du se statistik over de seneste 30 dage med antal leveringer, succesrate og fejlfordeling. Det giver dig et hurtigt overblik over, om dine integrationer kører stabilt.
Opret via API'et
Ud over admin-panelet kan webhooks også oprettes og administreres programmatisk via REST API'et. Det gør det muligt for apps og integrationer at opsætte deres egne webhooks automatisk.
Typiske brugscenarier
- ERP-integration: Send nye ordrer direkte til dit ERP-system i det øjeblik de oprettes
- Lageradvarsler: Få besked når et produkt er ved at løbe tørt på lageret
- Marketing-automatisering: Trigger e-mail-flows baseret på kundeadfærd i checkout
- Slack-notifikationer: Send en besked til din Slack-kanal ved hver ny ordre
- Custom dashboards: Byg dit eget real-time dashboard med live ordredata