---
title: "Mailchimp कनेक्टर"
description: "Tajo के माध्यम से Brevo के साथ audiences, कैंपेन, ऑटोमेशन्स, और एंगेजमेंट डेटा सिंक करने के लिए संपूर्ण Mailchimp इंटीग्रेशन गाइड।"
url: https://tajo.io/hi/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/hi/docs/connectors/marketing/mailchimp.md
lang: hi-IN
robots: noindex
---

अर्ली एक्सेस का अनुरोध करें

अपना पहला नाम और कार्यस्थल का ईमेल पता दर्ज करें। Tajo एक्सेस अनुरोध की पुष्टि के लिए हम आपको एक लिंक ईमेल करेंगे।

# Mailchimp कनेक्टर

कनेक्टर की स्थिति: प्रगति पर बन रहा है। अभी सत्यापित नहीं है।

| स्रोत फ़ील्ड | गंतव्य फ़ील्ड | नमूना मान |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

सहज audience माइग्रेशन, कैंपेन डेटा सिंक्रनाइज़ेशन, और दोनों प्लेटफ़ॉर्म्स में एकीकृत मार्केटिंग ऑटोमेशन के लिए अपने Mailchimp खाते को Tajo के माध्यम से Brevo से कनेक्ट करें।

## अवलोकन

| गुण | मान |
| --- | --- |
| **प्लेटफ़ॉर्म** | Mailchimp |
| **श्रेणी** | Marketing |
| **सेटअप जटिलता** | आसान |
| **आधिकारिक इंटीग्रेशन** | नहीं |
| **सिंक किया गया डेटा** | कॉन्टैक्ट्स, कैंपेन, ऑटोमेशन्स, इवेंट्स |
| **API Base URL** | `https://{dc}.api.mailchimp.com/3.0` |

## विशेषताएं

- **Audience सिंक** - Brevo कॉन्टैक्ट lists के साथ Mailchimp audiences को माइग्रेट और सिंक करें
- **कैंपेन डेटा** - एकीकृत रिपोर्टिंग के लिए कैंपेन प्रदर्शन डेटा सिंक करें
- **ऑटोमेशन माइग्रेशन** - Mailchimp ऑटोमेशन्स को Brevo workflows में मैप करें
- **एंगेजमेंट मेट्रिक्स** - opens, clicks, और bounce डेटा को Brevo एट्रिब्यूट्स में सिंक करें
- **Segment मैपिंग** - Mailchimp segments को Brevo lists या segments के रूप में दोहराएं
- **E-commerce डेटा** - Mailchimp e-commerce से store, product, और order डेटा सिंक करें
- **Tag सिंक** - Mailchimp tags को Brevo कॉन्टैक्ट एट्रिब्यूट्स या lists में मैप करें
- **Template माइग्रेशन** - Brevo कैंपेन में उपयोग के लिए Mailchimp templates निर्यात करें

## पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. एक Mailchimp खाता (Free, Essentials, Standard, या Premium)
2. एक Mailchimp API key या OAuth ऐप
3. API एक्सेस वाला एक Brevo खाता
4. एक Tajo खाता

## प्रमाणीकरण

### API Key प्रमाणीकरण

Mailchimp Account > Extras > API Keys से एक API key जनरेट करें।

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

`{dc}` data center prefix आपकी 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

हमेशा अपनी API key या OAuth metadata एंडपॉइंट से data center निकालें। गलत 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
```

### फ़ील्ड मैपिंग

Mailchimp merge fields को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

#### डिफ़ॉल्ट मैपिंग्स

| Parameter | Type | Description |
| --- | --- | --- |
| `email_address` required | string | Subscriber ईमेल (अद्वितीय पहचानकर्ता) |
| `FNAME` optional | string | First name merge field, FIRSTNAME से मैप होता है |
| `LNAME` optional | string | Last name merge field, LASTNAME से मैप होता है |
| `PHONE` optional | string | Phone merge field, SMS से मैप होता है |
| `status` optional | string | Subscription स्थिति (subscribed, unsubscribed, cleaned, pending) |
| `tags` optional | array | सेगमेंटेशन के लिए subscriber tags |
| `stats.avg_open_rate` optional | number | औसत ईमेल open rate |
| `stats.avg_click_rate` optional | number | औसत ईमेल click rate |

#### कस्टम 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 एंडपॉइंट्स

### Audiences (Lists)

| मेथड | एंडपॉइंट | विवरण |
| --- | --- | --- |
| `GET` | `/3.0/lists` | सभी audiences सूचीबद्ध करें |
| `GET` | `/3.0/lists/{list_id}` | audience विवरण प्राप्त करें |
| `GET` | `/3.0/lists/{list_id}/members` | audience members सूचीबद्ध करें |
| `POST` | `/3.0/lists/{list_id}/members` | एक member जोड़ें |
| `PUT` | `/3.0/lists/{list_id}/members/{hash}` | एक member अपडेट करें |
| `POST` | `/3.0/lists/{list_id}` | बैच subscribe/unsubscribe |

### कैंपेन

| मेथड | एंडपॉइंट | विवरण |
| --- | --- | --- |
| `GET` | `/3.0/campaigns` | कैंपेन सूचीबद्ध करें |
| `GET` | `/3.0/campaigns/{id}` | कैंपेन विवरण प्राप्त करें |
| `GET` | `/3.0/reports/{id}` | कैंपेन रिपोर्ट प्राप्त करें |
| `GET` | `/3.0/reports/{id}/email-activity` | ईमेल गतिविधि प्राप्त करें |

### ऑटोमेशन्स

| मेथड | एंडपॉइंट | विवरण |
| --- | --- | --- |
| `GET` | `/3.0/automations` | ऑटोमेशन्स सूचीबद्ध करें |
| `GET` | `/3.0/automations/{id}` | ऑटोमेशन विवरण प्राप्त करें |
| `GET` | `/3.0/automations/{id}/emails` | ऑटोमेशन ईमेल सूचीबद्ध करें |

### E-commerce

| मेथड | एंडपॉइंट | विवरण |
| --- | --- | --- |
| `GET` | `/3.0/ecommerce/stores` | कनेक्टेड stores सूचीबद्ध करें |
| `GET` | `/3.0/ecommerce/stores/{id}/customers` | store customers सूचीबद्ध करें |
| `GET` | `/3.0/ecommerce/stores/{id}/orders` | store orders सूचीबद्ध करें |
| `GET` | `/3.0/ecommerce/stores/{id}/products` | store products सूचीबद्ध करें |

## इवेंट्स

### कैंपेन इवेंट्स

| इवेंट | ट्रिगर | उपयोग मामला |
| --- | --- | --- |
| `campaign.sent` | कैंपेन डिलीवर हुआ | प्रदर्शन ट्रैकिंग |
| `campaign.opened` | ईमेल खोला गया | एंगेजमेंट स्कोरिंग |
| `campaign.clicked` | लिंक क्लिक किया | रुचि ट्रैकिंग |
| `campaign.bounced` | ईमेल बाउंस हुआ | List हाइजीन |

### Subscriber इवेंट्स

| इवेंट | ट्रिगर | उपयोग मामला |
| --- | --- | --- |
| `subscribe` | नया subscriber जोड़ा गया | स्वागत flow |
| `unsubscribe` | Subscriber ने opt out किया | वरीयता प्रबंधन |
| `profile` | Profile अपडेट किया | एट्रिब्यूट सिंक |
| `cleaned` | ईमेल साफ़ किया (बाउंस) | List रखरखाव |

### E-commerce इवेंट्स

| इवेंट | ट्रिगर | उपयोग मामला |
| --- | --- | --- |
| `ecommerce.order` | ऑर्डर रखा गया | पोस्ट-खरीद flow |
| `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 में Audiences माइग्रेट करें

```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 दर सीमाएं:

| प्रकार | सीमा | विवरण |
| --- | --- | --- |
| Standard | 10 समवर्ती अनुरोध | प्रति API key |
| Batch operations | 500 operations प्रति बैच | प्रति अनुरोध |
| Export सीमा | 1 समवर्ती export | प्रति खाता |
| Transactional | 25 अनुरोध/सेकंड | प्रति API key |

दर सीमा रणनीति

Mailchimp प्रति सेकंड अनुरोधों के बजाय समवर्ती कनेक्शन सीमित करता है। batch एंडपॉइंट्स का उपयोग करें और `429` प्रतिक्रियाओं पर exponential backoff के साथ रीट्राई लॉजिक लागू करें।

## समस्या निवारण

### सामान्य समस्याएं

| समस्या | कारण | समाधान |
| --- | --- | --- |
| 401 Unauthorized | अमान्य API key या गलत data center | API key सत्यापित करें और सही `dc` prefix निकालें |
| Member exists | ईमेल पहले से audience में | मौजूदा members को अपडेट करने के लिए POST के बजाय PUT का उपयोग करें |
| Compliance state | GDPR deletion पुनः जोड़ने को रोकता है | कॉन्टैक्ट को signup form के माध्यम से पुनः subscribe करना होगा |
| Batch timeout | बड़ी batch ऑपरेशन | 500 ऑपरेशन्स के छोटे बैचों में विभाजित करें |
| गायब merge fields | कस्टम फ़ील्ड्स नहीं बनाए | मैपिंग से पहले Mailchimp में merge fields बनाएं |

### डीबग मोड

विस्तृत लॉगिंग सक्षम करें:

```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 का उपयोग करें** - bulk अपडेट के लिए batch subscribe/unsubscribe का उपयोग करें
2. **subscriber स्थिति संरक्षित करें** - माइग्रेशन के दौरान subscription सहमति का सम्मान करें
3. **पहले merge fields मैप करें** - सिंक करने से पहले संबंधित Brevo एट्रिब्यूट्स बनाएं
4. **एंगेजमेंट डेटा सिंक करें** - ऐतिहासिक सेगमेंटेशन के लिए open/click rates आयात करें
5. **compliance states हैंडल करें** - GDPR और स्थायी deletion states का सम्मान करें
6. **incremental sync का उपयोग करें** - API उपयोग कम करने के लिए केवल पिछले sync के बाद के परिवर्तन सिंक करें

## सुरक्षा

- **API Key प्रमाणीकरण** - Secret key को HTTP Basic Auth password के रूप में पारित किया जाता है
- **OAuth 2.0** - मल्टी-अकाउंट एक्सेस के लिए token-आधारित authorization
- **TLS एन्क्रिप्शन** - सभी API संचार HTTPS के माध्यम से एन्क्रिप्टेड
- **Webhook सत्यापन** - shared secret के साथ webhook स्रोत सत्यापित करें
- **Data center isolation** - डेटा क्षेत्र-विशिष्ट 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/hi/docs/connectors/marketing/brevo)
- [ActiveCampaign Connector](https://tajo.io/hi/docs/connectors/marketing/activecampaign)
- [Customer Sync Skill](https://tajo.io/hi/docs/skills/data-sync/customer-sync)
