---
title: "Mailchimp Konektor"
description: "Kompletan vodič za integraciju Mailchimpa za sinkronizaciju publika, kampanja, automatizacija i podataka o angažmanu s Brevom putem Taja."
url: https://tajo.io/hr/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/hr/docs/connectors/marketing/mailchimp.md
lang: hr-HR
robots: noindex
---

Zatražite rani pristup

Unesite ime i poslovnu adresu e-pošte. Poslat ćemo vam poveznicu za potvrdu zahtjeva za pristup Taju.

# Mailchimp Konektor

Status konektora: U izradi Gradi se. Još nije provjereno.

| Izvorno polje | Odredišno polje | Primjer vrijednosti |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Povežite vaš Mailchimp račun s Brevom putem Taja za besprijekornu migraciju publike, sinkronizaciju podataka o kampanjama i ujedinjenu marketinšku automatizaciju na obje platforme.

## Pregled

| Svojstvo | Vrijednost |
| --- | --- |
| **Platforma** | Mailchimp |
| **Kategorija** | Marketing |
| **Složenost postavljanja** | Jednostavno |
| **Službena integracija** | Ne |
| **Sinkronizirani podaci** | Kontakti, Kampanje, Automatizacije, Događaji |
| **Osnovni URL API-ja** | `https://{dc}.api.mailchimp.com/3.0` |

## Značajke

- **Sinkronizacija publike** - Migracija i sinkronizacija Mailchimp publika s Brevo popisima kontakata
- **Podaci o kampanjama** - Sinkronizacija podataka o performansama kampanje za ujedinjeno izvješćivanje
- **Migracija automatizacija** - Mapiranje Mailchimp automatizacija na Brevo tijekove rada
- **Metrike angažmana** - Sinkronizacija otvaranja, klikova i podataka o vraćenim porukama na Brevo atribute
- **Mapiranje segmenata** - Replikacija Mailchimp segmenata kao Brevo popisa ili segmenata
- **E-commerce podaci** - Sinkronizacija podataka o trgovini, proizvodu i narudžbi iz Mailchimp e-commerce
- **Sinkronizacija oznaka** - Mapiranje Mailchimp oznaka na Brevo atribute kontakata ili popise
- **Migracija predložaka** - Izvoz Mailchimp predložaka za korištenje u Brevo kampanjama

## Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. Mailchimp račun (Free, Essentials, Standard ili Premium)
2. Mailchimp API ključ ili OAuth aplikaciju
3. Brevo račun s API pristupom
4. Tajo račun

## Autentifikacija

### Autentifikacija API ključem

Generirajte API ključ u Mailchimp Računu > Extras > API ključevi.

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

Prefiks podatkovnog centra `{dc}` je zadnji dio vašeg API ključa (npr. `us21`).

### OAuth 2.0

Za integracije s više računa:

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

# Razmjena tokena
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}"
```

Podatkovni centar

Uvijek izvucite podatkovni centar iz vašeg API ključa ili OAuth metadata krajnje točke. Korištenje pogrešnog podatkovnog centra rezultirat će neuspjehom autentifikacije.

## Konfiguracija

### Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      audiences: true
      campaigns: true
      automations: true
      ecommerce: true

    # Mapiranje publike na Brevo popis
    audience_mapping:
      "Main Audience": 40
      "Newsletter": 41
      "Customers": 42
```

### Mapiranje polja

Mapirajte Mailchimp merge polja na Brevo atribute kontakata:

#### Zadana mapiranja

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | E-mail pretplatnika (jedinstveni identifikator) |
| `FNAME` optional | string | Merge polje za ime, mapira se na FIRSTNAME |
| `LNAME` optional | string | Merge polje za prezime, mapira se na LASTNAME |
| `PHONE` optional | string | Merge polje za telefon, mapira se na SMS |
| `status` optional | string | Status pretplate (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Oznake pretplatnika za segmentaciju |
| `stats.avg_open_rate` optional | number | Prosječna stopa otvaranja e-maila |
| `stats.avg_click_rate` optional | number | Prosječna stopa klikanja e-maila |

#### Mapiranje prilagođenih merge polja

```yaml
field_mapping:
  # Standardna polja
  email_address: email
  FNAME: FIRSTNAME
  LNAME: LASTNAME
  PHONE: SMS

  # Metrike angažmana
  stats.avg_open_rate: AVG_OPEN_RATE
  stats.avg_click_rate: AVG_CLICK_RATE
  member_rating: ENGAGEMENT_SCORE

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

  # Prilagođena merge polja
  MMERGE5: COMPANY_NAME
  MMERGE6: CUSTOMER_TYPE
```

## API krajnje točke

### Publike (Popisi)

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Popis svih publika |
| `GET` | `/3.0/lists/{list_id}` | Dohvati detalje publike |
| `GET` | `/3.0/lists/{list_id}/members` | Popis članova publike |
| `POST` | `/3.0/lists/{list_id}/members` | Dodaj člana |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Ažuriraj člana |
| `POST` | `/3.0/lists/{list_id}` | Skupna prijava/odjava |

### Kampanje

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Popis kampanja |
| `GET` | `/3.0/campaigns/{id}` | Dohvati detalje kampanje |
| `GET` | `/3.0/reports/{id}` | Dohvati izvješće o kampanji |
| `GET` | `/3.0/reports/{id}/email-activity` | Dohvati aktivnost e-maila |

### Automatizacije

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Popis automatizacija |
| `GET` | `/3.0/automations/{id}` | Dohvati detalje automatizacije |
| `GET` | `/3.0/automations/{id}/emails` | Popis e-mailova automatizacije |

### E-commerce

| Metoda | Krajnja točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Popis povezanih trgovina |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Popis kupaca trgovine |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Popis narudžbi trgovine |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Popis proizvoda trgovine |

## Događaji

### Događaji kampanja

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `campaign.sent` | Kampanja dostavljena | Praćenje performansi |
| `campaign.opened` | E-mail otvoren | Ocjenjivanje angažmana |
| `campaign.clicked` | Kliknuta veza | Praćenje interesa |
| `campaign.bounced` | E-mail vraćen | Higijena popisa |

### Događaji pretplatnika

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `subscribe` | Dodan novi pretplatnik | Tijek dobrodošlice |
| `unsubscribe` | Pretplatnik se odjavio | Upravljanje preferencijama |
| `profile` | Profil ažuriran | Sinkronizacija atributa |
| `cleaned` | E-mail očišćen (vraćen) | Održavanje popisa |

### E-commerce događaji

| Događaj | Okidač | Slučaj upotrebe |
| --- | --- | --- |
| `ecommerce.order` | Narudžba izvršena | Tijek nakon kupnje |
| `ecommerce.cart` | Košarica ažurirana | Oporavak napuštene košarice |

## Primjeri koda

### Inicijalizacija konektora

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

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

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

### Migracija publika u Brevo

```javascript
// Potpuna migracija publike iz Mailchimpa u Brevo
await tajo.connectors.sync('mailchimp', {
  type: 'full',
  resources: ['audiences', 'campaigns', 'ecommerce'],
  options: {
    preserveTags: true,
    migrateSegments: true,
    includeUnsubscribed: false
  }
});

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

### Sinkronizacija podataka o angažmanu kampanje

```javascript
// Sinkronizacija performansi kampanje na Brevo atribute
await tajo.connectors.sync('mailchimp', {
  type: 'incremental',
  resources: ['campaigns'],
  options: {
    syncEngagement: true,
    updateContactMetrics: true,
    since: '2024-01-01'
  }
});
```

## Ograničenja brzine

Ograničenja brzine Mailchimp Marketing API-ja:

| Vrsta | Ograničenje | Detalji |
| --- | --- | --- |
| Standard | 10 istovremenih zahtjeva | Po API ključu |
| Skupne operacije | 500 operacija po seriji | Po zahtjevu |
| Ograničenje izvoza | 1 istovremeni izvoz | Po računu |
| Transakcijsko | 25 zahtjeva/sekundi | Po API ključu |

Strategija ograničenja brzine

Mailchimp ograničava istovremene veze, a ne zahtjeve u sekundi. Koristite skupne krajnje točke i implementirajte logiku ponovnog pokušaja s eksponencijalnim povratkom na odgovore `429`.

## Rješavanje problema

### Uobičajeni problemi

| Problem | Uzrok | Rješenje |
| --- | --- | --- |
| 401 Unauthorized | Nevažeći API ključ ili pogrešan podatkovni centar | Verificirajte API ključ i izvucite ispravni prefiks `dc` |
| Član postoji | E-mail već u publici | Koristite PUT umjesto POST za ažuriranje postojećih članova |
| Stanje usklađenosti | GDPR brisanje sprječava ponovni unos | Kontakt se mora ponovo prijaviti putem obrasca za prijavu |
| Vremensko ograničenje serije | Velika skupna operacija | Podijelite na manje serije od 500 operacija |
| Nedostaju merge polja | Prilagođena polja nisu kreirana | Kreirajte merge polja u Mailchimpu prije mapiranja |

### Način otklanjanja grešaka

Omogućite detaljno zapisivanje:

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

### Testiranje veze

```bash
tajo connectors test mailchimp
# ✓ API veza uspješna
# ✓ Publike čitljive
# ✓ Kampanje čitljive
# ✓ E-commerce podaci dostupni
# ✓ Webhook konfiguriran
```

## Preporučene prakse

1. **Koristite skupne operacije** - Koristite skupnu prijavu/odjavu za skupna ažuriranja
2. **Čuvajte status pretplatnika** - Poštujte suglasnost za pretplatu tokom migracije
3. **Prvo mapirajte merge polja** - Kreirajte odgovarajuće Brevo atribute prije sinkronizacije
4. **Sinkronizirajte podatke o angažmanu** - Uvezite stope otvaranja/klikanja za historijsku segmentaciju
5. **Rukujte stanjima usklađenosti** - Poštujte GDPR i stanja trajnog brisanja
6. **Koristite inkrementalnu sinkronizaciju** - Sinkronizirajte samo promjene od posljednje sinkronizacije za smanjenje korištenja API-ja

## Sigurnost

- **Autentifikacija API ključem** - Tajni ključ proslijeđen kao lozinka HTTP Basic Auth
- **OAuth 2.0** - Autorizacija temeljena na tokenima za pristup s više računa
- **TLS šifriranje** - Sva API komunikacija šifrirana putem HTTPS-a
- **Verifikacija webhookova** - Validacija izvora webhookova s dijeljenom tajnom
- **Izolacija podatkovnih centara** - Podaci pohranjeni u regionalnim podatkovnim centrima

## Povezani resursi

- [Mailchimp Marketing API referenca](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp vodiči za API](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo Konektor](https://tajo.io/hr/docs/connectors/marketing/brevo)
- [ActiveCampaign Konektor](https://tajo.io/hr/docs/connectors/marketing/activecampaign)
- [Vještina sinkronizacije korisnika](https://tajo.io/hr/docs/skills/data-sync/customer-sync)