> ## Documentation Index
> Fetch the complete documentation index at: https://www.zippendo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Webhookit

> Lähetä lähetys-, tilaus- ja seurantatapahtumat Zippendosta omaan järjestelmääsi - nimi, päätepisteen URL, tapahtumat, toimitusloki, testiviesti, muokkaus, poisto ja allekirjoituksen tarkistus.

**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](/docs/fi/how-to/tracking-webhooks). |
| Shopifyn tilaus-webhookit | Shopify-myyntikanavalla | Shopify → Zippendo. Zippendo ottaa ne käyttöön. Katso [Shopify-asetukset](/docs/fi/how-to/shopify-settings). |
| WooCommercen tilaus-webhookit | WooCommerce-myyntikanavalla | WooCommerce → Zippendo. Katso [Yhdistä WooCommerce](/docs/fi/how-to/connect-woocommerce). |
| Mukautetun kanavan tilaukset | Mukautetulla myyntikanavalla | Järjestelmäsi → Zippendo. Katso [Mukautetun kanavan API](/docs/fi/how-to/custom-channel-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](/docs/fi/how-to/connect-an-integration).

Asetusten esittely: [Asetukset, tiimi ja brändit](/docs/fi/tutorials/settings-team-brands). Mitä kukin viesti sisältää: [Webhookien pika-aloitus](/docs/fi/quickstarts/webhooks). Viestit, jotka eivät saavu perille: [Webhook-toimitusten epäonnistuminen](/docs/fi/knowledge-base/webhook-delivery-failures).

<Info>
  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.
</Info>

## 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.

<Frame caption="Webhookit-luettelo: nimi, URL, tapahtumat, tila ja toiminnot">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/01-webhooks-list-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=cbf29277258a8c42cc0366c70deddc43" alt="Asetusten Webhookit-välilehti, jonka luettelossa on yksi webhook ja otsikossa Lisää webhook" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/webhooks/01-webhooks-list-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/01-webhooks-list-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=f3c2af2a86553ecec23dcca324f6f229" alt="Asetusten Webhookit-välilehti, jonka luettelossa on yksi webhook ja otsikossa Lisää webhook" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/webhooks/01-webhooks-list-dark.png" />
</Frame>

## 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](/docs/fi/how-to/search-and-filters).

Kun webhookeja ei ole vielä, luettelossa lukee **Ei webhookeja** ja siinä on **Luo ensimmäinen webhookisi** -painike.

## Luo webhook

<Steps>
  <Step title="Avaa ikkuna">
    Napsauta **Lisää webhook** tai **Luo ensimmäinen webhookisi**, kun luettelo on tyhjä. **Luo webhook** -ikkuna aukeaa.
  </Step>

  <Step title="Nimi ja osoite">
    Täytä **Nimi \*** ja **Päätepisteen URL \***. Käytä osoitetta, joka alkaa merkinnällä `https://`.
  </Step>

  <Step title="Valitse tapahtumat">
    Rastita haluamasi tapahtumat tai napsauta **Valitse kaikki**. Rastita **Seuranta päivitetty**, jos järjestelmäsi tarvitsee jokaisen seurantaskannauksen.
  </Step>

  <Step title="Luo se">
    Napsauta **Luo webhook**. Näet viestin **Webhook luotu**.
  </Step>
</Steps>

<Frame caption="Luo webhook: Nimi, Päätepisteen URL ja tapahtumat">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/02-create-webhook-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=fbaac92e509e0f098e5c91d5dc2b2681" alt="Luo webhook -ikkuna, jossa on Nimi, Päätepisteen URL, Valitse kaikki ja lähetystapahtumien valintaruudut" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/webhooks/02-create-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/02-create-webhook-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=fd12e72c7a6f9ae9144813a2269843d6" alt="Luo webhook -ikkuna, jossa on Nimi, Päätepisteen URL, Valitse kaikki ja lähetystapahtumien valintaruudut" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/webhooks/02-create-webhook-dark.png" />
</Frame>

| 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.

<Frame caption="Valitse kaikki rastittaa jokaisen tapahtuman, myös Seuranta päivitetty">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/03-events-tracking-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=ca4d9dc6d2e90239617aa6ea050dd8bf" alt="Luo webhook -ikkuna, jossa kaikki yhdeksän tapahtumaa on rastitettu, myös Seuranta päivitetty" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/webhooks/03-events-tracking-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/03-events-tracking-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=5cbf2ccbaa244f64d4a6142b9fe0d673" alt="Luo webhook -ikkuna, jossa kaikki yhdeksän tapahtumaa on rastitettu, myös Seuranta päivitetty" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/webhooks/03-events-tracking-dark.png" />
</Frame>

| 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.

<Frame caption="Muokkaa webhookia: samat kentät sekä Aktiivinen">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/04-edit-webhook-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=bab3b51c746c181ce6bb1d8a7c783cc4" alt="Muokkaa webhookia -ikkuna, jossa on Nimi, Päätepisteen URL, Aktiivinen-valintaruutu ja tapahtumat" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/webhooks/04-edit-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/04-edit-webhook-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=966b29a221cffdb604908df6b7acaa23" alt="Muokkaa webhookia -ikkuna, jossa on Nimi, Päätepisteen URL, Aktiivinen-valintaruutu ja tapahtumat" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/webhooks/04-edit-webhook-dark.png" />
</Frame>

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.

<Frame caption="Toimitusloki: tapahtuma, tila, kesto, yritys, virhe ja aika">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/05-delivery-log-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=84deac50c707e00dc136890b71e3bca0" alt="Toimitusloki, jossa näkyvät tapahtumien nimet, vastauksen tila, kesto, yritys ja aika" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/webhooks/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/05-delivery-log-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=76c506a6ad46d863bea10999a54830ce" alt="Toimitusloki, jossa näkyvät tapahtumien nimet, vastauksen tila, kesto, yritys ja aika" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/webhooks/05-delivery-log-dark.png" />
</Frame>

| 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ä:

```json theme={null}
{
  "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**.

<Frame caption="Poista webhook: vahvista kirjoittamalla nimi isoilla kirjaimilla">
  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/06-delete-webhook-light.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=393b0ef2b5e54fc1974d5fcb2d83d4bc" alt="Poista webhook -ikkuna, jossa on kenttä nimen kirjoittamiseen vahvistusta varten" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/webhooks/06-delete-webhook-light.png" />

  <img src="https://mintcdn.com/zippendo/8sYzWg2Ds8PYtcdt/images/fi/how-to/webhooks/06-delete-webhook-dark.png?fit=max&auto=format&n=8sYzWg2Ds8PYtcdt&q=85&s=2506a4be77e7c30d045eaf929285a0b2" alt="Poista webhook -ikkuna, jossa on kenttä nimen kirjoittamiseen vahvistusta varten" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/webhooks/06-delete-webhook-dark.png" />
</Frame>

## 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ä](/docs/api-reference/overview) (luettelopyyntö jättää sen pois). Tarkista allekirjoitus ennen kuin luet sisällön. Esimerkki löytyy [Webhookien pika-aloituksesta](/docs/fi/quickstarts/webhooks). Mukautettuun myyntikanavaan lähetetyt tilaukset allekirjoitetaan samalla tavalla `X-Zippendo-Signature`-otsikolla: [Mukautetun kanavan API](/docs/fi/how-to/custom-channel-api).

<Tip>
  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.
</Tip>

## Liittyvää

* [Luo API-token](/docs/fi/how-to/create-an-api-token): järjestelmäsi kysyy Zippendolta sen sijaan, että Zippendo kertoisi järjestelmällesi.
* [Kuljetusyhtiöiden seurannan webhookit](/docs/fi/how-to/tracking-webhooks): kuljetusyhtiöt lähettävät seurantaa Zippendoon.
* [Yhdistä Slack, Klaviyo ja muut sovellukset](/docs/fi/how-to/connect-an-integration): oma palvelin ei ole tarpeen.
* [Shopify-asetukset](/docs/fi/how-to/shopify-settings) / [Yhdistä WooCommerce](/docs/fi/how-to/connect-woocommerce): verkkokauppojen webhookit, jotka Zippendo ottaa käyttöön puolestasi.


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.