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

# Mailchimp koppelen

> Koppel Mailchimp onder Apps en integraties met een API key en een Audience ID en kies welke gebeurtenissen over zendingen, bestellingen en track & trace je Mailchimp-e-mails starten.

Mailchimp ontvangt je gebeurtenissen over zendingen, bestellingen en track & trace en legt elke gebeurtenis vast bij het bijbehorende contact in een van je audiences. In Mailchimp kun je die gebeurtenissen gebruiken om e-mails te starten, bijvoorbeeld "je pakket is onderweg". Mailchimp verstuurt de e-mails vanuit je eigen Mailchimp-account. Zippendo geeft alleen de gebeurtenissen door.

Integraties zijn inbegrepen bij elk abonnement. Testen, het afleverlogboek, bewerken en ontkoppelen werken voor elke app hetzelfde: zie [Slack, Klaviyo en andere apps koppelen](/docs/nl/how-to/connect-an-integration). De uitgebreidere handleiding is [Mailchimp](/docs/nl/integrations/mailchimp).

## Voordat je begint

Je hebt twee dingen nodig uit je Mailchimp-account:

* **Een API key.** Genereer die in je Mailchimp-account. Kopieer de hele sleutel, inclusief het einde zoals `-us21`: Zippendo gebruikt dat einde om je Mailchimp-account te bereiken.
* **De audience-ID** van de audience waar je klanten in zitten. Die vind je in Mailchimp onder Audience → Settings → Audience name and defaults. Gebruik de ID, niet de naam van de audience.

<Frame caption="Het helpartikel van Mailchimp over API keys">
  <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="Helpartikel About API Keys van Mailchimp met een onderdeel Generate an API key" width="2880" height="2200" data-path="images/how-to/connect-mailchimp/10-mailchimp-about-api-keys.png" />
</Frame>

## Mailchimp koppelen

<Steps>
  <Step title="Mailchimp zoeken in de catalogus">
    Klik in de zijbalk op **Apps en integraties** en dan op **Catalogus**. Mailchimp staat onder **Apps**. Klik op **Koppelen**, of op **Koppeling toevoegen** als je er al een hebt.
  </Step>

  <Step title="Toegang bekijken">
    Lees wat Zippendo met de koppeling gaat doen en klik op **Doorgaan**.
  </Step>

  <Step title="De koppelingsgegevens invullen">
    Typ een **Naam koppeling**, zoals "Mailchimp-nieuwsbrief". Plak de sleutel in **API-sleutel** en de audience-ID in **Audience ID**.
  </Step>

  <Step title="De gebeurtenissen kiezen">
    Vink de gebeurtenissen aan die Mailchimp moet ontvangen, of klik op **Alles selecteren**. Zie de lijst hieronder.
  </Step>

  <Step title="Op Koppelen klikken">
    Je ziet **Integratie gekoppeld** en Mailchimp staat op het tabblad **Gekoppeld**.
  </Step>
</Steps>

<Frame caption="De Mailchimp-kaart in de catalogus">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/01-catalog-card-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=cb624f8b6f7ccc259e77fc0554fd1266" alt="Catalogus met de Mailchimp-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/01-catalog-card-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/01-catalog-card-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=ab2e1f5aad359d3c3a17530991ff3945" alt="Catalogus met de Mailchimp-kaart en de knoppen Gebruiken in automatiseringen, Meer lezen en Koppelen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/01-catalog-card-dark.png" />
</Frame>

<Frame caption="Mailchimp koppelen: een naam, de API-sleutel en de Audience ID">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/02-connect-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=5d50b204441937dca5ec98fdad0ece7f" alt="Koppelingsvenster voor Mailchimp met een naam voor de koppeling, API-sleutel, Audience ID en selectievakjes voor gebeurtenissen" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/connect-mailchimp/02-connect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/02-connect-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=aabb5365a490fdf14cfeaa774b13856a" alt="Koppelingsvenster voor Mailchimp met een naam voor de koppeling, API-sleutel, Audience ID en selectievakjes voor gebeurtenissen" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/connect-mailchimp/02-connect-modal-dark.png" />
</Frame>

| Veld | Verplicht | Wat je invult |
| - | - | - |
| **Naam koppeling** | Ja | Een naam die je herkent, maximaal 100 tekens. |
| **API-sleutel** | Ja | De hele Mailchimp API key. Hij is verborgen terwijl je typt, wordt versleuteld opgeslagen en nooit meer getoond. |
| **Audience ID** | Ja | De ID van de audience waar je klanten in zitten. |

## Gebeurtenissen die Mailchimp kan ontvangen

| Selectievakje | Verstuurd wanneer |
| - | - |
| **Zending aangemaakt** | Er een zending wordt aangemaakt |
| **Zending verzonden** | Een zending naar de vervoerder is gestuurd en zijn verzendlabel heeft |
| **Zending geannuleerd** | Een zending wordt geannuleerd of verwijderd |
| **Bestelling aangemaakt** | Er een nieuwe bestelling binnenkomt |
| **Bestelling bijgewerkt** | Een bestelling verandert |
| **Track & trace bijgewerkt** | De vervoerder een nieuwe trackingscan meldt |

<Frame caption="De gebeurtenissen voor bestellingen en track & trace voor Mailchimp">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/07-events-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=07633bf6f0a67eb072e4e195f9803dc7" alt="Mailchimp-koppelingsvenster gescrold naar de selectievakjes voor bestel- en trackinggebeurtenissen" className="block dark:hidden" width="2880" height="2800" data-path="images/nl/how-to/connect-mailchimp/07-events-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/07-events-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=5f131945dee94e82ce24ed1162558120" alt="Mailchimp-koppelingsvenster gescrold naar de selectievakjes voor bestel- en trackinggebeurtenissen" className="hidden dark:block" width="2880" height="2800" data-path="images/nl/how-to/connect-mailchimp/07-events-dark.png" />
</Frame>

In Mailchimp heten de gebeurtenissen zoals de gebeurtenis met underscores, zoals `shipment_dispatched` voor **Zending verzonden**. Mailchimp legt elke gebeurtenis vast bij het contact met het e-mailadres van de klant, dus een gebeurtenis voor een bestelling zonder e-mailadres van de klant kan niet worden afgeleverd.

Om een gebeurtenis een andere naam te geven, verstuur je hem vanuit een automatisering en vul je **Eigen gebeurtenisnaam** in (zie hieronder). Het koppelingsvenster heeft daar geen veld voor.

## De koppeling controleren

Klik op het papieren vliegtuigje op de rij van de koppeling (**Testgebeurtenis verzenden**) en open dan het afleverlogboek (het stekkericoon). Een testgebeurtenis heeft geen klant, dus bij Mailchimp toont hij altijd een rood kruis met "No customer email available — Mailchimp events require a contact email". Dat is normaal en zegt niets over je sleutel. Controleer met een echte gebeurtenis: verzend een zending voor een bestelling met het e-mailadres van een klant en zoek naar een groen vinkje.

| Het afleverlogboek toont | Wat je moet doen |
| - | - |
| "No customer email available" | De bestelling heeft geen e-mailadres van de klant. In Mailchimp valt niets te herstellen. |
| 401 of 403 | Mailchimp heeft de sleutel geweigerd. Genereer een nieuwe sleutel en plak die erin. |
| 404 | Mailchimp kon de audience niet vinden, of de klant zit er niet in. Controleer de **Audience ID**. |

<Frame caption="Een Mailchimp-koppeling op het tabblad Gekoppeld">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/03-connected-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=9904307fdc74b465312c3b536643d27c" alt="Tabblad Gekoppeld met een Mailchimp-koppeling en de pictogrammen voor testen, afleverlogboek, bewerken en verwijderen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/03-connected-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/03-connected-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=bbca9486ca72f8ab367178b1ccdf47bb" alt="Tabblad Gekoppeld met een Mailchimp-koppeling en de pictogrammen voor testen, afleverlogboek, bewerken en verwijderen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/03-connected-dark.png" />
</Frame>

<Frame caption="Het afleverlogboek vóór de eerste gebeurtenis">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/05-delivery-log-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=43e9b49f881dbc513c410cb05786ca70" alt="Venster met het afleverlogboek van een Mailchimp-koppeling met de melding Nog geen afleveringen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/05-delivery-log-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/05-delivery-log-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=c402b002b85220ad9a9b8c42502a41b3" alt="Venster met het afleverlogboek van een Mailchimp-koppeling met de melding Nog geen afleveringen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/05-delivery-log-dark.png" />
</Frame>

## De sleutel wijzigen of ontkoppelen

Klik op het schuifregelaarpictogram om **Je koppeling met Mailchimp bewerken** te openen. Laat **API-sleutel** en **Audience ID** leeg om te behouden wat is opgeslagen. Wijzig je een van beide, vul dan beide in: alles wat je typt, vervangt alles wat voor de koppeling is opgeslagen. Klik op **Wijzigingen opslaan**.

<Frame caption="Een Mailchimp-koppeling bewerken">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/04-edit-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=c73c56def2a1884395d220ac0844f69d" alt="Bewerkvenster voor een Mailchimp-koppeling met de naam van de koppeling, lege velden voor API-sleutel en Audience ID en de gebeurtenissen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/04-edit-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/04-edit-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=effba1bb14a40e4205fcea07472c1c43" alt="Bewerkvenster voor een Mailchimp-koppeling met de naam van de koppeling, lege velden voor API-sleutel en Audience ID en de gebeurtenissen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/04-edit-modal-dark.png" />
</Frame>

Om te ontkoppelen, klik je op de prullenbak, typ je VERWIJDEREN en klik je op **Ontkoppelen**. Hiermee stopt alles wat naar Mailchimp wordt gestuurd en wordt het afleverlogboek verwijderd.

<Frame caption="Typ VERWIJDEREN om te ontkoppelen">
  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/06-disconnect-modal-light.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=186bd1a00968657850981b3411506ae1" alt="Venster Integratie ontkoppelen waarin je wordt gevraagd VERWIJDEREN te typen" className="block dark:hidden" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/06-disconnect-modal-light.png" />

  <img src="https://mintcdn.com/zippendo/7AIZdruzSY49x12v/images/nl/how-to/connect-mailchimp/06-disconnect-modal-dark.png?fit=max&auto=format&n=7AIZdruzSY49x12v&q=85&s=4502cb2f811944c3ca8f267bc7be2bee" alt="Venster Integratie ontkoppelen waarin je wordt gevraagd VERWIJDEREN te typen" className="hidden dark:block" width="2880" height="1800" data-path="images/nl/how-to/connect-mailchimp/06-disconnect-modal-dark.png" />
</Frame>

## Mailchimp gebruiken in een automatisering

Voeg bij **Automatiseringen** de stap **Mailchimp-gebeurtenis verzenden** toe. Die stuurt de gebeurtenis die de automatisering startte naar Mailchimp, maar alleen als je voorwaarden kloppen.

| Veld | Verplicht | Wat het doet |
| - | - | - |
| **Koppeling** | Ja | Kies je Mailchimp-koppeling in de lijst. Zonder koppeling zie je **Koppeling is verplicht**. |
| **Eigen gebeurtenisnaam** | Nee | De gebeurtenisnaam die Mailchimp toont in plaats van de standaardnaam. Mailchimp accepteert 2 tot 30 kleine letters, cijfers en underscores, beginnend met een letter, zoals `parcel_on_its_way`. |
| **Eigen eigenschappen** | Nee | Klik op **Toevoegen** om extra gegevens met de gebeurtenis mee te sturen, zoals de zendingreferentie. |

Zie [Een automatisering bouwen](/docs/nl/how-to/automations) voor de rest van de automatisering.

## Gerelateerd

* [Slack, Klaviyo en andere apps koppelen](/docs/nl/how-to/connect-an-integration) - testen, afleverlogboek, bewerken en ontkoppelen voor elke app
* [Mailchimp](/docs/nl/integrations/mailchimp) - de uitgebreidere handleiding
* [Problemen met integraties oplossen](/docs/nl/integrations/troubleshooting)
* [Een automatisering bouwen](/docs/nl/how-to/automations)
* [Een vervoerder of integratie koppelen](/docs/nl/how-to/connect-index)


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