Oprettelse af webhooks

Webhooks er et værktøj, der bruges til at hente og gemme data fra en bestemt begivenhed. Du kan bruge dem til at oprette en https://-webadresse, hvor dataene omkring begivenheden kan gemmes i JSON- eller XML-format. Webhooks bruges almindeligvis af de følgende årsager:

• Afgivelse af en ordre
• Ændring af prisen på et produkt
• Underretning til din IM-klient eller din personsøger, når du er offline
• Indsamling af data til datalagring
• Integration af dit regnskabssoftware
• Filtrering af varer i ordrer og information til forskellige fragtmænd om ordren
• Fjernelse af kundedata fra din database, når appen afinstalleres

Bemærk

Du modtager en mail på butiksejerens mailadresse, når en webhook mislykkes. Mailen sendes kun, når den pågældende webhook er oprettet af en app fra Shopify App Store eller af en tilpasset app. Hvis webhook-destinationen gentagne gange returnerer et svar om en ikke-200-status, slettes webhook-abonnementet automatisk i din Shopify-administrator.

Understøttede webhookhændelser

Når du opretter en webhook, kan du vælge mellem nogle af de anførte hændelser. Hvis du f.eks. vil oprette en webhook, der sendes, hver gang en ordre er betalt, skal du vælge Ordrebetaling. Og hvis du f.eks. vil oprette en webhook, der sendes, hver gang en butiksegenskab opdateres, skal du vælge Butiksopdatering.

Tabel med de understøttede webhookhændelser, der er tilgængelige i Shopify-administratoren.

Kategori	Events
Indkøbskurv	Oprettelse af indkøbskurv Opdatering af indkøbskurv
Betalingsproces	Oprettelse af betaling Sletning af betaling Opdatering af betaling
Kollektion	Oprettelse af kollektion Sletning af kollektion Opdatering af kollektion
Kunde	Opdatering af kundesamtykke til markedsføring via sms Opdatering af indstillingerne for kundekonto Oprettelse af kunde Sletning af kunde Deaktivering af kunde Opdatering af kundesamtykke til e-mailmarkedsføring Aktivering af kunde Oprettelse af kundegruppe Sletning af kundegruppe Opdatering af kundegruppe Kundetags er tilføjet Kundetags er 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 behandling Klargøringsordren kan ikke fuldføres af klargøringstjenesten Varelinjer med klargøringsordrer, der er forberedt til afhentning Klargøringsordren er flyttet Klargøringsordren er sat på pause Klargøringsordren er planlagt på ny Klargøringsordrer, der var planlagt, forfalder Ordreruten for klargøringsordre er fuldført Klargøringsordrerne er annulleret Anmodningen om annullering af klargøringsordrer er godkendt Anmodningen om annullering af klargøringsordrer er afvist Anmodningen om annullering af klargøringsordrer er sendt Klargøringsanmodning for klargøringsordrer accepteret Klargøringsanmodning for klargøringsordrer afvist Klargøringsanmodning for klargøringsordrer indsendt Pausen for klargøringsordrer er ophævet Varelinjer med klargøringsordrer, der er forberedt til lokal levering Klargøringsordrer blev flettet Klargøringsordrer er opdelt Opdatering af behandling
Lager	Oprettelse af lagervare Sletning af lagervare Opdatering af lagervare Tilknytning af lagerniveau Fjernelse af tilknytning af lagerniveau Opdatering af lagerniveau
Lokation	Aktivering af lokation Oprettelse af lokationer Deaktivering af lokation Sletning af lokation Opdatering af lokationsvare
Markedsføre	Oprettelse af marked Sletning af marked Opdatering af marked
Ordre	Annullering af ordre Oprettelse af ordre Sletning af ordre Redigering af ordre Ordreklargøring Ordrebetaling Risikovurdering for ordren er ændret Ordreopdatering
Produkt	Oprettelse af produkter Sletning af produkt Opdatering af produkt
Refunder	Oprettelse af refusion
Shop	Vis opdatering
Betalingsmiddel	Oprettelse af betalingsmiddelstransaktion
Tema	Oprettelse af tema Sletning af tema Offentliggørelse af tema Opdatering af tema
Transaktion	Oprettelse af transaktion

Tip

Udviklere kan se hele listen over webhook-emner, når du opretter webhook-abonnementer.

Opret webhooks

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

Trin:

Desktop

1. Gå til Indstillinger > Meddelelser i din Shopify-administrator.

2. Klik på Webhooks.

3. Klik på ⊕ Opret webhook.

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

5. Vælg det format, du vil have, hvori Shopify skal sende disse oplysninger til dig, i rullemenuen Format. De to valgmuligheder er JSON eller XML.

6. I feltet webadresse skal du angive den webadresse, hvor du vil have gemt dine data. Webhooks kan ikke returneres til følgende webadresser:

   • Localhost
   • Alle webadresser, der slutter med ordet "internal" (f.eks. example.com/internal)
   • Enhver webadresse fra ethvert 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. Vælg din foretrukne webhook-version i Webhook API-versionen.

8. Klik på Gem.

iPhone

1. Tryk på knappen … i Shopify-appen, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. Tryk på ⊕ Opret webhook.
5. I rullemenuen Hændelser skal du vælge en af de understøttede webhook-hændelser, du vil bruge som din webhook-hændelse. Du kan ikke ændre webhook-hændelsen, efter webhooken er oprettet.
6. Vælg det format, du vil have, hvori Shopify skal sende disse oplysninger til dig, i rullemenuen Format. De to valgmuligheder er JSON eller XML.

7. I feltet webadresse skal du angive den webadresse, hvor du vil have gemt dine data. Webhooks kan ikke returneres til følgende webadresser:

   • Localhost
   • Alle webadresser, der slutter med ordet "internal" (f.eks. example.com/internal)
   • Enhver webadresse fra ethvert 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. Vælg din foretrukne webhook-version i Webhook API-versionen.

9. Tryk på Gem.

Android

1. I Shopify-appen trykker du på ☰, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. Tryk på ⊕ Opret webhook.
5. I rullemenuen Hændelser skal du vælge en af de understøttede webhook-hændelser, du vil bruge som din webhook-hændelse. Du kan ikke ændre webhook-hændelsen, efter webhooken er oprettet.
6. Vælg det format, du vil have, hvori Shopify skal sende disse oplysninger til dig, i rullemenuen Format. De to valgmuligheder er JSON eller XML.

7. I feltet webadresse skal du angive den webadresse, hvor du vil have gemt dine data. Webhooks kan ikke returneres til følgende webadresser:

   • Localhost
   • Alle webadresser, der slutter med ordet "internal" (f.eks. example.com/internal)
   • Enhver webadresse fra ethvert 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. Vælg din foretrukne webhook-version i Webhook API-versionen.

9. Tryk på ✓.

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

Rediger webhooks

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

Trin:

Desktop

1. Gå til Indstillinger > Meddelelser i din Shopify-administrator.

2. Klik på Webhooks.

3. Klik på ... > Rediger i den række, der indeholder den webhook, du vil redigere.

4. Rediger webhooken efter behov i dialogboksen Rediger webhook.

5. Klik på Gem.

iPhone

1. Tryk på knappen … i Shopify-appen, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. I rækken, der indeholder den webhook, du vil redigere, skal du trykke på ... > Rediger.
5. Rediger webhooken efter behov i dialogboksen Rediger webhook.
6. Tryk på Gem.

Android

1. I Shopify-appen trykker du på ☰, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. I rækken, der indeholder den webhook, du vil redigere, skal du trykke på ... > Rediger.
5. Rediger webhooken efter behov i dialogboksen Rediger webhook.
6. Tryk på ✓.

Test webhooks

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

Trin:

Desktop

1. Gå til Indstillinger > Meddelelser i din Shopify-administrator.

2. Klik på Webhooks.

3. I rækken, der indeholder 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 meddelelsen fungerer.

iPhone

1. Tryk på knappen … i Shopify-appen, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. Tryk på ... > Send test i den række, der indeholder den webhook, du vil teste.
5. På den webadresse, du har angivet for webhooken, skal du bekræfte, at meddelelsen fungerer.

Android

1. I Shopify-appen trykker du på ☰, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. Tryk på ... > Send test i den række, der indeholder den webhook, du vil teste.
5. På den webadresse, du har angivet for webhooken, skal du bekræfte, at meddelelsen fungerer.

Slet webhooks

Du kan slette en webhook i din Shopify-administrator. Denne handling kan ikke fortrydes.

Bemærk

Hvis webhook-destinationen gentagne gange returnerer et svar om en ikke-200-status, slettes webhook-abonnementet automatisk i din Shopify-administrator.

Trin:

Desktop

1. Gå til Indstillinger > Meddelelser i din Shopify-administrator.

2. Klik på Webhooks.

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

iPhone

1. Tryk på knappen … i Shopify-appen, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. I rækken, der indeholder den webhook, du vil slette, skal du trykke på ... > Slet.

Android

1. I Shopify-appen trykker du på ☰, og tryk derefter på Indstillinger.
2. Tryk på Meddelelser i afsnittet Indstillinger for butik.
3. Tryk på Webhooks.
4. I rækken, der indeholder den webhook, du vil slette, skal du trykke på ... > Slet.