---
title: "Konektor Mailchimp"
description: "Kompletní průvodce integrací Mailchimp pro synchronizaci publik, kampaní, automatizací a dat o zapojení s Brevo přes Tajo."
url: https://tajo.io/cz/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/cz/docs/connectors/marketing/mailchimp.md
lang: cs-CZ
robots: noindex
---

Požádejte o přednostní přístup

Zadejte své jméno a pracovní e-mailovou adresu. Pošleme vám odkaz pro potvrzení žádosti o přístup k Tajo.

# Konektor Mailchimp

Stav konektoru: Ve vývoji Vzniká. Zatím neověřeno.

| Zdrojové pole | Cílové pole | Ukázková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Propojte svůj účet Mailchimp s Brevo přes Tajo pro bezproblémovou migraci publik, synchronizaci dat kampaní a sjednocenou marketingovou automatizaci napříč oběma platformami.

## Přehled

| Vlastnost | Hodnota |
| --- | --- |
| **Platforma** | Mailchimp |
| **Kategorie** | Marketing |
| **Složitost nastavení** | Snadná |
| **Oficiální integrace** | Ne |
| **Synchronizovaná data** | Kontakty, Kampaně, Automatizace, Události |
| **Základní URL API** | `https://{dc}.api.mailchimp.com/3.0` |

## Funkce

- **Synchronizace publik** – Migrujte a synchronizujte publika Mailchimp se seznamy kontaktů Brevo
- **Data kampaní** – Synchronizujte data výkonu kampaní pro sjednocené reportování
- **Migrace automatizací** – Mapujte automatizace Mailchimp na pracovní toky Brevo
- **Metriky zapojení** – Synchronizujte data o otevřeních, kliknutích a odrazech na atributy Brevo
- **Mapování segmentů** – Replikujte segmenty Mailchimp jako seznamy nebo segmenty Brevo
- **Data e-commerce** – Synchronizujte data obchodu, produktů a objednávek z e-commerce Mailchimp
- **Synchronizace štítků** – Mapujte štítky Mailchimp na atributy kontaktů Brevo nebo seznamy
- **Migrace šablon** – Exportujte šablony Mailchimp pro použití v kampaních Brevo

## Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet Mailchimp (Free, Essentials, Standard nebo Premium)
2. API klíč Mailchimp nebo OAuth aplikaci
3. Účet Brevo s přístupem k API
4. Účet Tajo

## Ověření

### Ověření API klíčem

Vygenerujte API klíč z Mailchimp Účet > Doplňky > API Keys.

```bash
curl https://{dc}.api.mailchimp.com/3.0/ping \
  --user "anystring:{api_key}" \
  -H "Content-Type: application/json"
```

Prefix datového centra `{dc}` je poslední část vašeho API klíče (např. `us21`).

### OAuth 2.0

Pro integrace s více účty:

```bash
# Autorizační URL
https://login.mailchimp.com/oauth2/authorize?
  response_type=code&
  client_id={client_id}&
  redirect_uri={redirect_uri}

# Výměna tokenů
curl -X POST https://login.mailchimp.com/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "client_id={client_id}" \
  -d "client_secret={client_secret}" \
  -d "redirect_uri={redirect_uri}" \
  -d "code={auth_code}"
```

Datové centrum

Vždy extrahujte datové centrum z vašeho API klíče nebo OAuth koncového bodu metadat. Použití nesprávného datového centra povede k selhání ověřování.

## Konfigurace

### Základní nastavení

```yaml
connectors:
  mailchimp:
    enabled: true
    api_key: "${MAILCHIMP_API_KEY}"
    data_center: "us21"

    # Možnosti synchronizace dat
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapování publika na seznam Brevo
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Mapování polí

Mapujte sloučená pole Mailchimp na atributy kontaktů Brevo:

#### Výchozí mapování

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | E-mail odběratele (jedinečný identifikátor) |
| `FNAME` optional | string | Sloučené pole křestního jména, mapuje se na FIRSTNAME |
| `LNAME` optional | string | Sloučené pole příjmení, mapuje se na LASTNAME |
| `PHONE` optional | string | Sloučené pole telefonu, mapuje se na SMS |
| `status` optional | string | Stav odběru (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Štítky odběratele pro segmentaci |
| `stats.avg_open_rate` optional | number | Průměrná míra otevření e-mailů |
| `stats.avg_click_rate` optional | number | Průměrná míra prokliku e-mailů |

#### Mapování vlastních sloučených polí

```yaml
field_mapping:
  # Standardní pole
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Metriky zapojení
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # Pole e-commerce
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Vlastní sloučená pole
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## Koncové body API

### Publika (Seznamy)

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Výpis všech publik |
| `GET` | `/3.0/lists/{list_id}` | Podrobnosti publika |
| `GET` | `/3.0/lists/{list_id}/members` | Výpis členů publika |
| `POST` | `/3.0/lists/{list_id}/members` | Přidání člena |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Aktualizace člena |
| `POST` | `/3.0/lists/{list_id}` | Dávkové přihlášení/odhlášení |

### Kampaně

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Výpis kampaní |
| `GET` | `/3.0/campaigns/{id}` | Podrobnosti kampaně |
| `GET` | `/3.0/reports/{id}` | Report kampaně |
| `GET` | `/3.0/reports/{id}/email-activity` | Aktivita e-mailů |

### Automatizace

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Výpis automatizací |
| `GET` | `/3.0/automations/{id}` | Podrobnosti automatizace |
| `GET` | `/3.0/automations/{id}/emails` | Výpis e-mailů automatizace |

### E-commerce

| Metoda | Koncový bod | Popis |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Výpis připojených obchodů |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Výpis zákazníků obchodu |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Výpis objednávek obchodu |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Výpis produktů obchodu |

## Události

### Události kampaní

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `campaign.sent` | Kampaň doručena | Sledování výkonu |
| `campaign.opened` | E-mail otevřen | Skórování zapojení |
| `campaign.clicked` | Kliknuto na odkaz | Sledování zájmu |
| `campaign.bounced` | E-mail se odrazil | Hygiena seznamu |

### Události odběratelů

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `subscribe` | Přidán nový odběratel | Uvítací tok |
| `unsubscribe` | Odběratel se odhlásil | Správa preferencí |
| `profile` | Profil aktualizován | Synchronizace atributů |
| `cleaned` | E-mail vyčištěn (odrazil se) | Správa seznamu |

### Události e-commerce

| Událost | Spouštěč | Případ použití |
| --- | --- | --- |
| `ecommerce.order` | Objednávka zadána | Tok po nákupu |
| `ecommerce.cart` | Košík aktualizován | Obnova opuštěného košíku |

## Příklady kódu

### Inicializace konektoru

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Připojení Mailchimp
await tajo.connectors.connect('mailchimp', {
  apiKey: process.env.MAILCHIMP_API_KEY
});
```

### Migrace publik do Brevo

```javascript
// Úplná migrace publik z Mailchimp do Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

// Kontrola stavu migrace
const status = await tajo.connectors.status('mailchimp');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 52000,
//   campaignsSynced: 245,
//   segmentsMapped: 18
// }
```

### Synchronizace dat o zapojení kampaní

```javascript
// Synchronizace výkonu kampaní na atributy Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Omezení rychlosti

Limity rychlosti Marketing API Mailchimp:

| Typ | Limit | Podrobnosti |
| --- | --- | --- |
| Standardní | 10 souběžných požadavků | Na API klíč |
| Dávkové operace | 500 operací na dávku | Na požadavek |
| Limit exportu | 1 souběžný export | Na účet |
| Transakční | 25 požadavků/sekundu | Na API klíč |

Strategie limitů rychlosti

Mailchimp omezuje souběžná připojení, nikoli požadavky za sekundu. Používejte dávkové koncové body a implementujte logiku opakování s exponenciálním zpětným odběráním při odpovědích `429`.

## Řešení problémů

### Časté problémy

| Problém | Příčina | Řešení |
| --- | --- | --- |
| 401 Unauthorized | Neplatný API klíč nebo špatné datové centrum | Ověřte API klíč a extrahujte správný prefix `dc` |
| Člen existuje | E-mail již v publiku | Používejte PUT místo POST pro aktualizaci existujících členů |
| Stav souladu | Smazání GDPR zabraňuje opětovnému přidání | Kontakt se musí znovu přihlásit přes registrační formulář |
| Timeout dávky | Velká dávková operace | Rozdělte na menší dávky po 500 operacích |
| Chybějící sloučená pole | Vlastní pole nejsou vytvořena | Vytvořte sloučená pole v Mailchimp před mapováním |

### Režim ladění

Povolte podrobné protokolování:

```yaml
connectors:
  mailchimp:
    debug: true
    log_level: verbose
    log_api_calls: true
```

### Test připojení

```bash
tajo connectors test mailchimp
# ✓ Připojení API úspěšné
# ✓ Publika čitelná
# ✓ Kampaně čitelné
# ✓ Data e-commerce přístupná
# ✓ Webhook nakonfigurován
```

## Osvědčené postupy

1. **Používejte dávkové operace** – Používejte dávkové přihlášení/odhlášení pro hromadné aktualizace
2. **Zachovejte stav odběru** – Respektujte souhlas s odběrem během migrace
3. **Nejprve mapujte sloučená pole** – Vytvořte odpovídající atributy Brevo před synchronizací
4. **Synchronizujte data o zapojení** – Importujte míry otevření/prokliku pro historickou segmentaci
5. **Zpracujte stavy souladu** – Respektujte stavy GDPR a trvalého smazání
6. **Používejte přírůstkovou synchronizaci** – Synchronizujte pouze změny od poslední synchronizace pro snížení využití API

## Zabezpečení

- **Ověřování API klíčem** – Tajný klíč předávaný jako heslo HTTP Basic Auth
- **OAuth 2.0** – Ověřování na základě tokenů pro přístup k více účtům
- **Šifrování TLS** – Veškerá API komunikace šifrovaná přes HTTPS
- **Ověření webhooků** – Ověřujte zdroj webhooku pomocí sdíleného tajného klíče
- **Izolace datového centra** – Data uložena v datových centrech specifických pro region

## Související zdroje

- [Reference Mailchimp Marketing API](https://mailchimp.com/developer/marketing/api/)
- [Průvodci Mailchimp API](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Konektor Brevo](https://tajo.io/cz/docs/connectors/marketing/brevo)
- [Konektor ActiveCampaign](https://tajo.io/cz/docs/connectors/marketing/activecampaign)
- [Dovednost synchronizace zákazníků](https://tajo.io/cz/docs/skills/data-sync/customer-sync)