---
title: "Mailchimp Connector"
description: "คู่มือการผสานรวม Mailchimp ฉบับสมบูรณ์สำหรับการซิงค์ audiences แคมเปญ automations และข้อมูล engagement กับ Brevo ผ่าน Tajo"
url: https://tajo.io/th/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/th/docs/connectors/marketing/mailchimp.md
lang: th-TH
robots: noindex
---

ขอสิทธิ์ใช้งานล่วงหน้า

กรอกชื่อและที่อยู่อีเมลที่ทำงานของคุณ เราจะส่งลิงก์เพื่อยืนยันคำขอเข้าใช้งาน Tajo ทางอีเมล

# Mailchimp Connector

สถานะตัวเชื่อม: กำลังพัฒนา กำลังสร้าง ยังไม่ได้รับการยืนยัน

| ฟิลด์ต้นทาง | ฟิลด์ปลายทาง | ค่าตัวอย่าง |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

เชื่อมต่อบัญชี Mailchimp ของคุณกับ Brevo ผ่าน Tajo เพื่อการย้าย audience ที่ราบรื่น การซิงค์ข้อมูลแคมเปญ และ marketing automation ที่รวมกันบนทั้งสองแพลตฟอร์ม

## ภาพรวม

| คุณสมบัติ | ค่า |
| --- | --- |
| **แพลตฟอร์ม** | Mailchimp |
| **หมวดหมู่** | การตลาด |
| **ความซับซ้อนในการตั้งค่า** | ง่าย |
| **การผสานรวมอย่างเป็นทางการ** | ไม่ |
| **ข้อมูลที่ซิงค์** | ผู้ติดต่อ แคมเปญ Automations เหตุการณ์ |
| **API Base URL** | `https://{dc}.api.mailchimp.com/3.0` |

## ฟีเจอร์

- **การซิงค์ Audience** - ย้ายและซิงค์ Mailchimp audiences กับ Brevo contact lists
- **ข้อมูลแคมเปญ** - ซิงค์ข้อมูลประสิทธิภาพแคมเปญสำหรับรายงานที่รวมกัน
- **การย้าย Automation** - แมป Mailchimp automations กับ Brevo workflows
- **Engagement metrics** - ซิงค์ข้อมูลการเปิด คลิก และ bounce ไปยัง Brevo attributes
- **การแมป Segment** - จำลอง Mailchimp segments เป็นรายการหรือ segments ของ Brevo
- **ข้อมูล E-commerce** - ซิงค์ข้อมูล store สินค้า และคำสั่งซื้อจาก Mailchimp e-commerce
- **การซิงค์ Tag** - แมป Mailchimp tags กับ Brevo contact attributes หรือรายการ
- **การย้าย Template** - ส่งออก Mailchimp templates สำหรับใช้ในแคมเปญ Brevo

## ข้อกำหนดเบื้องต้น

ก่อนเริ่มต้น ตรวจสอบให้แน่ใจว่าคุณมี:

1. บัญชี Mailchimp (Free, Essentials, Standard หรือ Premium)
2. Mailchimp API key หรือ OAuth app
3. บัญชี Brevo ที่มีสิทธิ์เข้าถึง API
4. บัญชี Tajo

## การยืนยันตัวตน

### การยืนยันตัวตนด้วย API Key

สร้าง API key จาก Mailchimp Account > Extras > API Keys

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

คำนำหน้า data center `{dc}` คือส่วนสุดท้ายของ API key ของคุณ (เช่น `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}"
```

Data Center

ดึง data center จาก API key หรือ OAuth metadata endpoint เสมอ การใช้ data center ผิดจะทำให้การยืนยันตัวตนล้มเหลว

## การกำหนดค่า

### การตั้งค่าพื้นฐาน

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

### การแมปฟิลด์

แมป merge fields ของ Mailchimp กับแอตทริบิวต์ผู้ติดต่อ Brevo:

#### การแมปเริ่มต้น

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | อีเมลผู้สมัคร (unique identifier) |
| `FNAME` optional | string | merge field ชื่อ แมปกับ FIRSTNAME |
| `LNAME` optional | string | merge field นามสกุล แมปกับ LASTNAME |
| `PHONE` optional | string | merge field โทรศัพท์ แมปกับ SMS |
| `status` optional | string | สถานะการสมัคร (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | Tags ของผู้สมัครสำหรับการแบ่ง segment |
| `stats.avg_open_rate` optional | number | อัตราการเปิดอีเมลเฉลี่ย |
| `stats.avg_click_rate` optional | number | อัตราการคลิกอีเมลเฉลี่ย |

#### การแมป Custom Merge Field

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

### Audiences (Lists)

| เมธอด | Endpoint | คำอธิบาย |
| --- | --- | --- |
| `GET` | `/3.0/lists` | แสดงรายการ audiences ทั้งหมด |
| `GET` | `/3.0/lists/{list_id}` | ดึงรายละเอียด audience |
| `GET` | `/3.0/lists/{list_id}/members` | แสดงรายการสมาชิก audience |
| `POST` | `/3.0/lists/{list_id}/members` | เพิ่มสมาชิก |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | อัปเดตสมาชิก |
| `POST` | `/3.0/lists/{list_id}` | สมัคร/ยกเลิกการสมัครเป็น batch |

### แคมเปญ

| เมธอด | Endpoint | คำอธิบาย |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | แสดงรายการแคมเปญ |
| `GET` | `/3.0/campaigns/{id}` | ดึงรายละเอียดแคมเปญ |
| `GET` | `/3.0/reports/{id}` | ดึงรายงานแคมเปญ |
| `GET` | `/3.0/reports/{id}/email-activity` | ดึงกิจกรรมอีเมล |

### Automations

| เมธอด | Endpoint | คำอธิบาย |
| --- | --- | --- |
| `GET` | `/3.0/automations` | แสดงรายการ automations |
| `GET` | `/3.0/automations/{id}` | ดึงรายละเอียด automation |
| `GET` | `/3.0/automations/{id}/emails` | แสดงรายการอีเมล automation |

### E-commerce

| เมธอด | Endpoint | คำอธิบาย |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | แสดงรายการ stores ที่เชื่อมต่อ |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | แสดงรายการลูกค้า store |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | แสดงรายการคำสั่งซื้อ store |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | แสดงรายการสินค้า store |

## เหตุการณ์

### เหตุการณ์แคมเปญ

| เหตุการณ์ | Trigger | กรณีการใช้งาน |
| --- | --- | --- |
| `campaign.sent` | ส่งแคมเปญแล้ว | การติดตามประสิทธิภาพ |
| `campaign.opened` | เปิดอีเมลแล้ว | การให้คะแนน engagement |
| `campaign.clicked` | คลิกลิงก์แล้ว | การติดตามความสนใจ |
| `campaign.bounced` | อีเมล bounce | การดูแล list |

### เหตุการณ์ผู้สมัคร

| เหตุการณ์ | Trigger | กรณีการใช้งาน |
| --- | --- | --- |
| `subscribe` | เพิ่มผู้สมัครใหม่ | Welcome flow |
| `unsubscribe` | ผู้สมัครยกเลิก | การจัดการการตั้งค่า |
| `profile` | อัปเดตโปรไฟล์แล้ว | การซิงค์ attribute |
| `cleaned` | ทำความสะอาดอีเมล (bounce) | การบำรุงรักษา list |

### เหตุการณ์ E-commerce

| เหตุการณ์ | Trigger | กรณีการใช้งาน |
| --- | --- | --- |
| `ecommerce.order` | สั่งซื้อแล้ว | Post-purchase flow |
| `ecommerce.cart` | อัปเดตตะกร้าสินค้าแล้ว | การกู้คืนตะกร้าที่ถูกทิ้ง |

## ตัวอย่างโค้ด

### เริ่มต้น Connector

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

### ย้าย Audiences ไปยัง 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
// }
```

### ซิงค์ข้อมูล Campaign Engagement

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

## ขีดจำกัดอัตรา

Rate limits ของ Mailchimp Marketing API:

| ประเภท | ขีดจำกัด | รายละเอียด |
| --- | --- | --- |
| มาตรฐาน | 10 concurrent requests | ต่อ API key |
| Batch operations | 500 operations ต่อ batch | ต่อคำขอ |
| Export limit | 1 concurrent export | ต่อบัญชี |
| Transactional | 25 คำขอ/วินาที | ต่อ API key |

กลยุทธ์ Rate Limit

Mailchimp จำกัด concurrent connections แทนที่จะเป็นคำขอต่อวินาที ใช้ batch endpoints และใช้ retry logic พร้อม exponential backoff บนการตอบกลับ `429`

## การแก้ไขปัญหา

### ปัญหาทั่วไป

| ปัญหา | สาเหตุ | วิธีแก้ |
| --- | --- | --- |
| 401 Unauthorized | API key ไม่ถูกต้องหรือ data center ผิด | ตรวจสอบ API key และดึงคำนำหน้า `dc` ที่ถูกต้อง |
| Member exists | อีเมลมีอยู่ใน audience แล้ว | ใช้ PUT แทน POST เพื่ออัปเดตสมาชิกที่มีอยู่ |
| Compliance state | การลบ GDPR ป้องกันการเพิ่มกลับ | ผู้ติดต่อต้องสมัครใหม่ผ่านฟอร์มลงทะเบียน |
| Batch timeout | การดำเนินการ batch ขนาดใหญ่ | แบ่งเป็น batches ขนาดเล็กลง 500 operations |
| Merge fields หายไป | ไม่ได้สร้าง custom fields | สร้าง merge fields ใน Mailchimp ก่อนแมป |

### โหมด Debug

เปิดใช้งาน verbose logging:

```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. **ใช้ batch operations** - ใช้ batch subscribe/unsubscribe สำหรับการอัปเดตจำนวนมาก
2. **รักษาสถานะผู้สมัคร** - เคารพการยินยอม subscription ระหว่างการย้าย
3. **แมป merge fields ก่อน** - สร้าง Brevo attributes ที่สอดคล้องกันก่อนซิงค์
4. **ซิงค์ข้อมูล engagement** - นำเข้าอัตราการเปิด/คลิกสำหรับการแบ่ง segment ย้อนหลัง
5. **จัดการ compliance states** - เคารพสถานะการลบ GDPR และถาวร
6. **ใช้ incremental sync** - ซิงค์เฉพาะการเปลี่ยนแปลงตั้งแต่ sync ครั้งล่าสุดเพื่อลดการใช้ API

## ความปลอดภัย

- **การยืนยันตัวตนด้วย API Key** - Secret key ส่งผ่าน HTTP Basic Auth password
- **OAuth 2.0** - การอนุมัติด้วย token สำหรับการเข้าถึงหลายบัญชี
- **การเข้ารหัส TLS** - การสื่อสาร API ทั้งหมดเข้ารหัสผ่าน HTTPS
- **การตรวจสอบ Webhook** - ตรวจสอบแหล่ง webhook ด้วย shared secret
- **การแยก Data center** - ข้อมูลเก็บใน data centers เฉพาะภูมิภาค

## แหล่งข้อมูลที่เกี่ยวข้อง

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