Webhookit

Webhookit kertovat omalle järjestelmällesi heti, kun jotain tapahtuu Zippendossa: lähetys luodaan tai lähetetään, tilaus muuttuu tai paketille tulee uusi seurantatapahtuma. Zippendo lähettää viestin osoitteeseen (URL) palvelimellasi. Otat ne käyttöön kohdassa Webhookit Asetuksissa; vastaanottavan puolen rakentaa yleensä kehittäjä. Nämä eivät ole muita webhook-tyyppejä, joihin saatat törmätä Zippendossa:

Tyyppi	Missä	Suunta
Webhookit (tämä sivu)	Asetukset → Webhookit	Zippendo → palvelimesi
Kuljetusyhtiöiden seurannan webhookit	Kuljetusyhtiöllä	Kuljetusyhtiö → Zippendo. Katso Kuljetusyhtiöiden seurannan webhookit.
Shopifyn tilaus-webhookit	Shopify-myyntikanavalla	Shopify → Zippendo. Zippendo ottaa ne käyttöön. Katso Shopify-asetukset.
WooCommercen tilaus-webhookit	WooCommerce-myyntikanavalla	WooCommerce → Zippendo. Katso Yhdistä WooCommerce.
Mukautetun kanavan tilaukset	Mukautetulla myyntikanavalla	Järjestelmäsi → Zippendo. Katso Mukautetun kanavan API.

Jos haluat lähettää tapahtumia Slackiin, Klaviyoon ja vastaaviin sovelluksiin rakentamatta mitään, käytä sen sijaan sivua Yhdistä Slack, Klaviyo ja muut sovellukset. Asetusten esittely: Asetukset, tiimi ja brändit. Mitä kukin viesti sisältää: Webhookien pika-aloitus. Viestit, jotka eivät saavu perille: Webhook-toimitusten epäonnistuminen.

Webhookit sisältyvät jokaiseen pakettiin: Free enintään 5 webhookia, Standard enintään 10, Growth enintään 25, Pro enintään 100, Enterprise rajattomasti.

Mistä sen löytää

Avaa sivupalkin alareunassa oleva organisaatiovalikko, napsauta Hallitse ja sitten Webhookit-välilehteä. Painike uuden luomiseen on Lisää webhook oikeassa yläkulmassa.

Asetusten Webhookit-välilehti, jonka luettelossa on yksi webhook ja otsikossa Lisää webhook — Webhookit-luettelo: nimi, URL, tapahtumat, tila ja toiminnot

Webhookit-luettelo

Sarake	Mitä se näyttää
Nimi	Antamasi nimi.
Brändi	Webhookin brändi tai tyhjä, jos se kattaa koko organisaation. Näkyy vain, jos organisaatiollasi on brändejä.
URL	Osoite, johon Zippendo lähettää.
Tapahtumat	Kaksi ensimmäistä lähetettävää tapahtumaa, esimerkiksi Lähetys luotu; loput on tiivistetty.
Tila	Aktiivinen tai Ei aktiivinen.
Luotu	Milloin se luotiin.

Jokaisella rivillä on Toimitusloki, Lähetä testi, Muokkaa ja Poista. Rivin napsauttaminen avaa Muokkaa webhookia. Löytääksesi webhookin napsauta luettelon yläpuolella Suodattimet. Voit hakea nimellä, valita Aktiivinen (Kyllä tai Ei) ja, jos sinulla on brändejä, Brändin. Napsauta Lisää suodattimet ottaaksesi ne käyttöön. Lisää luetteloista: Haku ja suodattimet. Kun webhookeja ei ole vielä, luettelossa lukee Ei webhookeja ja siinä on Luo ensimmäinen webhookisi -painike.

Luo webhook

Avaa ikkuna

Napsauta Lisää webhook tai Luo ensimmäinen webhookisi, kun luettelo on tyhjä. Luo webhook -ikkuna aukeaa.

Nimi ja osoite

Täytä Nimi * ja Päätepisteen URL *. Käytä osoitetta, joka alkaa merkinnällä https://.

Valitse tapahtumat

Rastita haluamasi tapahtumat tai napsauta Valitse kaikki. Rastita Seuranta päivitetty, jos järjestelmäsi tarvitsee jokaisen seurantaskannauksen.

Luo se

Napsauta Luo webhook. Näet viestin Webhook luotu.

Luo webhook -ikkuna, jossa on Nimi, Päätepisteen URL, Valitse kaikki ja lähetystapahtumien valintaruudut — Luo webhook: Nimi, Päätepisteen URL ja tapahtumat

Kenttä	Pakollinen	Mitä annetaan
Nimi *	Kyllä	Nimi, jonka tunnistat, esimerkiksi ”Tilausilmoitukset”. Enintään 100 merkkiä.
Päätepisteen URL *	Kyllä	Täydellinen osoite palvelimellasi, esimerkiksi `https://example.com/webhooks`.
Brändi	Ei	Näkyy vain, jos organisaatiollasi on brändejä. Valitse brändi ja Tämä webhook vastaanottaa vain tämän brändin tapahtumat. Oletus, Ei brändiä (koko organisaatio), vastaanottaa jokaisen brändin tapahtumat.
Tapahtumat *	Kyllä, vähintään yksi	Lähetettävät tapahtumat. Katso alla oleva luettelo.

Luo webhook pysyy harmaana, kunnes olet täyttänyt nimen, osoitteen ja vähintään yhden tapahtuman. Jos luominen epäonnistuu viestiin Olet saavuttanut pakettisi rajan. Vaihda pakettia tai poista jotain, mitä et enää käytä., poista webhook, jota et enää käytä, tai vaihda pakettia.

Tapahtumat

Tapahtumia on yhdeksän, kolmessa ryhmässä. Toisen sarakkeen tekninen nimi on se, jonka järjestelmäsi vastaanottaa.

Luo webhook -ikkuna, jossa kaikki yhdeksän tapahtumaa on rastitettu, myös Seuranta päivitetty — Valitse kaikki rastittaa jokaisen tapahtuman, myös Seuranta päivitetty

Tapahtuma	Nimi, jonka järjestelmäsi vastaanottaa	Lähetetään, kun
Lähetys luotu	`shipment.created`	Lähetys luodaan.
Lähetys päivitetty	`shipment.updated`	Lähetystä muutetaan.
Lähetys lähetetty	`shipment.dispatched`	Lähetys lähetetään ja sillä on osoitekortti.
Lähetys peruttu	`shipment.cancelled`	Lähetys poistetaan.
Lähetyksen virhe	`shipment.error`	Lähetyksen lähettäminen kuljetusyhtiölle epäonnistuu.
Tilaus luotu	`order.created`	Tilaus luodaan API:n kautta.
Tilaus päivitetty	`order.updated`	Tilausta muutetaan Zippendossa tai API:n kautta.
Tilaus peruttu	`order.cancelled`	Tilaus poistetaan Zippendossa tai API:n kautta.
Seuranta päivitetty	`tracking.updated`	Paketille tulee uusi seurantatapahtuma.

Yhdistetystä verkkokaupasta tulevat tilaukset ja verkkokaupan myöhemmin lähettämät muutokset eivät lähetä tilaustapahtumia. Järjestelmäsi saa niistä silti tiedon lähetystapahtumien kautta: Zippendo luo lähetyksen jokaiselle tuomalleen tilaukselle. Lähetä testi lähettää testiviestin nimeltä webhook.test. Sitä ei voi rastittaa tapahtumaksi.

Muokkaa tai keskeytä webhook

Napsauta riviä tai Muokkaa avataksesi Muokkaa webhookia. Siinä on samat kentät kuin Luo webhook -ikkunassa sekä Aktiivinen. Napsauta Tallenna muutokset, kun olet valmis.

Muokkaa webhookia -ikkuna, jossa on Nimi, Päätepisteen URL, Aktiivinen-valintaruutu ja tapahtumat — Muokkaa webhookia: samat kentät sekä Aktiivinen

Poista Aktiivinen-rasti lopettaaksesi lähettämisen poistamatta webhookia tai sen Toimituslokia. Tila-sarakkeessa lukee silloin Ei aktiivinen. Rastita se uudelleen aloittaaksesi lähettämisen.

Toimitusloki

Rivin Toimitusloki näyttää viimeisimmät yritykset toimittaa kyseiseen osoitteeseen.

Sarake	Mitä se näyttää
Tapahtuma	Lähetetty tapahtuma, kuten `shipment.created` tai `webhook.test`.
Tila	Tilakoodi, jolla palvelimesi vastasi, vihreä onnistumisesta ja punainen epäonnistumisesta, tai Ei tietoa, jos vastausta ei tullut.
Kesto	Kuinka kauan palvelimellasi kesti vastata.
Yritys	Mikä yritys oli kyseessä.
Virhe	Mikä meni pieleen, jos mikään.
Aika	Milloin yritys tehtiin.

Zippendo odottaa palvelimesi vastausta enintään 10 sekuntia. Jos se ei vastaa tai vastaa virheellä, Zippendo yrittää uudelleen, yhteensä enintään 5 kertaa, ja odottaa joka kerralla hieman pidempään. Jokainen yritys on rivi lokissa.

Lähetä testiviesti

Napsauta rivillä Lähetä testi. Näet viestin Testitapahtuma lähetetty. Testiviesti näyttää tältä:

{
  "event": "webhook.test",
  "timestamp": "2026-06-22T09:30:00.000Z",
  "data": {
    "webhookId": "cm9x2k4lq0001",
    "message": "This is a test event from Zippendo"
  }
}

Avaa Toimitusloki nähdäksesi, vastaanottiko palvelimesi sen.

Poista webhook

Napsauta rivillä Poista. Poista webhook pyytää kirjoittamaan webhookin nimen isoilla kirjaimilla ja napsauttamaan sitten Poista. Webhook ja sen Toimitusloki poistetaan, ja näet viestin Webhook poistettu.

Kehittäjille: viestin muoto ja allekirjoitus

Jokainen viesti on POST JSON-sisällöllä { "event", "timestamp", "brandId", "data" } ja näillä otsikoilla:

Otsikko	Arvo
`Content-Type`	`application/json`
`X-Webhook-Signature`	Raakasisällön HMAC-SHA256, heksana, webhookin salaisuudella avainnettu
`X-Webhook-Event`	Tapahtuman nimi
`X-Webhook-Id`	Yksi tunnus toimitusta kohden. Saman toimituksen jokainen uusintayritys lähettää saman tunnuksen, joten voit käyttää sitä kaksoiskappaleiden ohittamiseen.

Zippendo luo salaisuuden, kun luot webhookin. Sovellus ei näytä sitä: lue se Get webhook -pyynnöllä API-viitteessä (luettelopyyntö jättää sen pois). Tarkista allekirjoitus ennen kuin luet sisällön. Esimerkki löytyy Webhookien pika-aloituksesta. Mukautettuun myyntikanavaan lähetetyt tilaukset allekirjoitetaan samalla tavalla X-Zippendo-Signature-otsikolla: Mukautetun kanavan API.

Vastaa nopeasti 2xx-tilalla ja tee työ vasta sen jälkeen. Käytä https://-osoitteita. Webhookit, jotka eivät ole Aktiivisia, eivät vastaanota mitään.

Liittyvää

Luo API-token: järjestelmäsi kysyy Zippendolta sen sijaan, että Zippendo kertoisi järjestelmällesi.
Kuljetusyhtiöiden seurannan webhookit: kuljetusyhtiöt lähettävät seurantaa Zippendoon.
Yhdistä Slack, Klaviyo ja muut sovellukset: oma palvelin ei ole tarpeen.
Shopify-asetukset / Yhdistä WooCommerce: verkkokauppojen webhookit, jotka Zippendo ottaa käyttöön puolestasi.

Yleiskatsaus

Lähetykset

Tilaukset ja kanavat

Kuljetusyhtiöt

Yhdistä kuljetusyhtiö

Yhdistä integraatio

Tulostus

Automaatio

Tili

Haku ja hallintapaneeli

API ja tapahtumat

Mistä sen löytää

Webhookit-luettelo

Luo webhook

Tapahtumat

Muokkaa tai keskeytä webhook

Toimitusloki

Lähetä testiviesti

Poista webhook

Kehittäjille: viestin muoto ja allekirjoitus

Liittyvää

​Mistä sen löytää

​Webhookit-luettelo

​Luo webhook

​Tapahtumat

​Muokkaa tai keskeytä webhook

​Toimitusloki

​Lähetä testiviesti

​Poista webhook

​Kehittäjille: viestin muoto ja allekirjoitus

​Liittyvää

Mistä sen löytää

Webhookit-luettelo

Luo webhook

Tapahtumat

Muokkaa tai keskeytä webhook

Toimitusloki

Lähetä testiviesti

Poista webhook

Kehittäjille: viestin muoto ja allekirjoitus

Liittyvää