Opprette webhooks

Webhooks er et verktøy for å hente og lagre data fra en bestemt hendelse. De lar deg registrere en https://-URL-adresse der hendelsesdataene kan lagres i JSON- eller XML-format. Webhooks brukes vanligvis av følgende årsaker:

• Legge inn en bestilling
• Endre prisen på et produkt
• Varsle direktemeldingsklienten eller personsøkeren din når du er frakoblet
• Samle inn data for datalagring
• Integrere regnskapsprogramvaren din
• Filtrere bestillingsvarene og informere ulike transportører om bestillingen
• Fjerne kundedata fra databasen din når de avinstallerer appen din

Merk

Du mottar en e-post til butikkeierens e-postadresse når en webhook mislykkes. E-posten sendes bare når webhooken er opprettet av en app fra Shopify App Store eller av en egendefinert app. Hvis webhook-destinasjonen gjentatte ganger returnerer en annen statusrespons enn 200, blir webhook-abonnementet automatisk slettet fra Shopify-administratorpanelet.

Tips

For avansert feilsøking av webhook-problemer kan utviklere se veiledningen Feilsøking av webhooks i utviklerdokumentasjonen.

Støttede webhook-hendelser

Når du oppretter en webhook, kan du velge blant de oppførte hendelsene. Hvis du for eksempel vil opprette en webhook som sendes hver gang en bestilling er betalt, velger du Bestillingsbetaling. Som et annet eksempel: hvis du vil opprette en webhook som sendes hver gang en butikkegenskap oppdateres, velger du Butikkoppdatering.

Tabell som lister opp støttede webhook-hendelser som er tilgjengelige i Shopify-administratorpanelet.

Kategori	Hendelser
Handlekurv	Oppretting av handlekurv Oppdatering av handlekurv
Kasse	Oppretting av kasse Sletting av kasse Oppdatering av kasse
Samling	Oppretting av samling Sletting av samling Oppdatering av samling
Kunde	Oppdatering av kundens samtykke til SMS-markedsføring Oppdatering av kundekontoinnstillinger Oppretting av kunde Sletting av kunde Deaktivering av kunde Oppdatering av kundens samtykke til e-postmarkedsføring Aktivering av kunde Oppretting av kundegruppe Sletting av kundegruppe Oppdatering av kundegruppe Kundetagger lagt til Kundetagger fjernet Oppdatering av kunde
Rabatt	Oppretting av rabatt Sletting av rabatt Oppdatering av rabatt
Bestillingsutkast	Oppretting av bestillingsutkast Sletting av bestillingsutkast Oppdatering av bestillingsutkast
Distribusjon	Oppretting av distribusjon Distribusjonsbestilling kan ikke fullføres av oppfyllelsestjeneste Poster i distribusjonsbestilling klargjøres for henting Distribusjonsbestilling flyttet Distribusjonsbestilling satt på vent Distribusjonsbestilling omplanlagt Planlagt distribusjonsbestilling forfaller Bestillingsruting for distribusjonsbestilling er fullført Distribusjonsbestillinger kansellert Forespørsel om kansellering av distribusjonsbestillinger er godkjent Forespørsel om kansellering av distribusjonsbestillinger er avvist Forespørsel om kansellering av distribusjonsbestillinger er sendt Distribusjonsforespørsel for distribusjonsbestillinger godkjent Distribusjonsforespørsel for distribusjonsbestillinger avvist Distribusjonsforespørsel for distribusjonsbestillinger sendt Ventestatus for distribusjonsbestillinger opphevet Poster i distribusjonsbestillinger klargjort for lokal levering Distribusjonsbestillinger slått sammen Distribusjonsbestillinger delt Oppdatering av distribusjon
Varelager	Oppretting av lagervare Sletting av lagervare Oppdatering av lagervare Tilkobling av lagernivå Frakobling av lagernivå Oppdatering av lagernivå
Sted	Aktivering av lokalisasjon Opprettelse av lokalisasjon Deaktivering av lokalisasjon Sletting av lokalisasjon Oppdatering av vare på lokasjon
Marked	Opprettelse av marked Sletting av marked Oppdatering av marked
Bestilling	Kansellering av bestilling Opprettelse av bestilling Sletting av bestilling Redigering av bestilling Bestillingsdistribusjon Bestillingsinnbetaling Endret risikovurdering for bestilling Oppdatering av bestilling
Produkt	Opprettelse av produkt Sletting av produkt Oppdatering av produkt
Refusjon	Opprettelse av refusjon
Butikk	Butikkoppdatering
Betalingsmiddel	Opprettelse av transaksjon med betalingsmiddel
Tema	Opprettelse av tema Sletting av tema Publisering av tema Oppdatering av tema
Transaksjon	Opprettelse av transaksjon

Tips

Utviklere kan se den fullstendige listen over webhook-emner når de oppretter webhook-abonnementer.

Opprett webhooks

Du kan opprette en webhook når som helst. Webhookene dine signeres med en ID som består av en kombinasjon av bokstaver og tall som er unik for butikken din.

Trinn:

Stasjonær datamaskin

1. Fra Shopify-administrator går du til Innstillinger > Varsler.

2. Klikk på Webhooks.

3. Klikk på ⊕ Opprett webhook.

4. I Hendelse-rullegardinmenyen velger du en av de støttede webhook-hendelsene du vil bruke som webhook-hendelse. Du kan ikke endre webhook-hendelsen etter at webhooken er opprettet.

5. I Format-rullegardinmenyen velger du formatet du vil at Shopify skal sende deg denne informasjonen i. De to valgene er JSON eller XML.

6. I URL-feltet angir du URL-adressen der du vil at dataene skal lagres. Webhooks kan ikke returneres til følgende URL-adresser:

   • Localhost
   • Enhver URL-adresse som slutter på ordet «internal» (for eksempel example.com/internal)
   • Enhver URL-adresse fra et egendefinert domene som er knyttet til butikken
   • «Falske» domener (for eksempel www.example.com)
   • Shopify-domener (for eksempel shopify.com og myshopify.com)

7. I Webhook API-versjon velger du foretrukket webhook-versjon.

8. Klikk på Lagre.

Mobil

1. Fra Shopify app, trykk på , og deretter på Innstillinger.

2. I Butikkinnstillinger-seksjonen trykker du på Varsler.

3. Trykk på Webhooks.

4. Trykk på ⊕ Opprett webhook.

5. I Hendelse-rullegardinmenyen velger du en av de støttede webhook-hendelsene du vil bruke som webhook-hendelse. Du kan ikke endre webhook-hendelsen etter at webhooken er opprettet.

6. I Format-rullegardinmenyen velger du formatet du vil at Shopify skal sende deg denne informasjonen i. De to valgene er JSON eller XML.

7. I URL-feltet angir du URL-adressen der du vil at dataene skal lagres. Webhooks kan ikke returneres til følgende URL-adresser:

   • Localhost
   • Enhver URL-adresse som slutter på ordet «internal» (for eksempel example.com/internal)
   • Enhver URL-adresse fra et egendefinert domene som er knyttet til butikken
   • «Falske» domener (for eksempel www.example.com)
   • Shopify-domener (for eksempel shopify.com og myshopify.com)

8. I Webhook API-versjon velger du foretrukket webhook-versjon.

9. Trykk på Lagre eller ✓.

Når den nye webhooken er lagret, vises den på Webhooks-siden.

Rediger webhooks

Du kan redigere konfigurasjonen for en webhook etter at den er opprettet. Du kan imidlertid ikke endre den valgte webhook-hendelsen.

Trinn:

Stasjonær datamaskin

1. Fra Shopify-administrator går du til Innstillinger > Varsler.

2. Klikk på Webhooks.

3. Klikk på ... > Rediger i raden som inneholder webhooken du vil redigere.

4. I dialogboksen Rediger webhook endrer du webhooken etter behov.

5. Klikk på Lagre.

Mobil

1. Fra Shopify app, trykk på , og deretter på Innstillinger.

2. I Butikkinnstillinger-seksjonen trykker du på Varsler.

3. Trykk på Webhooks.

4. Trykk på ... > Rediger i raden som inneholder webhooken du vil redigere.

5. I dialogboksen Rediger webhook endrer du webhooken etter behov.

6. Trykk på Lagre eller ✓.

Test webhooks

Du kan teste webhooken for å sikre at hendelsesinformasjonen du ønsker blir sendt til riktig URL-adresse.

Trinn:

Stasjonær datamaskin

1. Fra Shopify-administrator går du til Innstillinger > Varsler.

2. Klikk på Webhooks.

3. Klikk på ... > Send test i raden som inneholder webhooken du vil teste.

4. Bekreft at varselet fungerer på URL-adressen du har angitt for webhooken.

Mobil

1. Fra Shopify app, trykk på , og deretter på Innstillinger.

2. I Butikkinnstillinger-seksjonen trykker du på Varsler.

3. Trykk på Webhooks.

4. Trykk på ... > Send test i raden som inneholder webhooken du vil teste.

5. Bekreft at varselet fungerer på URL-adressen du har angitt for webhooken.

Slett webhooks

Du kan slette en webhook fra Shopify-administrator. Denne handlingen kan ikke angres.

Merk

Hvis webhook-destinasjonen gjentatte ganger returnerer et annet statussvar enn 200, slettes webhook-abonnementet automatisk fra Shopify-administrator.

Trinn:

Stasjonær datamaskin

1. Fra Shopify-administrator går du til Innstillinger > Varsler.

2. Klikk på Webhooks.

3. Klikk på ... > Slett i raden som inneholder webhooken du vil slette.

Mobil

1. Fra Shopify app, trykk på , og deretter på Innstillinger.

2. I Butikkinnstillinger-seksjonen trykker du på Varsler.

3. Trykk på Webhooks.

4. Trykk på ... > Slett i raden som inneholder webhooken du vil slette.