Oprettelse af webhooks

Webhooks er et værktøj til at hente og gemme data fra en bestemt hændelse. De giver dig mulighed for at registrere en https://-webadresse, hvor hændelsesdataene kan gemmes i JSON- eller XML-format. Webhooks bruges normalt af følgende årsager:

• Afgivelse af en ordre
• Ændring af et produkts pris
• Underretning af din IM-klient eller din personsøger, når du er offline
• Indsamling af data til datawarehousing
• Integration af din regnskabssoftware
• Filtrering af ordrevarer og underretning af forskellige afsendere om ordren
• Fjernelse af kundedata fra din database, når kunder afinstallerer din app

Bemærk

Du modtager en mail på butiksejerens mailadresse, når en webhook mislykkes. Mailen sendes kun, når webhooken er oprettet af en app fra Shopify App Store eller af en custom app. Hvis webhook-destinationen gentagne gange returnerer et svar med en anden status end 200, slettes webhook-abonnementet automatisk fra din Shopify-administrator.

Tip

Udviklere kan finde hjælp til avanceret fejlfinding af webhook-problemer i vejledningen Fejlfinding af webhooks i udviklerdokumentationen.

Understøttede webhook-hændelser

Når du opretter en webhook, kan du vælge mellem alle de anførte hændelser. Hvis du f.eks. vil oprette en webhook, der sendes, hver gang en ordre er blevet betalt, skal du vælge Betaling af ordre. Hvis du derimod vil oprette en webhook, der sendes, hver gang en butiksegenskab opdateres, skal du vælge Opdatering af butik.

Tabel, der viser de understøttede webhook-hændelser, der er tilgængelige i Shopify-administrator.

Kategori	Hændelser
Indkøbskurv	Oprettelse af indkøbskurv Opdatering af indkøbskurv
Betalingsside	Oprettelse af betalingsside Sletning af betalingsside Opdatering af betalingsside
Kollektion	Oprettelse af kollektion Sletning af kollektion Opdatering af kollektion
Kunde	Opdatering af kundens samtykke til sms-markedsføring Opdatering af indstillinger for kundekonto Oprettelse af kunde Sletning af kunde Deaktivering af kunde Opdatering af kundens samtykke til e-mailmarkedsføring Aktivering af kunde Oprettelse af kundegruppe Sletning af kundegruppe Opdatering af kundegruppe Kundetags tilføjet Kundetags fjernet Opdatering af kunde
Rabat	Oprettelse af rabat Sletning af rabat Opdatering af rabat
Ordrekladde	Oprettelse af ordrekladde Sletning af ordrekladde Opdatering af ordrekladde
Klargøring	Oprettelse af klargøring Klargøringsordre kan ikke fuldføres af klargøringstjeneste Varelinjer i klargøringsordre er klargjort til afhentning Klargøringsordre flyttet Klargøringsordre sat på pause Klargøringsordre omlagt Planlagt klargøringsordre forfalder Ordrerouting for klargøringsordre er fuldført Klargøringsordrer annulleret Anmodning om annullering af klargøringsordrer er accepteret Anmodning om annullering af klargøringsordrer er afvist Anmodning om annullering af klargøringsordrer er indsendt Anmodning om klargøring af klargøringsordrer er accepteret Anmodning om klargøring af klargøringsordrer er afvist Anmodning om klargøring af klargøringsordrer er indsendt Pause for klargøringsordrer er ophævet Varelinjer i klargøringsordrer er klargjort til lokal levering Klargøringsordrer flettet Klargøringsordrer opdelt Opdatering af klargøring
Lager	Oprettelse af lagervare Sletning af lagervare Opdatering af lagervare Forbindelse til lagerniveau Afbrydelse af lagerniveau Opdatering af lagerniveau
Lokation	Aktivering af lokation Oprettelse af lokation Deaktivering af lokation Sletning af lokation Opdatering af vare på lokation
Marked	Oprettelse af marked Sletning af marked Opdatering af marked
Ordre	Annullering af ordre Oprettelse af ordre Sletning af ordre Redigering af ordre Klargøring af ordre Betaling for ordre Ændret risikovurdering for ordre Opdatering af ordre
Produkt	Oprettelse af produkt Sletning af produkt Opdatering af produkt
Refusion	Oprettelse af refusion
Butik	Opdatering af butik
Betalingsmiddel	Oprettelse af betalingsmiddelstransaktion
Tema	Oprettelse af tema Sletning af tema Udgivelse af tema Opdatering af tema
Transaktion	Oprettelse af transaktion

Tip

Udviklere kan se den komplette liste over webhook-emner, når de opretter webhook-abonnementer.

Opret webhooks

Du kan oprette en webhook når som helst. Dine webhooks signeres med et id, der er unikt for din butik og består af en kombination af bogstaver og tal.

Fremgangsmåde:

Computer

1. Fra din Shopify-administrator skal du gå til Indstillinger > Notifikationer.

2. Klik på Webhooks.

3. Klik på ⊕ Opret webhook.

4. I rullemenuen Hændelse skal du vælge en af de understøttede webhook-hændelser, som du vil bruge som din webhook-hændelse. Du kan ikke ændre webhook-hændelsen, efter webhooken er oprettet.

5. I rullemenuen Format skal du vælge det format, som Shopify skal bruge til at sende disse oplysninger til dig. De to valgmuligheder er JSON eller XML.

6. I feltet Webadresse skal du angive den webadresse, hvor dataene skal gemmes. Webhooks kan ikke returneres til følgende webadresser:

   • Localhost
   • Enhver webadresse, der slutter på ordet “internal” (f.eks. example.com/internal)
   • Enhver webadresse fra et tilpasset domæne, der er knyttet til butikken
   • “Falske” domæner (f.eks. www.example.com)
   • Shopify-domæner (f.eks. shopify.com og myshopify.com)

7. I Webhook API-version skal du vælge din foretrukne webhook-version.

8. Klik på Gem.

Mobil

1. Tryk på i Shopify-appen, og tryk derefter på Indstillinger.

2. I afsnittet Butiksindstillinger skal du trykke på Notifikationer.

3. Tryk på Webhooks.

4. Tryk på ⊕ Opret webhook.

5. I rullemenuen Hændelse skal du vælge en af de understøttede webhook-hændelser, som du vil bruge som din webhook-hændelse. Du kan ikke ændre webhook-hændelsen, efter webhooken er oprettet.

6. I rullemenuen Format skal du vælge det format, som Shopify skal bruge til at sende disse oplysninger til dig. De to valgmuligheder er JSON eller XML.

7. I feltet Webadresse skal du angive den webadresse, hvor dataene skal gemmes. Webhooks kan ikke returneres til følgende webadresser:

   • Localhost
   • Enhver webadresse, der slutter på ordet “internal” (f.eks. example.com/internal)
   • Enhver webadresse fra et tilpasset domæne, der er knyttet til butikken
   • “Falske” domæner (f.eks. www.example.com)
   • Shopify-domæner (f.eks. shopify.com og myshopify.com)

8. I Webhook API-version skal du vælge din foretrukne webhook-version.

9. Tryk på Gem eller ✓.

Når din nye webhook er gemt, vises den på siden Webhooks.

Rediger webhooks

Du kan redigere konfigurationen af en webhook, efter den er blevet oprettet. Du kan dog ikke ændre den valgte webhook-hændelse.

Fremgangsmåde:

Computer

1. Fra din Shopify-administrator skal du gå til Indstillinger > Notifikationer.

2. Klik på Webhooks.

3. I rækken med den webhook, du vil redigere, skal du klikke på ... > Rediger.

4. I dialogboksen Rediger webhook skal du redigere webhooken efter behov.

5. Klik på Gem.

Mobil

1. Tryk på i Shopify-appen, og tryk derefter på Indstillinger.

2. I afsnittet Butiksindstillinger skal du trykke på Notifikationer.

3. Tryk på Webhooks.

4. I rækken med den webhook, du vil redigere, skal du trykke på ... > Rediger.

5. I dialogboksen Rediger webhook skal du redigere webhooken efter behov.

6. Tryk på Gem eller ✓.

Test webhooks

Du kan teste din webhook for at sikre dig, at de hændelsesoplysninger, du ønsker, sendes til den korrekte webadresse.

Fremgangsmåde:

Computer

1. Fra din Shopify-administrator skal du gå til Indstillinger > Notifikationer.

2. Klik på Webhooks.

3. I rækken med den webhook, du vil teste, skal du klikke på ... > Send test.

4. På den webadresse, du har angivet for webhooken, skal du bekræfte, at notifikationen fungerer.

Mobil

1. Tryk på i Shopify-appen, og tryk derefter på Indstillinger.

2. I afsnittet Butiksindstillinger skal du trykke på Notifikationer.

3. Tryk på Webhooks.

4. I rækken med den webhook, du vil teste, skal du trykke på ... > Send test.

5. På den webadresse, du har angivet for webhooken, skal du bekræfte, at notifikationen fungerer.

Slet webhooks

Du kan slette en webhook fra din Shopify-administrator. Handlingen kan ikke fortrydes.

Bemærk

Hvis webhook-destinationen gentagne gange returnerer et statussvar, der ikke er 200, slettes webhook-abonnementet automatisk fra din Shopify-administrator.

Fremgangsmåde:

Computer

1. Fra din Shopify-administrator skal du gå til Indstillinger > Notifikationer.

2. Klik på Webhooks.

3. I rækken med den webhook, du vil slette, skal du klikke på ... > Slet.

Mobil

1. Tryk på i Shopify-appen, og tryk derefter på Indstillinger.

2. I afsnittet Butiksindstillinger skal du trykke på Notifikationer.

3. Tryk på Webhooks.

4. I rækken med den webhook, du vil slette, skal du trykke på ... > Slet.