Коннектор ActiveCampaign

Подключите аккаунт ActiveCampaign к Brevo через Tajo для полной миграции контактов, синхронизации воронки сделок, сопоставления автоматизаций и объединения маркетинговых данных обеих платформ.

Обзор

Возможности

• Миграция контактов, перенос контактов с пользовательскими полями, тегами и членством в списках
• Синхронизация воронки сделок, синхронизация этапов, сумм и владельцев сделок для отслеживания выручки
• Сопоставление автоматизаций, маппинг автоматизаций ActiveCampaign на триггеры рабочих процессов Brevo
• Отслеживание событий, синхронизация событий трекинга сайта и пользовательских событий для поведенческой сегментации
• Синхронизация списков и тегов, репликация структуры списков и тег-сегментов в Brevo
• Интеграция с e-commerce, синхронизация Deep Data (заказы, клиенты, корзины) в Brevo
• Синхронизация пользовательских объектов, маппинг пользовательских объектов ActiveCampaign на атрибуты Brevo
• Синхронизация скоров, перенос скоров лидов и контактов в атрибуты Brevo

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

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

Аутентификация

Аутентификация по API Key

ActiveCampaign использует API-ключ, передаваемый в заголовке или параметре запроса.

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

    # Параметры синхронизации данных
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Сопоставление списков с Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Сопоставление полей

Сопоставьте поля ActiveCampaign с атрибутами контактов Brevo:

Сопоставление пользовательских полей

field_mapping:
  # Стандартные поля
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Поля вовлечённости
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Поля сделок
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Пользовательские поля
  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
});

// Подключение 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 контактов в пакете
• Частота массового импорта: 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. Используйте эндпоинт синхронизации контактов, используйте /contact/sync для upsert-операций вместо отдельных создания и обновления
2. Маппируйте поля по ID, ID пользовательских полей стабильны; label может изменяться
3. Сохраняйте членство в списках, мигрируйте назначения списков вместе с данными контактов
4. Синхронизируйте воронки сделок, маппируйте этапы воронки для согласованной CRM-отчётности
5. Реализуйте отслеживание событий, используйте трекинг сайта для поведенческих данных в Brevo
6. Пакетный импорт, используйте массовый импорт для наборов данных свыше 1 000 контактов

Безопасность

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

Связанные ресурсы

• Документация ActiveCampaign API
• Руководство по вебхукам ActiveCampaign
• Коннектор Mailchimp
• Коннектор Brevo
• Скилл синхронизации клиентов