---
title: "ActiveCampaign کنیکٹر"
description: "Tajo کے ذریعے رابطوں، ڈیلز، آٹومیشنز، اور engagement ایونٹس کو Brevo کے ساتھ سنک کرنے کے لیے مکمل ActiveCampaign انٹیگریشن گائیڈ۔"
url: https://tajo.io/ur/docs/connectors/marketing/activecampaign/
markdown: https://tajo.io/ur/docs/connectors/marketing/activecampaign.md
lang: ur-PK
robots: noindex
---

ابتدائی رسائی کی درخواست کریں

اپنا پہلا نام اور دفتری ای میل پتہ درج کریں۔ ہم Tajo تک رسائی کی درخواست کی تصدیق کے لیے ایک لنک ای میل کریں گے۔

# ActiveCampaign کنیکٹر

کنیکٹر کی حیثیت: منصوبہ بند ابھی تیار نہیں ہوا۔ Tajo آج یہ کنیکٹر نہیں چلاتا۔

| ماخذ فیلڈ | منزل فیلڈ | نمونہ قدر |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

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

## جائزہ

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

## خصوصیات

- **رابطہ منتقلی** - کسٹم فیلڈز، ٹیگز، اور فہرست رکنیتوں کے ساتھ رابطے منتقل کریں
- **ڈیل پائپ لائن سنک** - آمدنی ٹریکنگ کے لیے ڈیل مراحل، اقدار، اور مالکان سنک کریں
- **آٹومیشن میپنگ** - ActiveCampaign آٹومیشنز کو Brevo ورک فلو ٹرگرز پر میپ کریں
- **ایونٹ ٹریکنگ** - رویاتی segmentation کے لیے سائٹ ٹریکنگ اور کسٹم ایونٹس سنک کریں
- **فہرست اور ٹیگ سنک** - فہرست ڈھانچے اور ٹیگ پر مبنی سیگمنٹس کو Brevo میں نقل کریں
- **ای کامرس انٹیگریشن** - Deep Data (آرڈرز، گاہک، کارٹس) کو Brevo میں سنک کریں
- **کسٹم آبجیکٹ سنک** - ActiveCampaign کسٹم آبجیکٹس کو Brevo خصوصیات پر میپ کریں
- **اسکور سنک** - لیڈ اور رابطہ اسکورز کو Brevo خصوصیات میں منتقل کریں

## شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. ActiveCampaign اکاؤنٹ (Lite, Plus, Professional, یا Enterprise)
2. Settings > Developer سے API URL اور API key
3. API رسائی کے ساتھ Brevo اکاؤنٹ
4. Tajo اکاؤنٹ

## تصدیق

### API Key تصدیق

ActiveCampaign ایک API key استعمال کرتا ہے جو ہیڈر یا کوئری پیرامیٹر کے طور پر منتقل کیا جاتا ہے۔

```bash
curl "https://{account}.api-us1.com/api/3/contacts" \
  -H "Api-Token: YOUR_API_KEY" \
  -H "Content-Type: application/json"
```

اپنی API URL اور key ActiveCampaign Settings > Developer میں تلاش کریں۔

API URL

آپ کا API URL آپ کے اکاؤنٹ کے لیے منفرد ہے (مثلاً `https://yourcompany.api-us1.com`)۔ ہمیشہ یہ URL استعمال کریں، dashboard URL نہیں۔

## تشکیل

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

```yaml
connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Data sync options
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # List mapping to Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52
```

### فیلڈ میپنگ

ActiveCampaign فیلڈز کو Brevo رابطہ خصوصیات پر میپ کریں:

#### طے شدہ میپنگز

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | رابطہ ای میل (منفرد شناخت کنندہ) |
| `firstName` optional | string | FIRSTNAME خصوصیت پر میپ ہوتا ہے |
| `lastName` optional | string | LASTNAME خصوصیت پر میپ ہوتا ہے |
| `phone` optional | string | SMS خصوصیت پر میپ ہوتا ہے |
| `tags` optional | array | Segmentation کے لیے رابطہ ٹیگز |
| `score` optional | integer | رابطہ engagement اسکور |
| `deals` optional | array | منسلک ڈیل ریکارڈز |
| `fieldValues` optional | array | کسٹم فیلڈ اقدار |

#### کسٹم فیلڈ میپنگ

```yaml
field_mapping:
  # Standard fields
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Engagement fields
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Deal fields
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Custom fields
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER
```

## API اینڈ پوائنٹس

### رابطے

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/3/contacts` | تمام رابطوں کی فہرست |
| `POST` | `/api/3/contacts` | رابطہ بنائیں |
| `PUT` | `/api/3/contacts/{id}` | رابطہ اپ ڈیٹ کریں |
| `GET` | `/api/3/contacts/{id}` | رابطہ حاصل کریں |
| `POST` | `/api/3/contact/sync` | رابطہ سنک کریں (بنائیں یا اپ ڈیٹ کریں) |
| `POST` | `/api/3/import/bulk_import` | رابطوں کا بلک امپورٹ |

### ڈیلز

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/3/deals` | تمام ڈیلز کی فہرست |
| `POST` | `/api/3/deals` | ڈیل بنائیں |
| `PUT` | `/api/3/deals/{id}` | ڈیل اپ ڈیٹ کریں |
| `GET` | `/api/3/dealStages` | تمام ڈیل مراحل کی فہرست |
| `GET` | `/api/3/dealPipelines` | تمام پائپ لائنز کی فہرست |

### آٹومیشنز

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `GET` | `/api/3/automations` | آٹومیشنز کی فہرست |
| `GET` | `/api/3/automations/{id}` | آٹومیشن حاصل کریں |
| `POST` | `/api/3/contactAutomations` | آٹومیشن میں رابطہ شامل کریں |

### ای کامرس (Deep Data)

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/api/3/ecomOrders` | آرڈر بنائیں |
| `GET` | `/api/3/ecomOrders` | آرڈرز کی فہرست |
| `POST` | `/api/3/ecomCustomers` | گاہک بنائیں |
| `GET` | `/api/3/ecomCustomers` | گاہکوں کی فہرست |

### ایونٹ ٹریکنگ

| طریقہ | اینڈ پوائنٹ | تفصیل |
| --- | --- | --- |
| `POST` | `/api/3/tracking/event` | کسٹم ایونٹ ٹریک کریں |
| `GET` | `/api/3/eventTrackingEvents` | تمام ایونٹ ناموں کی فہرست |
| `POST` | `/api/3/eventTrackingEvents` | ایونٹ نام بنائیں |

## ایونٹس

### رابطہ ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `contact_add` | نیا رابطہ بنایا گیا | ویلکم فلو |
| `contact_update` | رابطہ ڈیٹا تبدیل | خصوصیت سنک |
| `contact_tag_added` | ٹیگ تفویض | سیگمنٹ اپ ڈیٹ |
| `contact_tag_removed` | ٹیگ ہٹایا گیا | سیگمنٹ کلین اپ |

### ڈیل ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `deal_add` | نئی ڈیل بنائی گئی | سیلز نوٹیفکیشن |
| `deal_update` | ڈیل مرحلہ تبدیل | پائپ لائن آٹومیشن |
| `deal_tasktype_add` | ڈیل میں ٹاسک شامل | سرگرمی ٹریکنگ |

### آٹومیشن ایونٹس

| ایونٹ | ٹرگر | استعمال کا کیس |
| --- | --- | --- |
| `automation_contact_add` | رابطہ آٹومیشن میں داخل | فلو ٹریکنگ |
| `automation_contact_complete` | رابطہ نے آٹومیشن مکمل کی | اگلے قدم کا ٹرگر |

## کوڈ کی مثالیں

### کنیکٹر کو انیشیلائز کریں

```javascript
import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Connect ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});
```

### رابطوں کو Brevo میں منتقل کریں

```javascript
// Full contact migration with custom fields and tags
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Check sync status
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }
```

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

```javascript
// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: 'customer@example.com',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});
```

## شرح کی حدود

ActiveCampaign API شرح کی حدود:

| پلان | شرح کی حد | تفصیلات |
| --- | --- | --- |
| Lite | 5 درخواستیں/سیکنڈ | فی اکاؤنٹ |
| Plus | 10 درخواستیں/سیکنڈ | فی اکاؤنٹ |
| Professional | 10 درخواستیں/سیکنڈ | فی اکاؤنٹ |
| Enterprise | 20 درخواستیں/سیکنڈ | فی اکاؤنٹ |

اضافی حدود:

- **بلک امپورٹ**: 250 رابطے فی بیچ
- **بلک امپورٹ تعدد**: ایک وقت میں 1 امپورٹ
- **ایونٹ ٹریکنگ**: 2 درخواستیں/سیکنڈ
- **روزانہ کی حد**: کوئی واضح روزانہ کی حد نہیں (صرف شرح پر مبنی)

شرح کی حد ہینڈلنگ

حدود تجاوز ہونے پر ActiveCampaign `429 Too Many Requests` واپس کرتا ہے۔ `Retry-After` ہیڈر قدر کے ساتھ retry لاجک نافذ کریں۔

## ٹربل شوٹنگ

### عام مسائل

| مسئلہ | وجہ | حل |
| --- | --- | --- |
| 403 Forbidden | غلط API key یا URL | AC Settings > Developer میں API URL اور key کی تصدیق کریں |
| رابطہ سنک نہیں ہوا | ڈپلیکیٹ ای میل ہینڈلنگ | upsert رویے کے لیے `/contact/sync` اینڈ پوائنٹ استعمال کریں |
| کسٹم فیلڈ خالی | فیلڈ ID مماثل نہیں | فیلڈز کو ID کے ذریعے میپ کریں، label کے ذریعے نہیں (label تبدیل ہو سکتے ہیں) |
| Webhook موصول نہیں ہوا | Webhook ترتیب نہیں دیا گیا | AC Settings > Developer > Webhooks میں webhooks سیٹ اپ کریں |
| ڈیل نہیں بنائی گئی | مطلوبہ فیلڈز غائب | یقینی بنائیں کہ پائپ لائن، مرحلہ، اور رابطہ فراہم کیے گئے ہیں |

### ڈیبگ موڈ

تفصیلی لاگنگ فعال کریں:

```yaml
connectors:
  activecampaign:
    debug: true
    log_level: verbose
    log_webhooks: true
```

### کنکشن ٹیسٹ کریں

```bash
tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled
```

## بہترین طرز عمل

1. **رابطہ سنک اینڈ پوائنٹ استعمال کریں** - الگ create/update کے بجائے upsert آپریشنز کے لیے `/contact/sync` استعمال کریں
2. **فیلڈز کو ID کے ذریعے میپ کریں** - کسٹم فیلڈ IDs مستحکم ہیں؛ labels تبدیل ہو سکتے ہیں
3. **فہرست رکنیتوں کو محفوظ رکھیں** - رابطہ ڈیٹا کے ساتھ فہرست تفویضات منتقل کریں
4. **ڈیل پائپ لائنز سنک کریں** - مستقل CRM رپورٹنگ کے لیے پائپ لائن مراحل میپ کریں
5. **ایونٹ ٹریکنگ نافذ کریں** - Brevo میں رویاتی ڈیٹا کے لیے سائٹ ٹریکنگ استعمال کریں
6. **بیچ امپورٹس** - 1,000 سے زیادہ رابطوں کے ڈیٹا سیٹس کے لیے بلک امپورٹ استعمال کریں

## سیکیورٹی

- **API Key تصدیق** - `Api-Token` ہیڈر کے ذریعے ٹوکن پر مبنی رسائی
- **Webhook توثیق** - Webhook ماخذ IP رینجز کی توثیق کریں
- **TLS انکرپشن** - تمام API مواصلات HTTPS کے ذریعے انکرپٹڈ
- **اکاؤنٹ سطح کی رسائی** - API key مکمل اکاؤنٹ رسائی فراہم کرتا ہے؛ احتیاط سے استعمال کریں
- **IP پابندیاں** - Enterprise plans پر دستیاب

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

- [ActiveCampaign API دستاویزات](https://developers.activecampaign.com/reference/overview)
- [ActiveCampaign Webhook گائیڈ](https://developers.activecampaign.com/page/webhooks)
- [Mailchimp کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/mailchimp)
- [Brevo کنیکٹر](https://tajo.io/ur/docs/connectors/marketing/brevo)
- [گاہک سنک اسکل](https://tajo.io/ur/docs/skills/data-sync/customer-sync)