ActiveCampaign конектор

Свържи своя акаунт в ActiveCampaign с Brevo чрез Tajo за цялостна миграция на контакти, синхронизация на deal pipeline, мапване на автоматизации и унифицирани маркетингови данни в двете платформи.

Преглед

Функции

• Миграция на контакти – Мигрирай контакти с персонализирани полета, тагове и членства в списъци
• Синхронизация на deal pipeline – Синхронизирай deal етапи, стойности и собственици за проследяване на приходи
• Мапване на автоматизации – Мапвай автоматизации на ActiveCampaign към workflow тригери в Brevo
• Проследяване на събития – Синхронизирай site tracking и персонализирани събития за поведенческа сегментация
• Синхронизация на списъци и тагове – Репликирай структури на списъци и сегменти на базата на тагове в Brevo
• E-commerce интеграция – Синхронизирай Deep Data (поръчки, клиенти, кошници) към Brevo
• Синхронизация на персонализирани обекти – Мапвай персонализирани обекти на ActiveCampaign към атрибути в Brevo
• Синхронизация на скорове – Прехвърляй lead и contact скорове към атрибути в Brevo

Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в ActiveCampaign (Lite, Plus, Professional или Enterprise)
2. API URL и API ключ от Settings > Developer
3. Акаунт в Brevo с API достъп
4. Акаунт в Tajo

Автентикация

Автентикация с API ключ

ActiveCampaign използва API ключ, подаден като хедър или query параметър.

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

Намери своя API URL и ключ в 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 крайни точки

Контакти

Сделки

Автоматизации

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'
  }
});

Ограничения на заявките

API rate limits на ActiveCampaign:

Допълнителни лимити:

• Масов импорт: 250 контакта на пакет
• Честота на масов импорт: 1 импорт едновременно
• Проследяване на събития: 2 заявки/секунда
• Дневен лимит: Без изричен дневен лимит (само на базата на rate)

Отстраняване на проблеми

Чести проблеми

Режим за дебъг

Активирай подробно логване:

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. Използвай sync крайна точка за контакти – Използвай /contact/sync за upsert операции вместо отделни create/update
2. Мапвай полета по ID – ID-тата на персонализираните полета са стабилни; label-ите могат да се променят
3. Запазвай членството в списъци – Мигрирай list assignments заедно с данните на контакта
4. Синхронизирай deal pipeline-и – Мапвай етапите на pipeline за консистентно CRM отчитане
5. Внедри проследяване на събития – Използвай site tracking за поведенчески данни в Brevo
6. Пакетни импорти – Използвай масов импорт за данни с повече от 1 000 контакта

Сигурност

• Автентикация с API ключ – Token-базиран достъп чрез хедъра Api-Token
• Верификация на уебхуци – Валидирай IP диапазоните на източника на уебхук
• TLS криптиране – Цялата API комуникация е криптирана чрез HTTPS
• Достъп на ниво акаунт – API ключът предоставя пълен достъп до акаунта; използвай с внимание
• IP ограничения – Достъпни на Enterprise планове

Свързани ресурси

• ActiveCampaign API документация
• ActiveCampaign ръководство за уебхуци
• Mailchimp конектор
• Brevo конектор
• Customer Sync скил