Conector de ActiveCampaign

Conecta tu cuenta de ActiveCampaign con Brevo a través de Tajo para una migración completa de contactos, sincronización del pipeline de negocios, mapeo de automatizaciones y datos de marketing unificados en ambas plataformas.

Resumen

Funcionalidades

• Migración de contactos - Migra contactos con campos personalizados, etiquetas y pertenencia a listas
• Sincronización del pipeline de negocios - Sincroniza etapas, valores y propietarios de negocios para el seguimiento de ingresos
• Mapeo de automatizaciones - Asocia automatizaciones de ActiveCampaign con triggers de flujos de Brevo
• Seguimiento de eventos - Sincroniza el site tracking y los eventos personalizados para segmentación conductual
• Sincronización de listas y etiquetas - Replica estructuras de listas y segmentos basados en etiquetas en Brevo
• Integración eCommerce - Sincroniza los datos Deep Data (pedidos, clientes, carritos) con Brevo
• Sincronización de objetos personalizados - Asocia objetos personalizados de ActiveCampaign con atributos de Brevo
• Sincronización de scoring - Transfiere los scores de leads y contactos a atributos de Brevo

Requisitos previos

Antes de empezar, asegúrate de tener:

1. Una cuenta de ActiveCampaign (Lite, Plus, Professional o Enterprise)
2. La URL y la clave API desde Settings > Developer
3. Una cuenta de Brevo con acceso a la API
4. Una cuenta de Tajo

Autenticación

Autenticación con clave API

ActiveCampaign usa una clave API enviada como cabecera o como parámetro de consulta.

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

Encuentra tu URL y tu clave API en ActiveCampaign Settings > Developer.

Configuración

Configuración 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

Asignación de campos

Asocia los campos de ActiveCampaign con los atributos de contacto de Brevo:

Asignación 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 de la API

Contactos

Negocios

Automatizaciones

eCommerce (Deep Data)

Seguimiento de eventos

Eventos

Eventos de contacto

Eventos de negocio

Eventos de automatización

Ejemplos de código

Inicializar el 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 contactos a 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
// }

Registrar eventos personalizados

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

Límites de velocidad

Límites de velocidad de la API de ActiveCampaign:

Límites adicionales:

• Importación masiva: 250 contactos por lote
• Frecuencia de importación masiva: 1 importación simultánea
• Seguimiento de eventos: 2 peticiones/segundo
• Límite diario: Sin límite diario explícito (solo por velocidad)

Resolución de problemas

Problemas habituales

Modo depuración

Activa el registro detallado:

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

Probar la conexión

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

Buenas prácticas

1. Usa el endpoint de sincronización de contactos - Utiliza /contact/sync para operaciones upsert en vez de crear/actualizar por separado
2. Asocia los campos por ID - Los IDs de campos personalizados son estables; las etiquetas pueden cambiar
3. Preserva la pertenencia a listas - Migra las asignaciones a listas junto con los datos del contacto
4. Sincroniza los pipelines de negocio - Asocia las etapas del pipeline para un reporting de CRM coherente
5. Implementa el seguimiento de eventos - Usa el site tracking para disponer de datos conductuales en Brevo
6. Importaciones por lotes - Usa la importación masiva para conjuntos de datos de más de 1.000 contactos

Seguridad

• Autenticación con clave API - Acceso basado en token mediante la cabecera Api-Token
• Verificación de webhooks - Valida los rangos de IP de origen de los webhooks
• Cifrado TLS - Toda la comunicación con la API se cifra vía HTTPS
• Acceso a nivel de cuenta - La clave API da acceso completo a la cuenta; úsala con cuidado
• Restricciones por IP - Disponibles en los planes Enterprise

Recursos relacionados

• Documentación de la API de ActiveCampaign
• Guía de webhooks de ActiveCampaign
• Conector de Mailchimp
• Conector de Brevo
• Skill de sincronización de clientes