---
title: "Mailchimp konektor"
description: "Kompletný sprievodca integráciou Mailchimp na synchronizáciu publík, kampaní, automatizácií a dát zapojenia s Brevo cez Tajo."
url: https://tajo.io/sk/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/sk/docs/connectors/marketing/mailchimp.md
lang: sk-SK
robots: noindex
---

Požiadajte o skorý prístup

Zadajte svoje meno a pracovnú e-mailovú adresu. Pošleme vám odkaz na potvrdenie žiadosti o prístup k Tajo.

# Mailchimp konektor

Stav konektora: Vo vývoji Vzniká. Zatiaľ neoverené.

| Zdrojové pole | Cieľové pole | Ukážková hodnota |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Prepoj svoj Mailchimp účet s Brevo cez Tajo pre bezproblémovú migráciu publík, synchronizáciu dát kampaní a zjednotenú marketingovú automatizáciu naprieč oboma platformami.

## Prehľad

| Vlastnosť | Hodnota |
| --- | --- |
| **Platforma** | Mailchimp |
| **Kategória** | Marketing |
| **Zložitosť nastavenia** | Ľahké |
| **Oficiálna integrácia** | Nie |
| **Synchronizované dáta** | Kontakty, Kampane, Automatizácie, Udalosti |
| **API Base URL** | `https://{dc}.api.mailchimp.com/3.0` |

## Funkcie

- **Synchronizácia publík** - Migruj a synchronizuj publiká Mailchimp so zoznamami kontaktov Brevo
- **Dáta kampaní** - Synchronizuj dáta výkonu kampaní pre jednotné reportovanie
- **Migrácia automatizácií** - Mapuj automatizácie Mailchimp na workflowy Brevo
- **Metriky zapojenia** - Synchronizuj otvárania, klikania a dáta odrazov na atribúty Brevo
- **Mapovanie segmentov** - Replikuj segmenty Mailchimp ako zoznamy alebo segmenty Brevo
- **E-commerce dáta** - Synchronizuj dáta obchodu, produktov a objednávok z Mailchimp e-commerce
- **Synchronizácia tagov** - Mapuj tagy Mailchimp na atribúty kontaktov Brevo alebo zoznamy
- **Migrácia šablón** - Exportuj šablóny Mailchimp na použitie v kampaniach Brevo

## Predpoklady

Predtým, než začneš, uisti sa, že máš:

1. Mailchimp účet (Free, Essentials, Standard alebo Premium)
2. Mailchimp API kľúč alebo OAuth aplikáciu
3. Brevo účet s API prístupom
4. Tajo účet

## Autentifikácia

### Autentifikácia API kľúčom

Vygeneruj API kľúč z Mailchimp Account > Extras > API Keys.

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

Prefix dátového centra `{dc}` je posledná časť tvojho API kľúča (napr. `us21`).

### OAuth 2.0

Pre integrácie s viacerými účtami:

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

# Token exchange
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}"
```

Dátové centrum

Vždy extrahuj dátové centrum z tvojho API kľúča alebo endpointu metadát OAuth. Použitie nesprávneho dátového centra spôsobí zlyhania autentifikácie.

## Konfigurácia

### Základné nastavenie

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

    # Data sync options
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Audience to Brevo list mapping
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Mapovanie polí

Namapuj zlučovacie polia Mailchimp na atribúty kontaktov Brevo:

#### Predvolené mapovania

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | E-mail odberateľa (unikátny identifikátor) |
| `FNAME` optional | string | Zlučovacie pole mena, mapuje sa na FIRSTNAME |
| `LNAME` optional | string | Zlučovacie pole priezviska, mapuje sa na LASTNAME |
| `PHONE` optional | string | Zlučovacie pole telefónu, mapuje sa na SMS |
| `status` optional | string | Stav odberu (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Tagy odberateľa pre segmentáciu |
| `stats.avg_open_rate` optional | number | Priemerná miera otvárania e-mailov |
| `stats.avg_click_rate` optional | number | Priemerná miera klikania na e-maily |

#### Mapovanie vlastných zlučovacích polí

```yaml
field_mapping:
  # Standard fields
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Engagement metrics
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

  # E-commerce fields
  ecommerce_data.total_revenue: TOTAL_REVENUE
  ecommerce_data.number_of_orders: ORDER_COUNT

  # Custom merge fields
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## API endpointy

### Publiká (Zoznamy)

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Zoznam všetkých publík |
| `GET` | `/3.0/lists/{list_id}` | Detaily publika |
| `GET` | `/3.0/lists/{list_id}/members` | Zoznam členov publika |
| `POST` | `/3.0/lists/{list_id}/members` | Pridanie člena |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Aktualizácia člena |
| `POST` | `/3.0/lists/{list_id}` | Dávková prihlásenie/odhlásenie |

### Kampane

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Zoznam kampaní |
| `GET` | `/3.0/campaigns/{id}` | Detaily kampane |
| `GET` | `/3.0/reports/{id}` | Report kampane |
| `GET` | `/3.0/reports/{id}/email-activity` | Aktivita e-mailov |

### Automatizácie

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Zoznam automatizácií |
| `GET` | `/3.0/automations/{id}` | Detaily automatizácie |
| `GET` | `/3.0/automations/{id}/emails` | Zoznam e-mailov automatizácie |

### E-commerce

| Metóda | Endpoint | Popis |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Zoznam prepojených obchodov |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Zoznam zákazníkov obchodu |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Zoznam objednávok obchodu |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Zoznam produktov obchodu |

## Udalosti

### Udalosti kampaní

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `campaign.sent` | Kampaň doručená | Sledovanie výkonu |
| `campaign.opened` | E-mail otvorený | Skórovanie zapojenia |
| `campaign.clicked` | Kliknutý odkaz | Sledovanie záujmu |
| `campaign.bounced` | E-mail odrazený | Hygiena zoznamu |

### Udalosti odberateľov

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `subscribe` | Pridaný nový odberateľ | Uvítací tok |
| `unsubscribe` | Odberateľ sa odhlásil | Správa preferencií |
| `profile` | Profil aktualizovaný | Synchronizácia atribútov |
| `cleaned` | E-mail vyčistený (odrazený) | Údržba zoznamu |

### E-commerce udalosti

| Udalosť | Trigger | Prípad použitia |
| --- | --- | --- |
| `ecommerce.order` | Zadaná objednávka | Tok po nákupe |
| `ecommerce.cart` | Aktualizovaný košík | Obnova opusteného košíka |

## Ukážky kódu

### Inicializácia konektora

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

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

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

### Migrácia publík do Brevo

```javascript
// Full audience migration from Mailchimp to Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

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

### Synchronizácia dát zapojenia kampaní

```javascript
// Sync campaign performance to Brevo attributes
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Obmedzenia rýchlosti

Limity rýchlosti Mailchimp Marketing API:

| Typ | Limit | Detaily |
| --- | --- | --- |
| Štandard | 10 súbežných požiadaviek | Na API kľúč |
| Dávkové operácie | 500 operácií na dávku | Na požiadavku |
| Limit exportu | 1 súbežný export | Na účet |
| Transakčné | 25 požiadaviek/sekundu | Na API kľúč |

Stratégia limitov rýchlosti

Mailchimp obmedzuje súbežné pripojenia, nie požiadavky za sekundu. Použi dávkové endpointy a implementuj logiku opakovania s exponenciálnym backoff pri odpovediach `429`.

## Riešenie problémov

### Bežné problémy

| Problém | Príčina | Riešenie |
| --- | --- | --- |
| 401 Unauthorized | Neplatný API kľúč alebo nesprávne dátové centrum | Overte API kľúč a extrahuj správny prefix `dc` |
| Člen existuje | E-mail je už v publiku | Použi PUT namiesto POST na aktualizáciu existujúcich členov |
| Stav súladu | GDPR zmazanie zabraňuje opätovnému pridaniu | Kontakt musí znovu prihlásiť cez prihlasovací formulár |
| Timeout dávky | Veľká dávková operácia | Rozdeľ na menšie dávky po 500 operácií |
| Chýbajúce zlučovacie polia | Vlastné polia nie sú vytvorené | Vytvor zlučovacie polia v Mailchimp pred mapovaním |

### Debug režim

Zapni verbose logovanie:

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

### Test pripojenia

```bash
tajo connectors test mailchimp
# ✓ API connection successful
# ✓ Audiences readable
# ✓ Campaigns readable
# ✓ E-commerce data accessible
# ✓ Webhook configured
```

## Odporúčané postupy

1. **Použi dávkové operácie** - Použi dávkové prihlásenie/odhlásenie pre hromadné aktualizácie
2. **Zachovaj stav odberu** - Rešpektuj súhlas s odberom počas migrácie
3. **Najprv mapuj zlučovacie polia** - Vytvor zodpovedajúce atribúty Brevo pred synchronizáciou
4. **Synchronizuj dáta zapojenia** - Importuj miery otvárania/klikania pre historickú segmentáciu
5. **Spravuj stavy súladu** - Rešpektuj stavy GDPR a trvalého zmazania
6. **Použi inkrementálnu synchronizáciu** - Synchronizuj iba zmeny od poslednej synchronizácie na zníženie využitia API

## Bezpečnosť

- **Autentifikácia API kľúčom** - Tajný kľúč prenášaný ako heslo HTTP Basic Auth
- **OAuth 2.0** - Autorizácia na základe tokenov pre prístup k viacerým účtom
- **TLS šifrovanie** - Všetka API komunikácia šifrovaná cez HTTPS
- **Overenie webhookov** - Validuj zdroj webhookov so zdieľaným secretom
- **Izolácia dátového centra** - Dáta uložené v regionálnych dátových centrách

## Súvisiace zdroje

- [Mailchimp Marketing API referencia](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API sprievodcovia](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo konektor](https://tajo.io/sk/docs/connectors/marketing/brevo)
- [ActiveCampaign konektor](https://tajo.io/sk/docs/connectors/marketing/activecampaign)
- [Customer Sync skill](https://tajo.io/sk/docs/skills/data-sync/customer-sync)