Skip to main content
Webhooks låter ditt eget system veta i samma stund som något händer i Zippendo: en försändelse skapas eller skickas, en order ändras eller ett paket får en ny spårningshändelse. Zippendo skickar ett meddelande till en adress (URL) på din server. Du ställer in dem under Webhooks i Inställningar. Mottagarsidan byggs oftast av en utvecklare. Det här är inte de andra sorters webhooks som du kan möta i Zippendo: Om du vill skicka händelser till Slack, Klaviyo och liknande appar utan att bygga något använder du i stället Anslut Slack, Klaviyo och andra appar. Rundtur i Inställningar: Inställningar, team och varumärken. Vad varje meddelande innehåller: Snabbstart för webhooks. Meddelanden som inte kommer fram: Leveransfel för webhooks.
Webhooks ingår i alla planer: Free upp till 5 webhooks, Standard upp till 10, Growth upp till 25, Pro upp till 100, Enterprise obegränsat.

​
Var du hittar det

Öppna organisationsmenyn längst ned i sidofältet, klicka på Hantera och sedan på fliken Webhooks. Knappen för att skapa en är Lägg till webhook uppe till höger.
Fliken Webhooks i Inställningar med en webhook i listan och Lägg till webhook i rubrikfältetFliken Webhooks i Inställningar med en webhook i listan och Lägg till webhook i rubrikfältet

Listan Webhooks: namn, URL, händelser, status och åtgärder

​
Listan Webhooks

Varje rad har Leveranslogg, Skicka test, Redigera och Radera. Ett klick på raden öppnar Redigera webhook. Om du vill hitta en webhook klickar du på Filter ovanför listan. Du kan söka på namn, välja Aktiv (Ja eller Nej) och, om du har varumärken, ett Varumärke. Klicka på Lägg till filter för att tillämpa. Mer om listor: Sök och filter. När det inte finns några webhooks än visar listan Inga webhooks och en knapp Skapa din första webhook.

​
Skapa en webhook

1

Öppna fönstret

Klicka på Lägg till webhook, eller Skapa din första webhook när listan är tom. Fönstret Skapa webhook öppnas.
2

Namn och adress

Fyll i Namn * och Endpoint-URL *. Använd en adress som börjar med https://.
3

Välj händelser

Kryssa i de händelser du vill ha, eller klicka på Markera alla. Kryssa i Spårning uppdaterad om ditt system behöver varje spårningsskanning.
4

Skapa den

Klicka på Skapa webhook. Du ser Webhooken har skapats.
Fönstret Skapa webhook med Namn, Endpoint-URL, Markera alla och kryssrutorna för försändelsehändelserFönstret Skapa webhook med Namn, Endpoint-URL, Markera alla och kryssrutorna för försändelsehändelser

Skapa webhook: Namn, Endpoint-URL och händelserna

Skapa webhook är grå tills du har fyllt i namnet, adressen och minst en händelse. Om skapandet misslyckas med Du har nått gränsen i din plan. Uppgradera planen eller ta bort något du inte längre använder. raderar du en webhook som du inte längre använder eller uppgraderar din plan.

​
Händelserna

Det finns nio händelser, i tre grupper. Det tekniska namnet i andra kolumnen är det som ditt system tar emot.
Fönstret Skapa webhook med alla nio händelser ikryssade, inklusive Spårning uppdateradFönstret Skapa webhook med alla nio händelser ikryssade, inklusive Spårning uppdaterad

Markera alla kryssar i alla händelser, inklusive Spårning uppdaterad

Ordrar som kommer in från en ansluten webbutik, och de ändringar webbutiken skickar senare, skickar inga orderhändelser. Ditt system får ändå veta om dem via försändelsehändelserna: Zippendo skapar en försändelse för varje order som importeras. Skicka test skickar ett testmeddelande som heter webhook.test. Du kan inte kryssa i det som en händelse.

​
Redigera eller pausa en webhook

Klicka på raden, eller Redigera, för att öppna Redigera webhook. Den har samma fält som Skapa webhook, plus Aktiv. Klicka på Spara ändringar när du är klar.
Fönstret Redigera webhook med Namn, Endpoint-URL, en kryssruta Aktiv och händelsernaFönstret Redigera webhook med Namn, Endpoint-URL, en kryssruta Aktiv och händelserna

Redigera webhook: samma fält, plus Aktiv

Ta bort kryssen vid Aktiv för att sluta skicka utan att radera webhooken eller dess Leveranslogg. Kolumnen Status visar då Inaktiv. Kryssa i den igen för att börja skicka.

​
Leveranslogg

Leveranslogg på en rad visar de senaste försöken att leverera till den adressen.
Leveransloggen med händelsenamn, svarsstatus, varaktighet, försök och tidLeveransloggen med händelsenamn, svarsstatus, varaktighet, försök och tid

Leveranslogg: händelse, status, varaktighet, försök, fel och tid

Zippendo väntar upp till 10 sekunder på att din server ska svara. Om den inte svarar, eller svarar med ett fel, försöker Zippendo igen, upp till 5 gånger totalt, och väntar lite längre varje gång. Varje försök är en rad i loggen.

​
Skicka ett testmeddelande

Klicka på Skicka test på en rad. Du ser Testhändelsen har skickats. Testmeddelandet ser ut så här:
Öppna Leveranslogg för att se om din server tog emot det.

​
Radera en webhook

Klicka på Radera på en rad. Radera webhook ber dig skriva webhookens namn med versaler och sedan klicka på Radera. Webhooken och dess Leveranslogg tas bort och du ser Webhooken har raderats.
Fönstret Radera webhook med ett fält för att skriva namnet och bekräftaFönstret Radera webhook med ett fält för att skriva namnet och bekräfta

Radera webhook: skriv namnet med versaler för att bekräfta

​
För utvecklare: meddelandeformat och signatur

Varje meddelande är en POST med en JSON-kropp { "event", "timestamp", "brandId", "data" } och de här rubrikerna: Zippendo skapar hemligheten när du skapar webhooken. Appen visar den inte: läs den med anropet Get webhook i API-referensen (listanropet utelämnar den). Kontrollera signaturen innan du läser kroppen. Ett genomarbetat exempel finns i Snabbstart för webhooks. Ordrar som skickas till en egen orderkanal signeras på samma sätt, med rubriken X-Zippendo-Signature: API för egen kanal.
Svara snabbt med en 2xx-status och gör arbetet efteråt. Använd https://-adresser. Webhooks som inte är Aktiv tar inte emot något.

​
Relaterat