---
title: "Mailchimp Connector"
description: "Komplet guide til Mailchimp-integration til synkronisering af målgrupper, kampagner, automatiseringer og engagementdata med Brevo via Tajo."
url: https://tajo.io/dk/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/dk/docs/connectors/marketing/mailchimp.md
lang: da-DK
robots: noindex
---

Bed om tidlig adgang til Tajo

Indtast dit fornavn og din arbejds-e-mailadresse. Vi sender dig et link til at bekræfte din anmodning om adgang til Tajo.

# Mailchimp Connector

Connectorstatus: Under udvikling Under opbygning. Endnu ikke verificeret.

| Kildefelt | Destinationsfelt | Eksempelværdi |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Forbind din Mailchimp-konto til Brevo via Tajo for problemfri målgruppemigrering, kampagnedatasynkronisering og forenet marketingautomatisering på tværs af begge platforme.

## Oversigt

| Egenskab | Værdi |
| --- | --- |
| **Platform** | Mailchimp |
| **Kategori** | Marketing |
| **Opsætningskompleksitet** | Let |
| **Officiel integration** | Nej |
| **Synkroniserede data** | Kontakter, kampagner, automatiseringer, hændelser |
| **API-base-URL** | `https://{dc}.api.mailchimp.com/3.0` |

## Funktioner

- **Målgruppesynkronisering** - Migrér og synkronisér Mailchimp-målgrupper med Brevo-kontaktlister
- **Kampagnedata** - Synkronisér kampagneperformance-data til forenet rapportering
- **Automatiseringsmigrering** - Knyt Mailchimp-automatiseringer til Brevo-workflows
- **Engagementmetrikker** - Synkronisér åbninger, klik og bounce-data til Brevo-attributter
- **Segmentmapping** - Replicér Mailchimp-segmenter som Brevo-lister eller -segmenter
- **E-handelsdata** - Synkronisér butiks-, produkt- og ordredata fra Mailchimp e-commerce
- **Tag-synkronisering** - Knyt Mailchimp-tags til Brevo-kontaktattributter eller -lister
- **Skabelonmigrering** - Eksportér Mailchimp-skabeloner til brug i Brevo-kampagner

## Forudsætninger

Før du begynder, skal du sikre dig, at du har:

1. En Mailchimp-konto (Free, Essentials, Standard eller Premium)
2. En Mailchimp API-nøgle eller OAuth-app
3. En Brevo-konto med API-adgang
4. En Tajo-konto

## Autentifikation

### API-nøgle-autentifikation

Generér en API-nøgle fra Mailchimp Account > Extras > API Keys.

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

`{dc}`-datacenterpræfikset er den sidste del af din API-nøgle (f.eks. `us21`).

### OAuth 2.0

Til integrationer på tværs af flere konti:

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

Datacenter

Udtræk altid datacentret fra din API-nøgle eller OAuth-metadata-endpoint. Brug af det forkerte datacenter vil resultere i autentifikationsfejl.

## Konfiguration

### Grundlæggende opsætning

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

### Feltmapping

Knyt Mailchimp merge-felter til Brevo-kontaktattributter:

#### Standardmappings

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Abonnentens e-mail (unik identifikator) |
| `FNAME` optional | string | Merge-felt for fornavn, mapper til FIRSTNAME |
| `LNAME` optional | string | Merge-felt for efternavn, mapper til LASTNAME |
| `PHONE` optional | string | Merge-felt for telefon, mapper til SMS |
| `status` optional | string | Abonnementsstatus (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Abonnenttags til segmentering |
| `stats.avg_open_rate` optional | number | Gennemsnitlig åbningsrate for e-mails |
| `stats.avg_click_rate` optional | number | Gennemsnitlig klikrate for e-mails |

#### Brugerdefineret merge-feltmapping

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

### Målgrupper (lister)

| Metode | Endpoint | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Vis alle målgrupper |
| `GET` | `/3.0/lists/{list_id}` | Hent målgruppedetaljer |
| `GET` | `/3.0/lists/{list_id}/members` | Vis målgruppemedlemmer |
| `POST` | `/3.0/lists/{list_id}/members` | Tilføj et medlem |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Opdatér et medlem |
| `POST` | `/3.0/lists/{list_id}` | Batch tilmeld/afmeld |

### Kampagner

| Metode | Endpoint | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Vis kampagner |
| `GET` | `/3.0/campaigns/{id}` | Hent kampagnedetaljer |
| `GET` | `/3.0/reports/{id}` | Hent kampagnerapport |
| `GET` | `/3.0/reports/{id}/email-activity` | Hent e-mailaktivitet |

### Automatiseringer

| Metode | Endpoint | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Vis automatiseringer |
| `GET` | `/3.0/automations/{id}` | Hent automatiseringsdetaljer |
| `GET` | `/3.0/automations/{id}/emails` | Vis automatiserings-e-mails |

### E-handel

| Metode | Endpoint | Beskrivelse |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Vis forbundne butikker |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Vis butikskunder |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Vis butiksordrer |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Vis butiksprodukter |

## Hændelser

### Kampagnehændelser

| Hændelse | Trigger | Anvendelse |
| --- | --- | --- |
| `campaign.sent` | Kampagne leveret | Performance-sporing |
| `campaign.opened` | E-mail åbnet | Engagementscoring |
| `campaign.clicked` | Link klikket | Interessesporing |
| `campaign.bounced` | E-mail afvist | Listehygiejne |

### Abonnenthændelser

| Hændelse | Trigger | Anvendelse |
| --- | --- | --- |
| `subscribe` | Ny abonnent tilføjet | Velkomst-flow |
| `unsubscribe` | Abonnent afmeldt | Præferencehåndtering |
| `profile` | Profil opdateret | Attributsynkronisering |
| `cleaned` | E-mail renset (bouncet) | Listevedligeholdelse |

### E-handelshændelser

| Hændelse | Trigger | Anvendelse |
| --- | --- | --- |
| `ecommerce.order` | Ordre afgivet | Flow efter køb |
| `ecommerce.cart` | Kurv opdateret | Genoprettelse af forladt kurv |

## Kodeeksempler

### Initialisér konnektor

```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ér målgrupper til 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
// }
```

### Synkronisér kampagneengagementdata

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

## Ratebegrænsninger

Mailchimp Marketing API-ratebegrænsninger:

| Type | Grænse | Detaljer |
| --- | --- | --- |
| Standard | 10 samtidige forespørgsler | Per API-nøgle |
| Batch-operationer | 500 operationer per batch | Per forespørgsel |
| Eksportgrænse | 1 samtidig eksport | Per konto |
| Transaktionel | 25 forespørgsler/sekund | Per API-nøgle |

Ratebegrænsningsstrategi

Mailchimp begrænser samtidige forbindelser snarere end forespørgsler per sekund. Brug batch-endpoints, og implementér retry-logik med eksponentiel backoff ved `429`-svar.

## Fejlfinding

### Almindelige problemer

| Problem | Årsag | Løsning |
| --- | --- | --- |
| 401 Unauthorized | Ugyldig API-nøgle eller forkert datacenter | Verificér API-nøgle, og udtræk korrekt `dc`-præfiks |
| Member exists | E-mail findes allerede i målgruppe | Brug PUT i stedet for POST til at opdatere eksisterende medlemmer |
| Compliance-tilstand | GDPR-sletning forhindrer gen-tilføjelse | Kontakten skal genabonnere via en tilmeldingsformular |
| Batch-timeout | Stor batchoperation | Opdel i mindre batches på 500 operationer |
| Manglende merge-felter | Brugerdefinerede felter ikke oprettet | Opret merge-felter i Mailchimp før mapping |

### Fejlfindingstilstand

Aktivér udførlig logning:

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

### Test forbindelse

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

## Best practices

1. **Brug batch-operationer** - Brug batch subscribe/unsubscribe til massemassemasseopdateringer
2. **Bevar abonnentstatus** - Respektér abonnementssamtykke under migrering
3. **Map merge-felter først** - Opret tilsvarende Brevo-attributter før synkronisering
4. **Synkronisér engagementdata** - Importér åbnings-/klikrater til historisk segmentering
5. **Håndtér compliance-tilstande** - Respektér GDPR- og permanent slettede tilstande
6. **Brug inkrementel synkronisering** - Synkronisér kun ændringer siden sidste synkronisering for at reducere API-forbrug

## Sikkerhed

- **API-nøgle-autentifikation** - Hemmelig nøgle sendt som HTTP Basic Auth-adgangskode
- **OAuth 2.0** - Tokenbaseret autorisation til adgang på tværs af flere konti
- **TLS-kryptering** - Al API-kommunikation krypteret via HTTPS
- **Webhook-verifikation** - Validér webhook-kilde med delt secret
- **Datacenterisolering** - Data lagres i regionsspecifikke datacentre

## Relaterede ressourcer

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