> ## 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ä Mailchimp

> Yhdistä Mailchimp kohdassa Sovellukset ja integraatiot API-avaimella ja Audience ID:llä ja valitse, mitkä lähetys-, tilaus- ja seurantatapahtumat käynnistävät Mailchimp-sähköpostisi.

Mailchimp vastaanottaa lähetys-, tilaus- ja seurantatapahtumasi ja tallentaa jokaisen tapahtuman vastaavan yhteystiedon alle jossakin yleisöistäsi. Mailchimpissa voit käyttää näitä tapahtumia sähköpostien käynnistämiseen, esimerkiksi ”pakettisi on matkalla”. Mailchimp lähettää sähköpostit omalta Mailchimp-tililtäsi. Zippendo välittää vain tapahtumat.

Integraatiot sisältyvät jokaiseen pakettiin. Testaus, toimituslokki, muokkaus ja yhteyden katkaisu toimivat samalla tavalla jokaisessa sovelluksessa: katso [Integraation yhdistäminen](/docs/fi/how-to/connect-an-integration). Pidempi opas on [Mailchimp](/docs/fi/integrations/mailchimp).

## Ennen aloitusta

Tarvitset kaksi asiaa Mailchimp-tililtäsi:

* **API-avain.** Luo se Mailchimp-tililläsi. Kopioi koko avain, myös loppuosa kuten `-us21`: Zippendo käyttää tuota loppuosaa yhteyden muodostamiseen Mailchimp-tiliisi.
* **Audience ID** yleisöstä, jossa asiakkaasi ovat. Löydät sen Mailchimpista kohdasta Audience → Settings → Audience name and defaults. Käytä tunnusta, ei yleisön nimeä.

<Frame caption="Mailchimpin ohjeartikkeli API-avaimista">
  <img src="https://mintcdn.com/zippendo/9-sVHrvFOKqRvskN/images/how-to/connect-mailchimp/10-mailchimp-about-api-keys.png?fit=max&auto=format&n=9-sVHrvFOKqRvskN&q=85&s=8add1bfccfe9a96215ef7aee8aaed667" alt="Mailchimpin About API Keys -ohjeartikkeli, jossa Generate an API key -osio" width="2880" height="2200" data-path="images/how-to/connect-mailchimp/10-mailchimp-about-api-keys.png" />
</Frame>

## Yhdistä Mailchimp

<Steps>
  <Step title="Etsi Mailchimp katalogista">
    Valitse sivupalkista **Sovellukset ja integraatiot** ja sitten **Katalogi**. Mailchimp on kohdassa **Sovellukset**. Valitse **Yhdistä** tai **Lisää yhteys**, jos sinulla on jo yhteys.
  </Step>

  <Step title="Tarkista käyttöoikeudet">
    Lue, mitä Zippendo tekee yhteydellä, ja valitse **Jatka**.
  </Step>

  <Step title="Täytä yhteyden tiedot">
    Kirjoita **Yhteyden nimi**, esimerkiksi ”Mailchimp-uutiskirje”. Liitä avain kenttään **API-avain** ja yleisön tunnus kenttään **Audience ID**.
  </Step>

  <Step title="Valitse tapahtumat">
    Valitse tapahtumat, jotka Mailchimpin pitäisi vastaanottaa, tai valitse **Valitse kaikki**. Katso luettelo alla.
  </Step>

  <Step title="Valitse Yhdistä">
    Näet **Integraatio yhdistetty**, ja Mailchimp näkyy **Yhdistetty**-välilehdellä.
  </Step>
</Steps>

<Frame caption="Mailchimp-kortti katalogissa">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/01-catalog-card-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=5aeca3b69967cd562cbbf6d80ad3ff7c" alt="Katalogi, jossa Mailchimp-kortti ja sen painikkeet Käytä automaatioissa, Lue lisää ja Yhdistä" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/01-catalog-card-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=82e1d473d8717ada831561141736b6ea" alt="Katalogi, jossa Mailchimp-kortti ja sen painikkeet Käytä automaatioissa, Lue lisää ja Yhdistä" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/01-catalog-card-dark.png" />
</Frame>

<Frame caption="Mailchimpin yhdistäminen: nimi, API-avain ja Audience ID">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/02-connect-modal-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=985514e6132badde78b9d3df9a7b8aa5" alt="Mailchimpin yhteysikkuna, jossa yhteyden nimi, API-avain, Audience ID ja tapahtumien valintaruudut" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/connect-mailchimp/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/02-connect-modal-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=7e9bb372af9df9db85705656ecdecf7f" alt="Mailchimpin yhteysikkuna, jossa yhteyden nimi, API-avain, Audience ID ja tapahtumien valintaruudut" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/connect-mailchimp/02-connect-modal-dark.png" />
</Frame>

| Kenttä | Pakollinen | Mitä syötetään |
| - | - | - |
| **Yhteyden nimi** | Kyllä | Mikä tahansa tunnistamasi nimi, enintään 100 merkkiä. |
| **API-avain** | Kyllä | Koko Mailchimpin API-avain. Se piilotetaan kirjoittaessasi, tallennetaan salattuna eikä sitä näytetä enää koskaan. |
| **Audience ID** | Kyllä | Sen yleisön tunnus, jossa asiakkaasi ovat. |

## Tapahtumat, joita Mailchimp voi vastaanottaa

| Valintaruutu | Lähetetään, kun |
| - | - |
| **Lähetys luotu** | Lähetys luodaan |
| **Lähetys lähetetty** | Lähetys lähetetään kuljetusyhtiölle ja sille on osoitekortti |
| **Lähetys peruttu** | Lähetys perutaan tai poistetaan |
| **Tilaus luotu** | Uusi tilaus saapuu |
| **Tilaus päivitetty** | Tilaus muuttuu |
| **Seuranta päivitetty** | Kuljetusyhtiö ilmoittaa uuden seurantaskannauksen |

<Frame caption="Mailchimpin tilaus- ja seurantatapahtumat">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/07-events-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=d65f7244fb036c77a30daa9dafb9d28d" alt="Mailchimpin yhteysikkuna vieritettynä tilaus- ja seurantatapahtumien valintaruutuihin" className="block dark:hidden" width="2880" height="2800" data-path="images/fi/how-to/connect-mailchimp/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/07-events-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=beb4d6ce86eff1225034097c2f125f5d" alt="Mailchimpin yhteysikkuna vieritettynä tilaus- ja seurantatapahtumien valintaruutuihin" className="hidden dark:block" width="2880" height="2800" data-path="images/fi/how-to/connect-mailchimp/07-events-dark.png" />
</Frame>

Mailchimpissa tapahtumien nimet ovat tapahtuman nimi alaviivoin kirjoitettuna, esimerkiksi `shipment_dispatched` tapahtumalle **Lähetys lähetetty**. Mailchimp tallentaa jokaisen tapahtuman asiakkaan sähköpostiosoitteella yhteystiedon alle, joten tapahtumaa tilaukselle ilman asiakkaan sähköpostiosoitetta ei voi toimittaa.

Jos haluat antaa tapahtumalle toisen nimen, lähetä se automaatiosta ja täytä **Oma tapahtuman nimi** (katso alla). Yhteysikkunassa ei ole sille kenttää.

## Tarkista yhteys

Valitse yhteysrivin paperilentokone (**Lähetä testitapahtuma**) ja avaa sitten toimituslokki (pistokekuvake). Testitapahtumalla ei ole asiakasta, joten Mailchimpin kohdalla se näyttää aina punaisen rastin ja viestin ”Asiakkaan sähköpostiosoitetta ei ole saatavilla: Mailchimp-tapahtumat vaativat yhteystiedon sähköpostiosoitteen”. Se on odotettua eikä kerro avaimestasi mitään. Tarkista yhteys sen sijaan oikealla tapahtumalla: lähetä lähetys tilaukselle, jolla on asiakkaan sähköpostiosoite, ja etsi vihreä merkki.

| Toimituslokissa näkyy | Mitä tehdä |
| - | - |
| ”Asiakkaan sähköpostiosoitetta ei ole saatavilla” | Tilauksella ei ole asiakkaan sähköpostiosoitetta. Mailchimpissa ei ole mitään korjattavaa. |
| 401 tai 403 | Mailchimp hylkäsi avaimen. Luo uusi avain ja liitä se. |
| 404 | Mailchimp ei löytänyt yleisöä tai asiakas ei kuulu siihen. Tarkista **Audience ID**. |

<Frame caption="Mailchimp-yhteys Yhdistetty-välilehdellä">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/03-connected-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=57d42bb009213f6e5e74e2db5bca398d" alt="Yhdistetty-välilehti, jossa Mailchimp-yhteys sekä testi-, toimituslokki-, muokkaus- ja poistokuvakkeet" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/03-connected-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=0abeb73b833ab6474e0e528a28ed0063" alt="Yhdistetty-välilehti, jossa Mailchimp-yhteys sekä testi-, toimituslokki-, muokkaus- ja poistokuvakkeet" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/03-connected-dark.png" />
</Frame>

<Frame caption="Toimituslokki ennen ensimmäistä tapahtumaa">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/05-delivery-log-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=8bb8c09247fa0d2e78913d5807f50f7d" alt="Mailchimp-yhteyden toimituslokki-ikkuna, jossa lukee Ei vielä toimituksia" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/05-delivery-log-light.png" />

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

## Avaimen vaihtaminen tai yhteyden katkaiseminen

Avaa **Muokkaa Mailchimp-yhteyttäsi** valitsemalla säädinkuvake. Jätä **API-avain** ja **Audience ID** tyhjiksi, jos haluat säilyttää tallennetut tiedot. Jos vaihdat toisen, täytä molemmat: kaikki, minkä kirjoitat, korvaa yhteyden kaikki tallennetut tiedot. Valitse **Tallenna muutokset**.

<Frame caption="Mailchimp-yhteyden muokkaus">
  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/04-edit-modal-light.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=4118713ffe517981939f581adbd6b192" alt="Mailchimp-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjät API-avain- ja Audience ID -kentät sekä tapahtumat" className="block dark:hidden" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/04-edit-modal-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=1e0d0a5ff94843b328d6d98eb04b6e91" alt="Mailchimp-yhteyden muokkausikkuna, jossa yhteyden nimi, tyhjät API-avain- ja Audience ID -kentät sekä tapahtumat" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/04-edit-modal-dark.png" />
</Frame>

Katkaise yhteys valitsemalla roskakorikuvake, kirjoittamalla DELETE ja valitsemalla **Katkaise yhteys**. Tämä pysäyttää kaikki tapahtumat Mailchimpiin ja poistaa toimituslokin.

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

  <img src="https://mintcdn.com/zippendo/Q6jjw4L4GwJn4F4r/images/fi/how-to/connect-mailchimp/06-disconnect-modal-dark.png?fit=max&auto=format&n=Q6jjw4L4GwJn4F4r&q=85&s=f0cccad49c3c17f5bf45868652179cf7" alt="Integraation yhteyden katkaisun ikkuna, jossa pyydetään kirjoittamaan DELETE" className="hidden dark:block" width="2880" height="1800" data-path="images/fi/how-to/connect-mailchimp/06-disconnect-modal-dark.png" />
</Frame>

## Mailchimpin käyttö automaatiossa

Lisää kohdassa **Automaatiot** vaihe **Lähetä Mailchimp-tapahtuma**. Se lähettää automaation käynnistäneen tapahtuman Mailchimpiin, mutta vain kun ehtosi täsmäävät.

| Kenttä | Pakollinen | Mitä se tekee |
| - | - | - |
| **Yhteys** | Kyllä | Valitse Mailchimp-yhteytesi luettelosta. Ilman sitä näet **Yhteys on pakollinen**. |
| **Oma tapahtuman nimi** | Ei | Tapahtuman nimi, jonka Mailchimp näyttää oletuksen sijaan. Mailchimp hyväksyy 2-30 pientä kirjainta, numeroa ja alaviivaa, ja nimen on alettava kirjaimella, esimerkiksi `parcel_on_its_way`. |
| **Mukautetut ominaisuudet** | Ei | Valitse **Lisää** lähettääksesi tapahtuman mukana lisätietoja, kuten lähetyksen viitteen. |

Automaation muun osan rakentamisesta kerrotaan sivulla [Automaatiot](/docs/fi/how-to/automations).

## Aiheeseen liittyvää

* [Integraation yhdistäminen](/docs/fi/how-to/connect-an-integration) - testi, toimituslokki, muokkaus ja yhteyden katkaisu kaikissa sovelluksissa
* [Mailchimp](/docs/fi/integrations/mailchimp) - pidempi opas
* [Integraatioiden vianmääritys](/docs/fi/integrations/troubleshooting)
* [Automaatiot](/docs/fi/how-to/automations)
* [Kuljetusyhtiön tai integraation yhdistäminen](/docs/fi/how-to/connect-index)


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