---
title: "Mailchimp-koppling"
description: "Komplett integrationsguide för Mailchimp för att synka publiker, kampanjer, automationer och engagemangsdata med Brevo via Tajo."
url: https://tajo.io/se/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/se/docs/connectors/marketing/mailchimp.md
lang: sv-SE
robots: noindex
---

Ansök om tidig åtkomst

Ange ditt förnamn och din e-postadress på jobbet. Vi skickar en länk för att bekräfta din begäran om åtkomst till Tajo.

# Mailchimp-koppling

Kopplingens status: Under utveckling Byggs. Inte verifierad än.

| Källfält | Målfält | Exempelvärde |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Anslut ditt Mailchimp-konto till Brevo via Tajo för smidig migrering av publiker, synkronisering av kampanjdata och enhetlig marknadsautomation över båda plattformarna.

## Översikt

| Egenskap | Värde |
| --- | --- |
| **Plattform** | Mailchimp |
| **Kategori** | Marknadsföring |
| **Installationskomplexitet** | Enkel |
| **Officiell integration** | Nej |
| **Data som synkas** | Kontakter, kampanjer, automationer, händelser |
| **Bas-URL för API** | `https://{dc}.api.mailchimp.com/3.0` |

## Funktioner

- **Publiksynk** - Migrera och synka Mailchimp-publiker med Brevos kontaktlistor
- **Kampanjdata** - Synka kampanjprestanda för enhetlig rapportering
- **Migrering av automationer** - Mappa Mailchimp-automationer till Brevo-flöden
- **Engagemangsmått** - Synka öppningar, klick och studsar till Brevo-attribut
- **Segmentmappning** - Replikera Mailchimp-segment som Brevo-listor eller segment
- **E-handelsdata** - Synka butiks-, produkt- och orderdata från Mailchimp e-commerce
- **Taggsynk** - Mappa Mailchimp-taggar till Brevo-kontaktattribut eller -listor
- **Mallmigrering** - Exportera Mailchimp-mallar för användning i Brevo-kampanjer

## Förutsättningar

Innan du börjar, se till att du har:

1. Ett Mailchimp-konto (Free, Essentials, Standard eller Premium)
2. En Mailchimp API-nyckel eller OAuth-app
3. Ett Brevo-konto med API-åtkomst
4. Ett Tajo-konto

## Autentisering

### API-nyckelautentisering

Generera en API-nyckel via Mailchimp Account > Extras > API Keys.

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

Prefixet `{dc}` (data center) är den sista delen av din API-nyckel (t.ex. `us21`).

### OAuth 2.0

För integrationer med flera konton:

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

Data center

Extrahera alltid data center från din API-nyckel eller OAuth:s metadata-ändpunkt. Fel data center leder till misslyckad autentisering.

## Konfiguration

### Grundläggande konfiguration

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

### Fältmappning

Mappa Mailchimp merge fields till Brevos kontaktattribut:

#### Standardmappningar

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Prenumerantens e-post (unik identifierare) |
| `FNAME` optional | string | Merge field för förnamn, mappas till FIRSTNAME |
| `LNAME` optional | string | Merge field för efternamn, mappas till LASTNAME |
| `PHONE` optional | string | Merge field för telefon, mappas till SMS |
| `status` optional | string | Prenumerationsstatus (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Prenumeranttaggar för segmentering |
| `stats.avg_open_rate` optional | number | Genomsnittlig öppningsfrekvens |
| `stats.avg_click_rate` optional | number | Genomsnittlig klickfrekvens |

#### Anpassad mappning av merge fields

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

### Publiker (listor)

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Lista alla publiker |
| `GET` | `/3.0/lists/{list_id}` | Hämta publikdetaljer |
| `GET` | `/3.0/lists/{list_id}/members` | Lista medlemmar i publiken |
| `POST` | `/3.0/lists/{list_id}/members` | Lägg till en medlem |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Uppdatera en medlem |
| `POST` | `/3.0/lists/{list_id}` | Batch prenumerera/avprenumerera |

### Kampanjer

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Lista kampanjer |
| `GET` | `/3.0/campaigns/{id}` | Hämta kampanjdetaljer |
| `GET` | `/3.0/reports/{id}` | Hämta kampanjrapport |
| `GET` | `/3.0/reports/{id}/email-activity` | Hämta e-postaktivitet |

### Automationer

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Lista automationer |
| `GET` | `/3.0/automations/{id}` | Hämta automationsdetaljer |
| `GET` | `/3.0/automations/{id}/emails` | Lista automationsmejl |

### E-handel

| Metod | Ändpunkt | Beskrivning |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Lista anslutna butiker |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Lista butikskunder |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Lista butiksordrar |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Lista butiksprodukter |

## Händelser

### Kampanjhändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `campaign.sent` | Kampanj levererad | Prestandaspårning |
| `campaign.opened` | E-post öppnad | Engagemangspoäng |
| `campaign.clicked` | Länk klickad | Intressespårning |
| `campaign.bounced` | E-post studsade | Listhygien |

### Prenumeranthändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `subscribe` | Ny prenumerant tillagd | Välkomstflöde |
| `unsubscribe` | Prenumerant avanmälde sig | Preferenshantering |
| `profile` | Profil uppdaterad | Attributsynk |
| `cleaned` | E-post rensad (studsade) | Listunderhåll |

### E-handelshändelser

| Händelse | Utlösare | Användningsfall |
| --- | --- | --- |
| `ecommerce.order` | Order lagd | Flöde efter köp |
| `ecommerce.cart` | Kundvagn uppdaterad | Återvinning av övergiven kundvagn |

## Kodexempel

### Initiera kopplingen

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

### Migrera publiker till 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
// }
```

### Synka engagemangsdata för kampanjer

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

## API-gränser

Rate limits för Mailchimp Marketing API:

| Typ | Gräns | Detaljer |
| --- | --- | --- |
| Standard | 10 samtidiga förfrågningar | Per API-nyckel |
| Batchoperationer | 500 operationer per batch | Per förfrågan |
| Exportgräns | 1 samtidig export | Per konto |
| Transaktioner | 25 förfrågningar/sekund | Per API-nyckel |

Strategi för rate limits

Mailchimp begränsar samtidiga anslutningar snarare än förfrågningar per sekund. Använd batch-ändpunkter och implementera retry-logik med exponentiell backoff vid `429`-svar.

## Felsökning

### Vanliga problem

| Problem | Orsak | Lösning |
| --- | --- | --- |
| 401 Unauthorized | Ogiltig API-nyckel eller fel data center | Verifiera API-nyckeln och extrahera rätt `dc`-prefix |
| Medlemmen finns redan | E-posten finns redan i publiken | Använd PUT istället för POST för att uppdatera befintliga medlemmar |
| Efterlevnadsstatus | GDPR-radering förhindrar återtillägg | Kontakten måste prenumerera igen via ett registreringsformulär |
| Batch-timeout | Stor batchoperation | Dela upp i mindre batcher om 500 operationer |
| Merge fields saknas | Anpassade fält har inte skapats | Skapa merge fields i Mailchimp innan mappning |

### Debug-läge

Aktivera utförlig loggning:

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

### Testa anslutningen

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

## Bästa praxis

1. **Använd batchoperationer** - Använd batch subscribe/unsubscribe för massuppdateringar
2. **Bevara prenumerantstatus** - Respektera prenumerationssamtycke under migreringen
3. **Mappa merge fields först** - Skapa motsvarande Brevo-attribut innan du synkar
4. **Synka engagemangsdata** - Importera öppnings-/klickfrekvenser för historisk segmentering
5. **Hantera efterlevnadsstatus** - Respektera GDPR och permanenta raderingstillstånd
6. **Använd inkrementell synk** - Synka bara ändringar sedan senaste synkron för att minska API-användningen

## Säkerhet

- **API-nyckelautentisering** - Hemlig nyckel skickas som HTTP Basic Auth-lösenord
- **OAuth 2.0** - Tokenbaserad auktorisering för åtkomst till flera konton
- **TLS-kryptering** - All API-kommunikation krypteras via HTTPS
- **Webhook-verifiering** - Validera webhook-källan med en delad hemlighet
- **Isolerade data centers** - Data lagras i regionsspecifika data centers

## Relaterade resurser

- [Mailchimp Marketing API-referens](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API-guider](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Brevo-koppling](https://tajo.io/se/docs/connectors/marketing/brevo)
- [ActiveCampaign-koppling](https://tajo.io/se/docs/connectors/marketing/activecampaign)
- [Skill för kundsynk](https://tajo.io/se/docs/skills/data-sync/customer-sync)