---
title: "Σύνδεσμος Mailchimp"
description: "Πλήρης οδηγός ενσωμάτωσης Mailchimp για συγχρονισμό κοινών, καμπανιών, αυτοματισμών και δεδομένων αφοσίωσης με το Brevo μέσω Tajo."
url: https://tajo.io/gr/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/gr/docs/connectors/marketing/mailchimp.md
lang: el-GR
robots: noindex
---

Ζητήστε πρώιμη πρόσβαση

Συμπληρώστε το μικρό σας όνομα και την επαγγελματική διεύθυνση email. Θα σας στείλουμε σύνδεσμο για να επιβεβαιώσετε το αίτημα πρόσβασης στο Tajo.

# Σύνδεσμος Mailchimp

Κατάσταση συνδέσμου: Σε εξέλιξη Υπό κατασκευή. Δεν έχει επαληθευτεί ακόμη.

| Πεδίο πηγής | Πεδίο προορισμού | Ενδεικτική τιμή |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Συνδέστε τον λογαριασμό Mailchimp με το Brevo μέσω Tajo για απρόσκοπτη μετεγκατάσταση κοινού, συγχρονισμό δεδομένων καμπάνιας και ενοποιημένο αυτοματισμό marketing και στις δύο πλατφόρμες.

## Επισκόπηση

| Ιδιότητα | Τιμή |
| --- | --- |
| **Πλατφόρμα** | Mailchimp |
| **Κατηγορία** | Marketing |
| **Πολυπλοκότητα Ρύθμισης** | Εύκολη |
| **Επίσημη Ενσωμάτωση** | Όχι |
| **Δεδομένα που Συγχρονίζονται** | Επαφές, Καμπάνιες, Αυτοματισμοί, Εκδηλώσεις |
| **Βασικό URL API** | `https://{dc}.api.mailchimp.com/3.0` |

## Χαρακτηριστικά

- **Συγχρονισμός κοινού** - Μετεγκατάσταση και συγχρονισμός κοινών Mailchimp με λίστες επαφών Brevo
- **Δεδομένα καμπάνιας** - Συγχρονισμός δεδομένων απόδοσης καμπάνιας για ενοποιημένες αναφορές
- **Μετεγκατάσταση αυτοματισμού** - Αντιστοίχηση αυτοματισμών Mailchimp σε ροές εργασίας Brevo
- **Μετρικά αφοσίωσης** - Συγχρονισμός ανοιγμάτων, κλικ και δεδομένων αναπήδησης σε χαρακτηριστικά Brevo
- **Αντιστοίχηση τμήματος** - Αναπαραγωγή τμημάτων Mailchimp ως λίστες ή τμήματα Brevo
- **Δεδομένα e-commerce** - Συγχρονισμός δεδομένων καταστήματος, προϊόντος και παραγγελίας από e-commerce Mailchimp
- **Συγχρονισμός ετικετών** - Αντιστοίχηση ετικετών Mailchimp σε χαρακτηριστικά επαφών ή λίστες Brevo
- **Μετεγκατάσταση προτύπων** - Εξαγωγή προτύπων Mailchimp για χρήση σε καμπάνιες Brevo

## Προαπαιτούμενα

Πριν ξεκινήσετε, βεβαιωθείτε ότι διαθέτετε:

1. Λογαριασμό Mailchimp (Free, Essentials, Standard ή Premium)
2. Κλειδί API Mailchimp ή εφαρμογή OAuth
3. Λογαριασμό Brevo με πρόσβαση API
4. Λογαριασμό Tajo

## Πιστοποίηση

### Πιστοποίηση με Κλειδί API

Δημιουργήστε κλειδί API από Λογαριασμός Mailchimp > Extras > API Keys.

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

Το πρόθεμα κέντρου δεδομένων `{dc}` είναι το τελευταίο μέρος του κλειδιού API σας (π.χ. `us21`).

### OAuth 2.0

Για ενσωματώσεις πολλαπλών λογαριασμών:

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

Κέντρο Δεδομένων

Να εξάγετε πάντα το κέντρο δεδομένων από το κλειδί API ή το endpoint metadata OAuth. Η χρήση λάθος κέντρου δεδομένων θα οδηγήσει σε αποτυχίες πιστοποίησης.

## Διαμόρφωση

### Βασική Ρύθμιση

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

### Αντιστοίχιση Πεδίων

Αντιστοίχηση πεδίων συγχώνευσης Mailchimp σε χαρακτηριστικά επαφών Brevo:

#### Προεπιλεγμένες Αντιστοιχίσεις

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Email συνδρομητή (μοναδικό αναγνωριστικό) |
| `FNAME` optional | string | Πεδίο συγχώνευσης ονόματος, αντιστοιχεί στο FIRSTNAME |
| `LNAME` optional | string | Πεδίο συγχώνευσης επωνύμου, αντιστοιχεί στο LASTNAME |
| `PHONE` optional | string | Πεδίο συγχώνευσης τηλεφώνου, αντιστοιχεί στο SMS |
| `status` optional | string | Κατάσταση συνδρομής (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Ετικέτες συνδρομητή για τμηματοποίηση |
| `stats.avg_open_rate` optional | number | Μέσο ποσοστό ανοίγματος email |
| `stats.avg_click_rate` optional | number | Μέσο ποσοστό κλικ email |

#### Αντιστοίχηση Προσαρμοσμένων Πεδίων Συγχώνευσης

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

## Endpoints API

### Κοινά (Λίστες)

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/3.0/lists` | Λίστα όλων των κοινών |
| `GET` | `/3.0/lists/{list_id}` | Λήψη λεπτομερειών κοινού |
| `GET` | `/3.0/lists/{list_id}/members` | Λίστα μελών κοινού |
| `POST` | `/3.0/lists/{list_id}/members` | Προσθήκη μέλους |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | Ενημέρωση μέλους |
| `POST` | `/3.0/lists/{list_id}` | Μαζική εγγραφή/διαγραφή |

### Καμπάνιες

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | Λίστα καμπανιών |
| `GET` | `/3.0/campaigns/{id}` | Λήψη λεπτομερειών καμπάνιας |
| `GET` | `/3.0/reports/{id}` | Λήψη αναφοράς καμπάνιας |
| `GET` | `/3.0/reports/{id}/email-activity` | Λήψη δραστηριότητας email |

### Αυτοματισμοί

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/3.0/automations` | Λίστα αυτοματισμών |
| `GET` | `/3.0/automations/{id}` | Λήψη λεπτομερειών αυτοματισμού |
| `GET` | `/3.0/automations/{id}/emails` | Λίστα email αυτοματισμού |

### E-commerce

| Μέθοδος | Endpoint | Περιγραφή |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | Λίστα συνδεδεμένων καταστημάτων |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | Λίστα πελατών καταστήματος |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | Λίστα παραγγελιών καταστήματος |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | Λίστα προϊόντων καταστήματος |

## Εκδηλώσεις

### Εκδηλώσεις Καμπάνιας

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `campaign.sent` | Παράδοση καμπάνιας | Παρακολούθηση απόδοσης |
| `campaign.opened` | Άνοιγμα email | Βαθμολόγηση αφοσίωσης |
| `campaign.clicked` | Κλικ συνδέσμου | Παρακολούθηση ενδιαφέροντος |
| `campaign.bounced` | Αναπήδηση email | Υγιεινή λίστας |

### Εκδηλώσεις Συνδρομητή

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `subscribe` | Προσθήκη νέου συνδρομητή | Ροή καλωσορίσματος |
| `unsubscribe` | Εξαίρεση συνδρομητή | Διαχείριση προτιμήσεων |
| `profile` | Ενημέρωση προφίλ | Συγχρονισμός χαρακτηριστικών |
| `cleaned` | Καθαρισμός email (αναπήδηση) | Συντήρηση λίστας |

### Εκδηλώσεις E-commerce

| Εκδήλωση | Trigger | Χρήση |
| --- | --- | --- |
| `ecommerce.order` | Τοποθέτηση παραγγελίας | Ροή μετά-αγοράς |
| `ecommerce.cart` | Ενημέρωση καλαθιού | Ανάκτηση εγκαταλελειμμένου καλαθιού |

## Παραδείγματα Κώδικα

### Αρχικοποίηση Συνδέσμου

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

### Μετεγκατάσταση Κοινών στο 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
// }
```

### Συγχρονισμός Δεδομένων Αφοσίωσης Καμπάνιας

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

## Όρια Ρυθμού

Όρια ρυθμού Mailchimp Marketing API:

| Τύπος | Όριο | Λεπτομέρειες |
| --- | --- | --- |
| Τυπικό | 10 ταυτόχρονα αιτήματα | Ανά κλειδί API |
| Μαζικές λειτουργίες | 500 λειτουργίες ανά παρτίδα | Ανά αίτημα |
| Όριο εξαγωγής | 1 ταυτόχρονη εξαγωγή | Ανά λογαριασμό |
| Συναλλακτικό | 25 αιτήματα/δευτερόλεπτο | Ανά κλειδί API |

Στρατηγική Ορίου Ρυθμού

Το Mailchimp περιορίζει τις ταυτόχρονες συνδέσεις και όχι τα αιτήματα ανά δευτερόλεπτο. Χρησιμοποιήστε batch endpoints και υλοποιήστε λογική επανάληψης με εκθετική καθυστέρηση σε αποκρίσεις `429`.

## Αντιμετώπιση Προβλημάτων

### Συνήθη Προβλήματα

| Πρόβλημα | Αιτία | Λύση |
| --- | --- | --- |
| 401 Unauthorized | Μη έγκυρο κλειδί API ή λάθος κέντρο δεδομένων | Επαληθεύστε κλειδί API και εξάγετε σωστό πρόθεμα `dc` |
| Υπάρχει μέλος | Email ήδη στο κοινό | Χρησιμοποιήστε PUT αντί για POST για ενημέρωση υπαρχόντων μελών |
| Κατάσταση συμμόρφωσης | Διαγραφή GDPR εμποδίζει επανά-προσθήκη | Το μέλος πρέπει να εγγραφεί εκ νέου μέσω φόρμας εγγραφής |
| Λήξη χρόνου παρτίδας | Μεγάλη μαζική λειτουργία | Χωρίστε σε μικρότερες παρτίδες των 500 λειτουργιών |
| Λείπουν πεδία συγχώνευσης | Δεν έχουν δημιουργηθεί προσαρμοσμένα πεδία | Δημιουργήστε πεδία συγχώνευσης στο Mailchimp πριν την αντιστοίχηση |

### Λειτουργία Εντοπισμού Σφαλμάτων

Ενεργοποίηση λεπτομερούς καταγραφής:

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

### Δοκιμή Σύνδεσης

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

## Βέλτιστες Πρακτικές

1. **Χρησιμοποιήστε μαζικές λειτουργίες** - Χρησιμοποιήστε μαζική εγγραφή/διαγραφή για μαζικές ενημερώσεις
2. **Διατηρήστε κατάσταση συνδρομητή** - Σεβαστείτε τη συγκατάθεση εγγραφής κατά τη μετεγκατάσταση
3. **Αντιστοιχίστε πρώτα πεδία συγχώνευσης** - Δημιουργήστε αντίστοιχα χαρακτηριστικά Brevo πριν τον συγχρονισμό
4. **Συγχρονίστε δεδομένα αφοσίωσης** - Εισαγάγετε ποσοστά ανοίγματος/κλικ για ιστορική τμηματοποίηση
5. **Χειριστείτε καταστάσεις συμμόρφωσης** - Σεβαστείτε καταστάσεις GDPR και μόνιμης διαγραφής
6. **Χρησιμοποιήστε σταδιακό συγχρονισμό** - Συγχρονίστε μόνο αλλαγές από τον τελευταίο συγχρονισμό για μείωση χρήσης API

## Ασφάλεια

- **Πιστοποίηση με Κλειδί API** - Μυστικό κλειδί που περνά ως κωδικός HTTP Basic Auth
- **OAuth 2.0** - Εξουσιοδότηση βάσει token για πρόσβαση πολλαπλών λογαριασμών
- **Κρυπτογράφηση TLS** - Όλη η επικοινωνία API κρυπτογραφείται μέσω HTTPS
- **Επαλήθευση webhook** - Επικύρωση πηγής webhook με κοινό μυστικό
- **Απομόνωση κέντρου δεδομένων** - Δεδομένα αποθηκευμένα σε ανά-περιοχή κέντρα δεδομένων

## Σχετικοί Πόροι

- [Mailchimp Marketing API Reference](https://mailchimp.com/developer/marketing/api/)
- [Mailchimp API Guides](https://mailchimp.com/developer/marketing/guides/quick-start/)
- [Σύνδεσμος Brevo](https://tajo.io/gr/docs/connectors/marketing/brevo)
- [Σύνδεσμος ActiveCampaign](https://tajo.io/gr/docs/connectors/marketing/activecampaign)
- [Δεξιότητα Συγχρονισμού Πελατών](https://tajo.io/gr/docs/skills/data-sync/customer-sync)