ActiveCampaign کنیکٹر

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

جائزہ

خصوصیات

• رابطہ منتقلی - کسٹم فیلڈز، ٹیگز، اور فہرست رکنیتوں کے ساتھ رابطے منتقل کریں
• ڈیل پائپ لائن سنک - آمدنی ٹریکنگ کے لیے ڈیل مراحل، اقدار، اور مالکان سنک کریں
• آٹومیشن میپنگ - 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 استعمال کرتا ہے جو ہیڈر یا کوئری پیرامیٹر کے طور پر منتقل کیا جاتا ہے۔

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 میں تلاش کریں۔

تشکیل

بنیادی سیٹ اپ

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 رابطہ خصوصیات پر میپ کریں:

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

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

رابطے

ڈیلز

آٹومیشنز

ای کامرس (Deep Data)

ایونٹ ٹریکنگ

ایونٹس

رابطہ ایونٹس

ڈیل ایونٹس

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

کوڈ کی مثالیں

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

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 میں منتقل کریں

// 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
// }

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

// Forward ActiveCampaign events to Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

شرح کی حدود

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

اضافی حدود:

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

ٹربل شوٹنگ

عام مسائل

ڈیبگ موڈ

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

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

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

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 دستاویزات
• ActiveCampaign Webhook گائیڈ
• Mailchimp کنیکٹر
• Brevo کنیکٹر
• گاہک سنک اسکل