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

# Yhdistä Slack, Klaviyo ja muut sovellukset

> Yhdistä Klaviyo, Slack, Customer.io, Mailchimp, SendGrid, Zapier tai Make kohdassa Sovellukset ja integraatiot, valitse lähetettävät tapahtumat, lähetä testitapahtuma, lue toimitusloki ja katkaise yhteys.

Integraatio lähettää Zippendossa tapahtuvat asiat toiseen käyttämääsi työkaluun. Kun lähetys luodaan, tilaus saapuu tai paketti saa uuden seurantaskannauksen, Zippendo välittää tiedon Slackille, Klaviyolle, Zapierille ja muille. Integraatiot eivät tuo tilauksia sisään (se on [myyntikanava](/docs/fi/how-to/connect-woocommerce)), eivätkä ne ole [webhook](/docs/fi/how-to/webhooks) omalle palvelimellesi.

Tarvitsetko ehtoja, viiveitä tai useita vaiheita, kuten "julkaise Slackiin vain, kun paketti menee ulkomaille"? Käytä sen sijaan [Automaatioita](/docs/fi/how-to/automations).

<Info>
  Integraatiot sisältyvät jokaiseen pakettiin.
</Info>

## Mistä sen löytää

Napsauta sivupalkissa **Sovellukset ja integraatiot**. Sivulla on kaksi välilehteä:

| Välilehti | Mitä se näyttää |
| - | - |
| **Yhdistetty** | Kaikki, mitä organisaatiosi on yhdistänyt. Sivu avautuu tähän, kun sinulla on vähintään yksi yhteys. |
| **Katalogi** | Kaikki, minkä voit yhdistää. Sivu avautuu tähän, kun mitään ei ole vielä yhdistetty. |

**Katalogissa** on kaksi osaa:

* **Sovellukset** ovat työkaluja, joille Zippendo lähettää tapahtumia: Klaviyo, Slack, Customer.io, Mailchimp, SendGrid, Zapier ja Make. Tämä sivu käsittelee niitä.
* **Integraatiot** ovat järjestelmiä, jotka yhdistyvät Zippendoon ja pyytävät sitä tekemään jotain: varastojärjestelmä, kuten [PeakWMS](/docs/fi/integrations/peakwms), joka tulostaa osoitekortteja, tai tekoälyavustaja, joka on yhdistetty [MCP:n](/docs/fi/mcp/overview) kautta.

<Frame caption="Katalogi listaa kaikki sovellukset, jotka voit yhdistää">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/01-catalog-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=43e6db883b08bb33108d48a606f5299b" alt="Katalogi, jossa kortit Klaviyolle, Slackille, Customer.iolle, Mailchimpille, SendGridille, Zapierille ja Makelle" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/01-catalog-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/01-catalog-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=655fcae563dc5b25844e44e7cbfbcb34" alt="Katalogi, jossa kortit Klaviyolle, Slackille, Customer.iolle, Mailchimpille, SendGridille, Zapierille ja Makelle" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/01-catalog-dark.png" />
</Frame>

Jokainen sovelluskortti näyttää sovelluksen nimen ja lyhyen kuvauksen sekä:

* **Käytä automaatioissa** avaa **Automaatiot**, jossa voit käyttää sovellusta vaiheena.
* **Lue lisää** avaa kyseisen sovelluksen käyttöönotto-ohjeen tällä sivustolla uudella välilehdellä.
* **Yhdistä** aloittaa uuden yhteyden. Kun sovelluksella on yhteys, painikkeessa lukee **Lisää yhteys**.

### Mitä kukin sovellus pyytää

Sovelluksessa \*-merkillä merkityt kentät ovat pakollisia.

| Sovellus | Mitä täytät | Vaiheittainen ohje |
| - | - | - |
| Klaviyo | **Yksityinen API-avain** | [Yhdistä Klaviyo](/docs/fi/how-to/connect-klaviyo) |
| Slack | **Incoming webhook -URL** | [Yhdistä Slack](/docs/fi/how-to/connect-slack) |
| Customer.io | **Site ID**, **API-avain**, **Data-alue** (**Yhdysvallat (track.customer.io)** tai **EU (track-eu.customer.io)**) | [Yhdistä Customer.io](/docs/fi/how-to/connect-customer-io) |
| Mailchimp | **API-avain**, **Audience ID** | [Yhdistä Mailchimp](/docs/fi/how-to/connect-mailchimp) |
| SendGrid | **API-avain**, **Lähettäjän sähköposti**, **Lähettäjän nimi** | [Yhdistä SendGrid](/docs/fi/how-to/connect-sendgrid) |
| Zapier | **Catch Hook -URL** | [Yhdistä Zapier](/docs/fi/how-to/connect-zapier) |
| Make | **Custom webhook -URL** | [Yhdistä Make](/docs/fi/how-to/connect-make) |

## Yhdistä sovellus

<Steps>
  <Step title="Avaa katalogi">
    Napsauta sivupalkissa **Sovellukset ja integraatiot** ja sitten **Katalogi**-välilehteä. Jos **Yhdistetty**-välilehdellä lukee **Mitään ei ole vielä yhdistetty**, napsauta **Avaa katalogi**.
  </Step>

  <Step title="Napsauta sovelluksen kohdalla Yhdistä">
    Sovelluksen mukaan nimetty ikkuna avautuu, esimerkiksi **Yhdistä Zippendo palveluun Slack**.
  </Step>

  <Step title="Tarkista käyttöoikeudet">
    Ensimmäinen vaihe, **Tarkista käyttöoikeudet**, listaa kohdassa **Zippendo haluaa**, mitä Zippendo tekee: lähettää valitsemasi tapahtumat, sisällyttää mukaan tapahtumien tiedot (asiakkaan nimi, sähköposti ja puhelinnumero, toimitusosoite, tilausrivit, paketit ja seurantakoodit), käyttää antamiasi kirjautumistietoja (tallennetaan salattuina eikä niitä näytetä uudelleen) ja kirjata jokaisen toimituksen toimituslokiin. Napsauta **Jatka**.
  </Step>

  <Step title="Täytä yhteyden tiedot">
    Kirjoita kohdassa **Yhteyden tiedot** **Yhteyden nimi**, jonka tunnistat myöhemmin, esimerkiksi "Pakkaustiimin Slack" (enintään 100 merkkiä). Täytä sitten sovelluksen omat kentät yllä olevan taulukon mukaan.
  </Step>

  <Step title="Valitse tapahtumat">
    Kohdassa **Zippendo lähettää palveluun** ja sovelluksen nimi, rastita jokainen tapahtuma, jonka sovelluksen pitäisi saada, tai napsauta **Valitse kaikki**. Voit myös jättää kaikki ruudut tyhjiksi: silloin mitään ei lähetetä itsestään, mutta voit silti käyttää yhteyttä automaatiossa ja lähettää testitapahtuman.
  </Step>

  <Step title="Napsauta Yhdistä">
    **Yhdistä** pysyy harmaana, kunnes yhteyden nimi ja jokainen pakollinen kenttä on täytetty. Kun se onnistuu, näet **Integraatio yhdistetty**, ja sovellus näkyy **Yhdistetty**-välilehdellä.
  </Step>
</Steps>

<Frame caption="Yhteyden tiedot: nimi, sovelluksen omat kentät ja lähetettävät tapahtumat">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/03-connect-modal-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=68e97b81fd490e32d33e7075a7b02c63" alt="Slackin yhteysikkuna, jossa yhteyden nimi, Incoming webhook -URL ja tapahtumien valintaruudut" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/03-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/03-connect-modal-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=3889f9eca0bfcb5bbf2e7b5f08285828" alt="Slackin yhteysikkuna, jossa yhteyden nimi, Incoming webhook -URL ja tapahtumien valintaruudut" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/03-connect-modal-dark.png" />
</Frame>

## Tapahtumat, joita voit lähettää

Tapahtumat on ryhmitelty otsikoiden **Lähetykset**, **Tilaukset** ja **Seuranta** alle. Jokainen sovellus näyttää vain tapahtumat, joita se voi käyttää.

| Valintaruutu | Lähetetään, kun | Slack | Klaviyo | Customer.io | Mailchimp | SendGrid | Zapier | Make |
| - | - | - | - | - | - | - | - | - |
| **Lähetys luotu** | Lähetys luodaan | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| **Lähetys päivitetty** | Lähetys muuttuu | | | | | | ✓ | ✓ |
| **Lähetys lähetetty** | Lähetys lähetetään kuljetusyhtiölle ja sille on osoitekortti | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| **Lähetys peruttu** | Lähetys perutaan tai poistetaan | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |
| **Lähetyksen virhe** | Lähetyksen lähettäminen kuljetusyhtiölle epäonnistuu | ✓ | | | | | ✓ | ✓ |
| **Tilaus luotu** | Uusi tilaus saapuu | ✓ | ✓ | ✓ | ✓ | | ✓ | ✓ |
| **Tilaus päivitetty** | Tilaus muuttuu | | ✓ | ✓ | ✓ | | ✓ | ✓ |
| **Tilaus peruttu** | Tilaus perutaan tai poistetaan | ✓ | | | | | ✓ | ✓ |
| **Seuranta päivitetty** | Kuljetusyhtiö ilmoittaa uuden seurantaskannauksen | | ✓ | ✓ | ✓ | ✓ | ✓ | ✓ |

Nämä ovat samat tapahtumat, joita [webhookit](/docs/fi/how-to/webhooks) käyttävät. Kuljetusyhtiön seurannan webhookit ovat eri asia: katso [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks).

## Yhteytesi

**Yhdistetty**-välilehdellä jokaisella sovelluskortilla on vihreä **Yhdistetty**-merkki ja yhteyksien määrä, esimerkiksi "2 yhteyttä". Voit yhdistää saman sovelluksen useammin kuin kerran, esimerkiksi yhden Slack-kanavan per tiimi: napsauta kortilla **Lisää yhteys**.

<Frame caption="Yhdistetty sovellus yhteyksineen ja neljä kuvaketta">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/02-connected-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=9b50e68e7c97bbe88bf79542d5d3b16e" alt="Yhdistetty-välilehti, jossa Slack-kortti näyttää yhden yhteyden ja neljä kuvaketta" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/02-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/02-connected-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=e104be44cfa07c48d05b74203a596fe8" alt="Yhdistetty-välilehti, jossa Slack-kortti näyttää yhden yhteyden ja neljä kuvaketta" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/02-connected-dark.png" />
</Frame>

Jokainen yhteys on rivi, jossa on sen nimi ja kuinka monta tapahtumaa se lähettää, esimerkiksi "3 tapahtumaa". **Keskeytetty** määrän jälkeen tarkoittaa, että yhteys on kytketty pois Zippendon API:n kautta. Keskeytetty yhteys ei lähetä mitään, eikä sovelluksessa ole sille kytkintä. Vie hiiri kuvakkeiden päälle nähdäksesi, mitä ne tekevät:

| Kuvake | Nimi | Mitä se tekee |
| - | - | - |
| Paperilentokone | **Lähetä testitapahtuma** | Lähettää sovellukselle testitapahtuman. Katso alla. |
| Pistoke | **Näytä toimitusloki** | Näyttää, mitä Zippendo lähetti ja miten sovellus vastasi. |
| Liukusäätimet | **Muokkaa yhteyttä** | Muuttaa nimeä, tunnuksia tai tapahtumia. |
| Roskakori | **Poista yhteys** | Katkaisee sovelluksen yhteyden. |

## Lähetä testitapahtuma

Napsauta paperilentokonetta. **Testitapahtuma lähetetty** tarkoittaa, että Zippendo on laittanut testin jonoon, ei että sovellus on hyväksynyt sen. Avaa toimitusloki muutaman sekunnin kuluttua nähdäksesi, miten sovellus vastasi. Jos näet **Testitapahtuman lähettäminen epäonnistui** tai jonkin muun viestin, testiä ei voitu laittaa jonoon: lue viesti ja yritä uudelleen.

Testitapahtumassa ei ole asiakasta eikä tilausta. Sovellukset, jotka arkistoivat tapahtumat asiakkaan sähköpostin alle (Mailchimp, SendGrid ja Klaviyo), voivat siksi näyttää epäonnistuneen testin, vaikka tunnuksesi olisivat oikein. Kunkin sovelluksen sivu kertoo, mitä odottaa.

## Toimitusloki

Napsauta pistokekuvaketta. **Toimitusloki**-ikkuna listaa kyseisen yhteyden viimeisimmät toimitukset, uusin ensin. Siinä lukee **Ei vielä toimituksia**, kunnes ensimmäinen tapahtuma tai testi on tehty.

<Frame caption="Toimitusloki pysyy tyhjänä ensimmäiseen tapahtumaan tai testiin asti">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/05-delivery-log-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=849b25ed7db18b89894b873e2ea4f099" alt="Toimitusloki-ikkuna, jossa lukee Ei vielä toimituksia" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/05-delivery-log-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=e8a08b65ff7c2308b27de7d6a34c99ef" alt="Toimitusloki-ikkuna, jossa lukee Ei vielä toimituksia" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/05-delivery-log-dark.png" />
</Frame>

Jokainen rivi näyttää:

* vihreän valintamerkin, jos sovellus hyväksyi tapahtuman, tai punaisen rastin, jos ei
* tapahtuman siinä muodossa, jossa Zippendo sen lähettää, esimerkiksi `shipment.dispatched` (testi näkyy muodossa `integration.test`)
* numeron, jolla sovellus vastasi: 200-sarjan numero tarkoittaa hyväksyttyä, 401 tai 403 tarkoittaa, että sovellus hylkäsi tunnuksesi, 404 tarkoittaa, että verkko-osoitetta ei enää ole
* kuinka kauan toimitus kesti ja milloin se tapahtui
* sovelluksen oman virheilmoituksen, kun se epäonnistui

Kun toimitus epäonnistuu, Zippendo yrittää uudelleen enintään 5 kertaa muutaman minuutin kuluessa. Jokainen yritys on oma rivinsä.

## Muokkaa yhteyttä

Napsauta liukusäädinkuvaketta. Sovelluksen mukaan nimetty ikkuna avautuu, esimerkiksi **Muokkaa yhteyttä: Slack**. Siinä on samat kentät kuin yhdistäessäsi.

* Muuta **Yhteyden nimeä** ja rastitettuja tapahtumia vapaasti.
* Tunnuskentät ovat aluksi tyhjiä, koska Zippendo ei näytä niitä uudelleen. Jätä ne kaikki tyhjiksi säilyttääksesi tallennetut tiedot.
* Jos kirjoitat mihin tahansa tunnuskenttään, kaikki kyseiselle yhteydelle tallennettu korvataan nyt kirjoittamallasi. Kun siis muutat yhtä niistä, täytä ne kaikki.

Napsauta **Tallenna muutokset**. Näet viestin **Integraatio päivitetty**.

<Frame caption="Muokkaa yhteyttä: nimeä se uudelleen, vaihda sen tunnukset tai muuta sen tapahtumia">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/04-edit-modal-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=96197e33f9d87a470aa5dd44567310aa" alt="Slack-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjä webhook-kenttä ja tapahtumat" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/04-edit-modal-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=4dc3df135ee74dd86cf055db4e78f309" alt="Slack-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjä webhook-kenttä ja tapahtumat" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/04-edit-modal-dark.png" />
</Frame>

## Katkaise sovelluksen yhteys

Napsauta roskakoria. **Katkaise integraation yhteys** -ikkuna varoittaa: **Katkaistaanko tämän integraation yhteys? Zippendo lopettaa tapahtumien lähettämisen sille ja poistaa sen toimitushistorian.** Kirjoita ruutuun DELETE ja napsauta **Katkaise yhteys**. Näet viestin **Integraation yhteys katkaistu**.

Automaatiot, jotka käyttivät tätä yhteyttä, eivät voi enää lähettää sovellukselle, ennen kuin valitset niissä toisen yhteyden.

<Frame caption="Kirjoita DELETE katkaistaksesi yhteyden">
  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/06-disconnect-modal-light.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=d8856cd8c803c0f87403baced46fb3eb" alt="Katkaise integraation yhteys -ikkuna, jossa pyydetään kirjoittamaan DELETE" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/t1cjOog5R_kJ0hFN/images/fi/how-to/connect-an-integration/06-disconnect-modal-dark.png?fit=max&auto=format&n=t1cjOog5R_kJ0hFN&q=85&s=21f0d31b18dd9c07b2277ecf89e28a02" alt="Katkaise integraation yhteys -ikkuna, jossa pyydetään kirjoittamaan DELETE" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-an-integration/06-disconnect-modal-dark.png" />
</Frame>

<Check>
  Olet valmis, kun sovellus on **Yhdistetty**-välilehdellä ja toimitusloki näyttää vihreän valintamerkin tapahtumalle tai **Ei vielä toimituksia** heti yhdistämisen jälkeen.
</Check>

## Viestit, joita saatat nähdä

| Viesti | Mitä tehdä |
| - | - |
| **Integraation yhdistäminen epäonnistui** | Tarkista yhteytesi ja yritä uudelleen. Ota yhteyttä tukeen, jos ongelma toistuu. |
| **Integraation päivittäminen epäonnistui** | Yritä uudelleen. Aiemmat asetuksesi ovat edelleen voimassa. |
| **Integraatiota ei löytynyt.** | Yhteys oli jo poistettu, ehkä tiimin jäsenen toimesta. Lataa sivu uudelleen. |
| **Testitapahtuma lähetetty**, mutta toimitusloki pysyy tyhjänä | Yhteys on **Keskeytetty**, joten se ei lähetä mitään. |

Sovelluksen puolen ongelmista katso [Integraatioiden vianmääritys](/docs/fi/integrations/troubleshooting).

## Aiheeseen liittyvää

* [Yhdistä kuljetusyhtiö tai integraatio](/docs/fi/how-to/connect-index) - yksi sivu kutakin kuljetusyhtiötä ja sovellusta kohti
* [Integraatioiden yleiskatsaus](/docs/fi/integrations/overview) - ohje jokaiselle sovellukselle
* [Automaatiot](/docs/fi/how-to/automations) - ehdot, viiveet ja useita vaiheita
* [Webhookit](/docs/fi/how-to/webhooks) - lähetä tapahtumia itse ylläpitämääsi verkko-osoitteeseen
* [Kuljetusyhtiön seurannan webhookit](/docs/fi/how-to/tracking-webhooks) - seurantapäivitykset kuljetusyhtiöltä Zippendoon
* [Pyydä kuljetusyhtiön integraatiota](/docs/fi/how-to/request-carrier-integration) - kuljetusyhtiö, jota ei vielä ole luettelossa


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