Hva er webhooks?

Webhooks er automatiske HTTP-kall som sender data fra Shoporama-nettbutikken din til en URL du selv velger. Når en bestemt hendelse skjer - 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 å hele tiden spørre API-et "har det skjedd noe nytt?", forteller webhooks deg proaktivt når det er noe å reagere på. Dette resulterer i lavere ventetid, 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

• Ordre opprettet - Når en ny ordre kommer inn
• Ny status - Når statusen til en bestilling endres (f.eks. fra "Ny" til "Sendt")
• Betalt - Når betalingen for en ordre er registrert

Produkter

• Produkt endret - Når et produkt opprettes eller oppdateres
• Lager endret - Når lagernivået endres
• Kategori endret - Når kategorier opprettes, endres eller slettes

Checkout-flyt

• Lagt til i handlekurven - Når en kunde legger et produkt i handlekurven
• Kurvoppdatert - Når kurven endres
• Checkout steps - Besøker handlekurv-siden, adressesiden, fraktsiden, godkjenningssiden og takkesiden
• Ordre godkjent - Nårordren er endelig godkjent

Kunder og annet

• Kunde opprettet - Når en ny kunde registreres
• Påmelding tilnyhetsbrev - 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 er signert med en unik hemmelighet, som genereres automatisk ved opprettelsen. Dette gjør at serveren din kan bekrefte 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 er midlertidig nede. Du kan når som helst se loggen over leverte webhooks, inkludert status, svartid og eventuelle feil.

Logg og feilsøking

Alle webhook-leveranser logges med detaljer som f.eks:

• Tidspunkt for utsendelse
• Type hendelse
• HTTP-statuskode fra serveren din
• Svartid
• Mulighet for å sende individuelle webhooks på nytt

Du kan filtrere loggen etter hendelsestype, status og dato - og du kan sende testwebhooks for å verifisere at integrasjonen fungerer som den skal før du går live.

Statistikk

For hver webhook kan du se statistikk over de siste 30 dagene, med antall leveranser, suksessrate og feilfordeling. Dette gir deg en rask oversikt over om integrasjonene dine fungerer som de skal.

Opprett via API-et

I tillegg til administratorpanelet kan webhooks også opprettes og administreres programmatisk via REST API. Dette gjør at apper og integrasjoner kan sette opp sine egne webhooks automatisk.

Typiske bruksscenarioer

• ERP-integrasjon: Send nye bestillinger direkte til ERP-systemet ditt i det øyeblikket de opprettes
• Lagervarsler: Få varsel når et produkt begynner å gå tomt på lager
• Automatisering av markedsføring: Utløs e-postflyt basert på kundeatferd i kassen
• Slack-varsler: Send en melding til Slack-kanalen din med hver nye bestilling
• Egendefinerte dashbord: Bygg ditt eget dashbord i sanntid med bestillingsdata i sanntid