---
title: "Mailchimp Connector"
description: "Popoln vodnik za integracijo Mailchimp za sinhronizacijo občinstev, kampanj, avtomatizacij in angažirnih podatkov z Brevo prek Tajo."
url: https://tajo.io/sl/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/sl/docs/connectors/marketing/mailchimp.md
lang: sl-SI
robots: noindex
---

Zaprosite za zgodnji dostop

Vnesite svoje ime in službeni e-poštni naslov. Poslali vam bomo povezavo za potrditev zahteve za dostop do Taja.

# Mailchimp Connector

Stanje konektorja: V razvoju V izdelavi. Še ni preverjeno.

| Izvorno polje | Ciljno polje | Vzorčna vrednost |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Poveži račun Mailchimp z Brevo prek Tajo za nemoteno migracijo občinstev, sinhronizacijo podatkov kampanj in enotno marketinško avtomatizacijo na obeh platformah.

## Pregled

| Lastnost | Vrednost |
| --- | --- |
| **Platforma** | Mailchimp |
| **Kategorija** | Marketing |
| **Zahtevnost nastavitve** | Enostavna |
| **Uradna integracija** | Ne |
| **Sinhronizirani podatki** | Stiki, kampanje, avtomatizacije, dogodki |
| **Osnovni URL API** | `https://{dc}.api.mailchimp.com/3.0` |

## Funkcionalnosti

- **Sinhronizacija občinstev** – prenesi in sinhroniziraj občinstva Mailchimp z seznami stikov Brevo
- **Podatki kampanj** – sinhroniziraj podatke o uspešnosti kampanj za enotno poročanje
- **Migracija avtomatizacij** – preslikaj avtomatizacije Mailchimp v delovne tokove Brevo
- **Metrike angažiranosti** – sinhroniziraj odprtja, klike in podatke o odbitinicah v atribute Brevo
- **Preslikava segmentov** – replicira segmente Mailchimp kot sezname ali segmente Brevo
- **Podatki e-trgovine** – sinhroniziraj podatke o trgovini, izdelkih in naročilih iz e-trgovine Mailchimp
- **Sinhronizacija oznak** – preslikaj oznake Mailchimp v atribute stikov Brevo ali sezname
- **Migracija predlog** – izvozi predloge Mailchimp za uporabo v kampanjah Brevo

## Predpogoji

Preden začneš, se prepričaj, da imaš:

1. Račun Mailchimp (Free, Essentials, Standard ali Premium)
2. Ključ API Mailchimp ali OAuth aplikacijo
3. Brevo račun z dostopom do API
4. Tajo račun

## Avtentikacija

### Avtentikacija z API ključem

Ustvari ključ API iz Mailchimp Account > Extras > API Keys.

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

Predpona podatkovnega centra `{dc}` je zadnji del tvojega API ključa (npr. `us21`).

### OAuth 2.0

Za integracije z več računi:

```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}"
```

Podatkovni center

Vedno ekstrahiraj podatkovni center iz API ključa ali končne točke metapodatkov OAuth. Uporaba napačnega podatkovnega centra bo povzročila napake pri avtentikaciji.

## Konfiguracija

### Osnovna nastavitev

```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
```

### Preslikava polj

Preslikaj zlivna polja Mailchimp v atribute stikov Brevo:

#### Privzete preslikave

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | E-mail naročnika (enolični identifikator) |
| `FNAME` optional | string | Zlivno polje za ime, preslika se v FIRSTNAME |
| `LNAME` optional | string | Zlivno polje za priimek, preslika se v LASTNAME |
| `PHONE` optional | string | Zlivno polje za telefon, preslika se v SMS |
| `status` optional | string | Status naročnine (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Oznake naročnika za segmentacijo |
| `stats.avg_open_rate` optional | number | Povprečna stopnja odpiranja e-mailov |
| `stats.avg_click_rate` optional | number | Povprečna stopnja klikov na e-mail |

#### Preslikava zlivnih polj po meri

```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
```

## Končne točke API

### Občinstva (seznami)

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Seznam vseh občinstev |
| `GET` | `/3.0/lists/{list_id}` | Pridobi podrobnosti o občinstvu |
| `GET` | `/3.0/lists/{list_id}/members` | Seznam članov občinstva |
| `POST` | `/3.0/lists/{list_id}/members` | Dodaj člana |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Posodobi člana |
| `POST` | `/3.0/lists/{list_id}` | Množična naročnina/odjava |

### Kampanje

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Seznam kampanj |
| `GET` | `/3.0/campaigns/{id}` | Pridobi podrobnosti kampanje |
| `GET` | `/3.0/reports/{id}` | Pridobi poročilo o kampanji |
| `GET` | `/3.0/reports/{id}/email-activity` | Pridobi aktivnost e-maila |

### Avtomatizacije

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Seznam avtomatizacij |
| `GET` | `/3.0/automations/{id}` | Pridobi podrobnosti avtomatizacije |
| `GET` | `/3.0/automations/{id}/emails` | Seznam e-mailov avtomatizacije |

### E-trgovina

| Metoda | Končna točka | Opis |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Seznam povezanih trgovin |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Seznam strank trgovine |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Seznam naročil trgovine |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Seznam izdelkov trgovine |

## Dogodki

### Dogodki kampanj

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `campaign.sent` | Dostavljena kampanja | Sledenje uspešnosti |
| `campaign.opened` | Odprt e-mail | Ocenjevanje angažiranosti |
| `campaign.clicked` | Kliknjena povezava | Sledenje zanimanja |
| `campaign.bounced` | Odbitnica e-maila | Higiena seznama |

### Dogodki naročnikov

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `subscribe` | Dodan nov naročnik | Pozdravni tok |
| `unsubscribe` | Naročnik odjavil naročnino | Upravljanje nastavitev |
| `profile` | Posodobljen profil | Sinhronizacija atributov |
| `cleaned` | Počiščen e-mail (odbitnica) | Vzdrževanje seznama |

### Dogodki e-trgovine

| Dogodek | Sprožilec | Primer uporabe |
| --- | --- | --- |
| `ecommerce.order` | Oddano naročilo | Tok po nakupu |
| `ecommerce.cart` | Posodobljena košarica | Obnova opuščene košarice |

## Primeri kode

### Inicializacija konektorja

```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
});
```

### Migracija občinstev v 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
// }
```

### Sinhronizacija angažirnih podatkov kampanj

```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'
  }
});
```

## Omejitve hitrosti

Omejitve hitrosti Mailchimp Marketing API:

| Vrsta | Omejitev | Podrobnosti |
| --- | --- | --- |
| Standardna | 10 vzporednih zahtevkov | Na API ključ |
| Paketne operacije | 500 operacij na paket | Na zahtevek |
| Omejitev izvoza | 1 vzporeden izvoz | Na račun |
| Transakcijsko | 25 zahtevkov/sekundo | Na API ključ |

Strategija omejitev hitrosti

Mailchimp omejuje vzporedne povezave, ne zahtevkov na sekundo. Uporabi paketne končne točke in implementiraj logiko ponovnih poskusov z eksponentnim odlogom pri odgovorih `429`.

## Odpravljanje težav

### Pogoste težave

| Težava | Vzrok | Rešitev |
| --- | --- | --- |
| 401 Unauthorized | Neveljaven API ključ ali napačen podatkovni center | Preveri API ključ in ekstrahiraj pravilno predpono `dc` |
| Član obstaja | E-mail je že v občinstvu | Namesto POST za posodabljanje obstoječih članov uporabi PUT |
| Stanje skladnosti | Brisanje GDPR preprečuje ponovni dodajanje | Stik se mora znova naročiti prek prijavnega obrazca |
| Prekluitev paketa | Velika paketna operacija | Razdeli na manjše pakete po 500 operacij |
| Manjkajoča zlivna polja | Polja po meri niso ustvarjena | Pred preslikavo ustvari zlivna polja v Mailchimp |

### Način odpravljanja napak

Omogoči podrobno beleženje:

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

### Preizkus povezave

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

## Najboljše prakse

1. **Uporabi paketne operacije** – za množične posodobitve uporabi množično naročnino/odjavo
2. **Ohrani status naročnikov** – med migracijo upoštevaj soglasje za naročnino
3. **Najprej preslikaj zlivna polja** – pred sinhronizacijo ustvari ustrezne atribute Brevo
4. **Sinhroniziraj angažirne podatke** – uvozi stopnje odpiranja/klikov za zgodovinsko segmentacijo
5. **Obravnavaj stanja skladnosti** – spoštuj stanja GDPR in trajnega brisanja
6. **Uporabi postopno sinhronizacijo** – za zmanjšanje porabe API sinhroniziraj samo spremembe od zadnje sinhronizacije

## Varnost

- **Avtentikacija z API ključem** – tajni ključ posredovan kot geslo HTTP Basic Auth
- **OAuth 2.0** – avtorizacija na osnovi žetonov za dostop z več računi
- **TLS šifriranje** – vsa komunikacija API šifrirana prek HTTPS
- **Preverjanje webhooks** – potrdi vir webhooks s skupno skrivnostjo
- **Izolacija podatkovnih centrov** – podatki shranjeni v regijsko specifičnih podatkovnih centrih

## Povezani viri

- [Mailchimp Marketing API referenca](https://mailchimp.com/developer/marketing/api/)
- [Vodniki za Mailchimp API](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo Connector](https://tajo.io/sl/docs/connectors/marketing/brevo)
- [ActiveCampaign Connector](https://tajo.io/sl/docs/connectors/marketing/activecampaign)
- [Customer Sync Skill](https://tajo.io/sl/docs/skills/data-sync/customer-sync)