> ## 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 heti niiden tapahtuessa.

**Webhookit** antavat omalle järjestelmällesi tiedon lähetyksistä, tilauksista ja seurannasta heti. Kun valitsemasi tapahtuma sattuu, esimerkiksi lähetys lähetetään, Zippendo lähettää viestin palvelimesi osoitteeseen (URL). Tämän määrittää yleensä kehittäjä.

Webhookit sisältyvät jokaiseen pakettiin (Free enintään 5, Standard enintään 10, Growth enintään 25, Pro enintään 100, Enterprise rajaton).

## Mistä sen löytää

Avaa sivupalkin alareunan organisaatiovalikko, valitse **Hallitse** ja sitten **Webhookit**-välilehti. Näet webhookisi ja **Lisää webhook** -painikkeen.

## Lisää webhook

<Steps>
  <Step title="Avaa ikkuna">
    Valitse **Lisää webhook** (tai **Luo ensimmäinen webhookisi**, jos luettelo on tyhjä).
  </Step>

  <Step title="Nimi ja osoite">
    Anna **Nimi \*** ja **Päätepisteen URL \***, esimerkiksi `https://your-server.com/webhooks/zippendo`. Käytä osoitetta, joka alkaa merkkijonolla `https://`.
  </Step>

  <Step title="Valitse tapahtumat">
    Valitse haluamasi **Tapahtumat \***, kuten **Lähetys lähetetty** tai **Seuranta päivitetty**, tai valitse **Valitse kaikki**.
  </Step>

  <Step title="Tallenna">
    Valitse **Luo webhook**. Zippendo lähettää nyt jokaisen valitun tapahtuman osoitteeseesi. Palvelimesi pitäisi vastata 2xx-tilalla nopeasti, jotta Zippendo tietää viestin saapuneen perille.
  </Step>
</Steps>

<Info>
  Jokainen viesti sisältää tapahtuman nimen, ajan sekä lähetyksen, tilauksen tai seurannan tiedot. Tarkka sisältö ja allekirjoituksen tarkistus on kuvattu sivulla [Webhookien pikaopas](/docs/fi/quickstarts/webhooks).
</Info>

## Webhookien suojaaminen

* Allekirjoitus: Zippendo allekirjoittaa jokaisen viestin webhookille kuuluvalla salaisuudella. Kehittäjäsi käyttää sitä tarkistaakseen, että viesti tulee todella Zippendolta. Sovellus ei näytä salaisuutta, vaan kehittäjä lukee sen API:n kautta (Get webhook -pyyntö [API-viitteessä](/docs/api-reference/overview)).
* HTTPS: käytä vain `https://`-osoitteita, jotta viestit salataan matkalla.

## Brändit

Jos organisaatiosi käyttää [brändejä](/docs/fi/settings/brands), voit antaa webhookille brändin. Silloin se saa vain kyseisen brändin tapahtumat. Webhook ilman brändiä saa jokaisen brändin tapahtumat. Aseta **Brändi**, kun lisäät tai muokkaat webhookia.

## Webhookin keskeyttäminen tai poistaminen

* **Keskeytä**: valitse webhookin kohdalla **Muokkaa**, poista **Aktiivinen**-valinta ja valitse **Tallenna muutokset**. Zippendo lopettaa lähettämisen kyseiseen osoitteeseen mutta säilyttää webhookin ja sen **Toimituslokin**.
* **Poista**: valitse **Poista**, kirjoita webhookin nimi isoilla kirjaimilla ja vahvista. Kyseiseen osoitteeseen ei lähetetä enää viestejä, ja sen **Toimitusloki** poistetaan.

Jokainen kenttä, toimitusloki ja testiviestit: [Webhookit](/docs/fi/how-to/webhooks).


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