Conector ActiveCampaign

Conecte sua conta ActiveCampaign ao Brevo via Tajo para uma migração abrangente de contatos, sincronização do pipeline de negócios, mapeamento de automações e dados de marketing unificados entre as duas plataformas.

Visão geral

Recursos

• Migração de contatos - Migre contatos com campos personalizados, tags e associações de listas
• Sincronização do pipeline de negócios - Sincronize estágios, valores e responsáveis de negócios para acompanhamento de receita
• Mapeamento de automações - Mapeie automações do ActiveCampaign para gatilhos de workflow do Brevo
• Rastreamento de eventos - Sincronize rastreamento de site e eventos personalizados para segmentação comportamental
• Sincronização de listas e tags - Replique estruturas de listas e segmentos baseados em tags no Brevo
• Integração com e-commerce - Sincronize Deep Data (pedidos, clientes, carrinhos) para o Brevo
• Sincronização de objetos personalizados - Mapeie objetos personalizados do ActiveCampaign para atributos do Brevo
• Sincronização de pontuações - Transfira pontuações de leads e contatos para atributos do Brevo

Pré-requisitos

Antes de começar, certifique-se de ter:

1. Uma conta ActiveCampaign (Lite, Plus, Professional ou Enterprise)
2. URL da API e chave de API em Settings > Developer
3. Uma conta Brevo com acesso à API
4. Uma conta Tajo

Autenticação

Autenticação por chave API

O ActiveCampaign usa uma chave API passada como cabeçalho ou parâmetro de consulta.

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

Encontre sua URL da API e chave em ActiveCampaign Settings > Developer.

Configuração

Configuração básica

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

Mapeamento de campos

Mapeie campos do ActiveCampaign para atributos de contato do Brevo:

Mapeamento de campos personalizados

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

Endpoints da API

Contatos

Negócios

Automações

E-commerce (Deep Data)

Rastreamento de eventos

Eventos

Eventos de contato

Eventos de negócio

Eventos de automação

Exemplos de código

Inicializar o conector

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

Migrar contatos para o 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
// }

Rastrear eventos personalizados

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

Limites de taxa

Limites de taxa da API do ActiveCampaign:

Limites adicionais:

• Importação em massa: 250 contatos por lote
• Frequência de importação em massa: 1 importação por vez
• Rastreamento de eventos: 2 requisições/segundo
• Limite diário: Sem limite diário explícito (apenas baseado em taxa)

Solução de problemas

Problemas comuns

Modo de depuração

Ative o log detalhado:

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

Testar conexão

tajo connectors test activecampaign
# ✓ API connection successful
# ✓ Contacts readable
# ✓ Deals readable
# ✓ Automations accessible
# ✓ Event tracking enabled

Melhores práticas

1. Use o endpoint de sincronização de contatos - Use /contact/sync para operações de upsert em vez de criar/atualizar separadamente
2. Mapeie campos por ID - IDs de campos personalizados são estáveis; rótulos podem mudar
3. Preserve associações de lista - Migre atribuições de lista junto com os dados do contato
4. Sincronize pipelines de negócios - Mapeie estágios de pipeline para relatórios de CRM consistentes
5. Implemente rastreamento de eventos - Use rastreamento de site para dados comportamentais no Brevo
6. Importações em lote - Use importação em massa para conjuntos de dados maiores que 1.000 contatos

Segurança

• Autenticação por chave API - Acesso baseado em token via cabeçalho Api-Token
• Verificação de webhook - Valide faixas de IP de origem do webhook
• Criptografia TLS - Toda comunicação com a API é criptografada via HTTPS
• Acesso em nível de conta - A chave API fornece acesso total à conta; use com cuidado
• Restrições de IP - Disponível em planos Enterprise

Recursos relacionados

• Documentação da API do ActiveCampaign
• Guia de webhooks do ActiveCampaign
• Conector Mailchimp
• Conector Brevo
• Skill de sincronização de clientes