ActiveCampaign कनेक्टर

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

अवलोकन

विशेषताएं

• कॉन्टैक्ट माइग्रेशन - कस्टम फ़ील्ड्स, टैग्स, और लिस्ट सदस्यता के साथ कॉन्टैक्ट्स माइग्रेट करें
• डील पाइपलाइन सिंक - राजस्व ट्रैकिंग के लिए डील स्टेज, मान, और मालिकों को सिंक करें
• ऑटोमेशन मैपिंग - ActiveCampaign ऑटोमेशन्स को Brevo वर्कफ़्लो ट्रिगर्स में मैप करें
• इवेंट ट्रैकिंग - व्यवहारिक सेगमेंटेशन के लिए साइट ट्रैकिंग और कस्टम इवेंट्स सिंक करें
• लिस्ट और टैग सिंक - Brevo में लिस्ट संरचनाओं और टैग-आधारित सेगमेंट्स को दोहराएं
• E-commerce इंटीग्रेशन - Deep Data (orders, customers, carts) को 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"

ActiveCampaign Settings > Developer में अपना API URL और key खोजें।

कॉन्फ़िगरेशन

बुनियादी सेटअप

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

कॉन्टैक्ट्स

डील्स

ऑटोमेशन्स

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

अतिरिक्त सीमाएं:

• Bulk import: 250 कॉन्टैक्ट्स प्रति बैच
• Bulk import frequency: एक समय में 1 import
• Event tracking: 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. contact sync एंडपॉइंट का उपयोग करें - अलग create/update के बजाय upsert ऑपरेशन्स के लिए /contact/sync का उपयोग करें
2. फ़ील्ड्स को ID के अनुसार मैप करें - कस्टम फ़ील्ड IDs स्थिर हैं; labels बदल सकते हैं
3. लिस्ट सदस्यता संरक्षित करें - कॉन्टैक्ट डेटा के साथ-साथ लिस्ट असाइनमेंट माइग्रेट करें
4. डील पाइपलाइन सिंक करें - लगातार CRM रिपोर्टिंग के लिए पाइपलाइन स्टेज मैप करें
5. इवेंट ट्रैकिंग लागू करें - Brevo में व्यवहारिक डेटा के लिए साइट ट्रैकिंग का उपयोग करें
6. बैच आयात - 1,000 से अधिक कॉन्टैक्ट्स वाले डेटासेट के लिए bulk import का उपयोग करें

सुरक्षा

• API Key प्रमाणीकरण - Api-Token हेडर के माध्यम से टोकन-आधारित एक्सेस
• Webhook सत्यापन - Webhook स्रोत IP रेंज सत्यापित करें
• TLS एन्क्रिप्शन - सभी API संचार HTTPS के माध्यम से एन्क्रिप्टेड
• खाता-स्तरीय एक्सेस - API key पूर्ण खाता एक्सेस प्रदान करता है; सावधानी से उपयोग करें
• IP प्रतिबंध - Enterprise प्लान्स पर उपलब्ध

संबंधित संसाधन

• ActiveCampaign API Documentation
• ActiveCampaign Webhook Guide
• Mailchimp Connector
• Brevo Connector
• Customer Sync Skill