Hva er webhooks?
Webhooks er automatiske HTTP-forespørsler som sender data fra din Shoporama-nettbutikk til en URL du selv velger. Når en bestemt hendelse inntreffer – for eksempel en ny ordre eller en endring i lagerstatus – sender Shoporama umiddelbart en melding til serveren din med alle relevante data.
I stedet for å stadig spørre API-et «har det skjedd noe nytt?», informerer webhooks deg proaktivt når det er noe å reagere på. Dette gir kortere forsinkelser, mindre belastning og en mer elegant integrasjon.
Støttede hendelser
Shoporama støtter webhooks for et bredt spekter av hendelser, gruppert i fire kategorier:
Bestillinger
- Bestilling opprettet — Når en ny bestilling kommer inn
- Ny status — Når statusen til en ordre endres (f.eks. fra «Ny» til «Sendt»)
- Betalt — Når betalingen for en ordre registreres
Produkter
- Produkt endret — Når et produkt opprettes eller oppdateres
- Lager endret — Når lagerbeholdningen endres
- Kategori endret — Når kategorier opprettes, endres eller slettes
Kasseprosess
- Lagt til i handlekurven — Når en kunde legger et produkt i handlekurven
- Handlekurv oppdatert — Når innholdet i handlekurven endres
- Kasseprosess — Besøk på handlekurvssiden, adressesiden, fraktsiden, bekreftelsessiden og takkesiden
- Bestilling godkjent — Når bestillingen endelig godkjennes
Kunder og annet
- Kunde opprettet — Når en ny kunde registreres
- Påmelding til nyhetsbrev — Når en besøkende melder seg på nyhetsbrevet
- Ny retur — Når en kunde oppretter en returforespørsel
Sikkerhet og pålitelighet
Hver webhook signeres med en unik hemmelig nøkkel (secret), som genereres automatisk ved opprettelse. Dette gjør det mulig for serveren din å verifisere at anropet virkelig kommer fra Shoporama og ikke er forfalsket.
Shoporama leverer webhooks asynkront via en intern kø, slik at hendelser ikke går tapt, selv om serveren din midlertidig er nede. Du kan når som helst se loggen over leverte webhooks, inkludert status, responstid og eventuelle feil.
Logg og feilsøking
Alle webhook-leveranser logges med detaljer som:
- Tidspunkt for sending
- Hendelsestype
- HTTP-statuskode fra serveren din
- Responstid
- Mulighet for å sende individuelle webhooks på nytt
Du kan filtrere loggen etter hendelsestype, status og dato — og du kan sende test-webhooks for å verifisere at integrasjonen din fungerer som den skal før du går live.
Statistikk
For hver webhook kan du se statistikk for de siste 30 dagene med antall leveranser, suksessrate og feilfordeling. Dette gir deg et raskt overblikk over om integrasjonene dine kjører stabilt.
Opprett via API-et
I tillegg til administrasjonspanelet kan webhooks også opprettes og administreres programmatisk via REST-API-et. Dette gjør det mulig for apper og integrasjoner å konfigurere sine egne webhooks automatisk.
Typiske bruksscenarier
- ERP-integrasjon: Send nye ordrer direkte til ERP-systemet ditt så snart de opprettes
- Lagervarsler: Få beskjed når et produkt er i ferd med å gå tomt på lageret
- Markedsføringsautomatisering: Utløs e-postflyter basert på kundeatferd i kassen
- Slack-varsler: Send en melding til Slack-kanalen din ved hver nye ordre
- Tilpassede dashbord: Lag ditt eget sanntidsdashbord med live ordredata