---
title: "Mailchimp کنیکٹر"
description: "Tajo کے ذریعے آڈیئنسز، مہمات، آٹومیشنز، اور engagement ڈیٹا کو Brevo کے ساتھ سنک کرنے کے لیے مکمل Mailchimp انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/mailchimp/
markdown: https://tajo.io/ur/docs/connectors/marketing/mailchimp.md
lang: ur-PK
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` |

دونوں پلیٹ فارمز پر بے رکاوٹ آڈیئنس منتقلی، مہم ڈیٹا سنکرونائزیشن، اور متحدہ مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Mailchimp اکاؤنٹ کو Brevo سے منسلک کریں۔

## جائزہ

| خاصیت | قدر |
| --- | --- |
| **پلیٹ فارم** | Mailchimp |
| **زمرہ** | مارکیٹنگ |
| **سیٹ اپ کی پیچیدگی** | آسان |
| **آفیشل انٹیگریشن** | نہیں |
| **سنک شدہ ڈیٹا** | رابطے، مہمات، آٹومیشنز، ایونٹس |
| **API بنیادی URL** | `https://{dc}.api.mailchimp.com/3.0` |

## خصوصیات

- **آڈیئنس سنک** - Mailchimp آڈیئنسز کو Brevo رابطہ فہرستوں کے ساتھ منتقل اور سنک کریں
- **مہم ڈیٹا** - متحدہ رپورٹنگ کے لیے مہم کارکردگی ڈیٹا سنک کریں
- **آٹومیشن منتقلی** - Mailchimp آٹومیشنز کو Brevo ورک فلوز پر میپ کریں
- **Engagement میٹرکس** - opens, clicks, اور bounce ڈیٹا کو Brevo خصوصیات پر سنک کریں
- **سیگمنٹ میپنگ** - Mailchimp سیگمنٹس کو Brevo فہرستوں یا سیگمنٹس کے طور پر نقل کریں
- **ای کامرس ڈیٹا** - Mailchimp ای کامرس سے اسٹور، پروڈکٹ، اور آرڈر ڈیٹا سنک کریں
- **ٹیگ سنک** - Mailchimp ٹیگز کو Brevo رابطہ خصوصیات یا فہرستوں پر میپ کریں
- **ٹیمپلیٹ منتقلی** - 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}` ڈیٹا سینٹر 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}"
```

ڈیٹا سینٹر

ہمیشہ اپنی API key یا OAuth metadata endpoint سے ڈیٹا سینٹر نکالیں۔ غلط ڈیٹا سینٹر استعمال کرنے سے تصدیق کی ناکامی ہوگی۔

## تشکیل

### بنیادی سیٹ اپ

```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 | سبسکرائبر ای میل (منفرد شناخت کنندہ) |
| `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 | Segmentation کے لیے سبسکرائبر ٹیگز |
| `stats.avg_open_rate` optional | number | اوسط ای میل open ریٹ |
| `stats.avg_click_rate` optional | number | اوسط ای میل click ریٹ |

#### کسٹم 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 اینڈ پوائنٹس

### آڈیئنسز (فہرستیں)

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `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}` | بیچ 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` | آٹومیشن ای میلز کی فہرست |

### ای کامرس

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `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` | اسٹور پروڈکٹس کی فہرست |

## ایونٹس

### مہم ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `campaign.sent` | مہم ڈیلیور ہوئی | کارکردگی ٹریکنگ |
| `campaign.opened` | ای میل کھولی گئی | Engagement اسکورنگ |
| `campaign.clicked` | لنک پر کلک | دلچسپی ٹریکنگ |
| `campaign.bounced` | ای میل bounce ہوئی | فہرست hygiene |

### سبسکرائبر ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `subscribe` | نیا سبسکرائبر شامل | ویلکم فلو |
| `unsubscribe` | سبسکرائبر نے opt out کیا | ترجیح کا انتظام |
| `profile` | پروفائل اپ ڈیٹ ہوا | خصوصیت سنک |
| `cleaned` | ای میل صاف ہوئی (bounced) | فہرست maintenance |

### ای کامرس ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `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
// }
```

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

## شرح کی حدود

Mailchimp Marketing API شرح کی حدود:

| قسم | حد | تفصیلات |
| --- | --- | --- |
| معیاری | 10 بیک وقتی درخواستیں | فی API key |
| بیچ آپریشنز | 500 آپریشنز فی بیچ | فی درخواست |
| Export کی حد | 1 بیک وقتی export | فی اکاؤنٹ |
| Transactional | 25 درخواستیں/سیکنڈ | فی API key |

شرح کی حد حکمت عملی

Mailchimp فی سیکنڈ درخواستوں کے بجائے بیک وقتی کنکشنز کو محدود کرتا ہے۔ بیچ اینڈ پوائنٹس استعمال کریں اور `429` جوابات پر exponential backoff کے ساتھ retry لاجک نافذ کریں۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 401 Unauthorized | غلط API key یا غلط ڈیٹا سینٹر | API key کی تصدیق کریں اور درست `dc` prefix نکالیں |
| ممبر موجود ہے | ای میل پہلے سے آڈیئنس میں ہے | موجودہ ممبران کو اپ ڈیٹ کرنے کے لیے POST کے بجائے PUT استعمال کریں |
| Compliance حالت | GDPR حذف دوبارہ شامل کرنے سے روکتا ہے | رابطہ کو signup form کے ذریعے دوبارہ subscribe کرنا ضروری ہے |
| بیچ ٹائم آؤٹ | بڑا بیچ آپریشن | 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. **بیچ آپریشنز استعمال کریں** - بلک اپ ڈیٹس کے لیے بیچ subscribe/unsubscribe استعمال کریں
2. **سبسکرائبر اسٹیٹس کو محفوظ رکھیں** - منتقلی کے دوران سبسکرپشن رضامندی کا احترام کریں
3. **پہلے merge fields میپ کریں** - سنک کرنے سے پہلے متعلقہ Brevo خصوصیات بنائیں
4. **Engagement ڈیٹا سنک کریں** - تاریخی segmentation کے لیے open/click ریٹس امپورٹ کریں
5. **Compliance حالات کو سنبھالیں** - GDPR اور مستقل حذف حالات کا احترام کریں
6. **Incremental sync استعمال کریں** - API استعمال کم کرنے کے لیے صرف آخری sync کے بعد کی تبدیلیاں سنک کریں

## سیکیورٹی

- **API Key تصدیق** - HTTP Basic Auth password کے طور پر منتقل کردہ secret key
- **OAuth 2.0** - ملٹی اکاؤنٹ رسائی کے لیے token پر مبنی اجازت
- **TLS انکرپشن** - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
- **Webhook توثیق** - shared secret کے ساتھ webhook ماخذ کی توثیق کریں
- **ڈیٹا سینٹر isolation** - ڈیٹا region مخصوص ڈیٹا سینٹرز میں ذخیرہ کیا جاتا ہے

## متعلقہ وسائل

- [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/ur/docs/connectors/marketing/brevo)
- [ActiveCampaign کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/activecampaign)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)