موصل ActiveCampaign

اربط حساب ActiveCampaign الخاص بك مع Brevo عبر Tajo لترحيل جهات الاتصال الشامل، ومزامنة خط أنابيب الصفقات، وتعيين الأتمتة، وبيانات تسويقية موحدة عبر كلتا المنصتين.

نظرة عامة

الميزات

• ترحيل جهات الاتصال - ترحيل جهات الاتصال مع الحقول المخصصة والوسوم وعضويات القوائم
• مزامنة خط أنابيب الصفقات - مزامنة مراحل الصفقات وقيمها ومالكيها لتتبع الإيرادات
• تعيين الأتمتة - تعيين أتمتة ActiveCampaign لمحفزات سير عمل Brevo
• تتبع الأحداث - مزامنة تتبع الموقع والأحداث المخصصة للتقسيم السلوكي
• مزامنة القوائم والوسوم - تكرار هياكل القوائم والشرائح القائمة على الوسوم في Brevo
• تكامل التجارة الإلكترونية - مزامنة Deep Data (الطلبات، العملاء، السلات) مع Brevo
• مزامنة الكائنات المخصصة - تعيين الكائنات المخصصة في ActiveCampaign لسمات Brevo
• مزامنة الدرجات - نقل درجات العملاء المحتملين وجهات الاتصال إلى سمات Brevo

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. حساب ActiveCampaign (Lite أو Plus أو Professional أو Enterprise)
2. عنوان URL لـ API ومفتاح API من Settings > Developer
3. حساب Brevo مع وصول إلى API
4. حساب Tajo

المصادقة

مصادقة مفتاح API

يستخدم ActiveCampaign مفتاح API يُمرَّر كترويسة أو معامل استعلام.

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

ابحث عن عنوان URL لـ API ومفتاحك في 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

نقاط نهاية واجهة البرمجة

جهات الاتصال

الصفقات

الأتمتة

التجارة الإلكترونية (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

// ترحيل كامل لجهات الاتصال مع الحقول المخصصة والوسوم
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// التحقق من حالة المزامنة
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

تتبع الأحداث المخصصة

// إعادة توجيه أحداث ActiveCampaign إلى Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

حدود المعدل

حدود معدل ActiveCampaign API:

حدود إضافية:

• الاستيراد بالجملة: 250 جهة اتصال لكل دفعة
• تكرار الاستيراد بالجملة: استيراد واحد في كل مرة
• تتبع الأحداث: طلبان/ثانية
• الحد اليومي: لا يوجد حد يومي صريح (قائم على المعدل فقط)

استكشاف الأخطاء وإصلاحها

المشاكل الشائعة

وضع التصحيح

تفعيل التسجيل المفصل:

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. استخدم نقطة نهاية مزامنة جهات الاتصال - استخدم /contact/sync لعمليات upsert بدلاً من إنشاء/تحديث منفصلة
2. عيّن الحقول بالمعرّف - معرّفات الحقول المخصصة مستقرة؛ التسميات قد تتغير
3. احتفظ بعضويات القوائم - رحّل تعيينات القوائم جنبًا إلى جنب مع بيانات جهات الاتصال
4. زامن خطوط أنابيب الصفقات - عيّن مراحل خط الأنابيب لتقارير CRM متسقة
5. طبّق تتبع الأحداث - استخدم تتبع الموقع للبيانات السلوكية في Brevo
6. استيراد بالدفعات - استخدم الاستيراد بالجملة لمجموعات البيانات الأكبر من 1,000 جهة اتصال

الأمان

• مصادقة مفتاح API - وصول قائم على الرموز عبر ترويسة Api-Token
• التحقق من Webhook - تحقق من نطاقات IP لمصدر webhook
• تشفير TLS - جميع اتصالات API مشفرة عبر HTTPS
• وصول على مستوى الحساب - يوفر مفتاح API وصولاً كاملاً للحساب؛ استخدمه بحذر
• قيود IP - متاحة في خطط Enterprise

موارد ذات صلة

• وثائق ActiveCampaign API
• دليل Webhook ActiveCampaign
• موصل Mailchimp
• موصل Brevo
• مهارة مزامنة العملاء