Connettore ActiveCampaign

Collega il tuo account ActiveCampaign a Brevo tramite Tajo per una migrazione completa dei contatti, sincronizzazione della pipeline dei deal, mappatura delle automazioni e dati marketing unificati tra entrambe le piattaforme.

Panoramica

Funzionalità

• Migrazione dei contatti - Migra i contatti con campi personalizzati, tag e appartenenze a liste
• Sincronizzazione pipeline deal - Sincronizza stage, valori e proprietari dei deal per il tracciamento dei ricavi
• Mappatura delle automazioni - Mappa le automazioni ActiveCampaign sui trigger di workflow Brevo
• Tracciamento eventi - Sincronizza tracking del sito ed eventi personalizzati per la segmentazione comportamentale
• Sync di liste e tag - Replica le strutture di lista e i segmenti basati su tag in Brevo
• Integrazione e-commerce - Sincronizza i Deep Data (ordini, clienti, carrelli) verso Brevo
• Sync oggetti personalizzati - Mappa gli oggetti personalizzati ActiveCampaign agli attributi Brevo
• Sync dei punteggi - Trasferisci i punteggi di lead e contatti agli attributi Brevo

Prerequisiti

Prima di iniziare, assicurati di avere:

1. Un account ActiveCampaign (Lite, Plus, Professional o Enterprise)
2. URL e chiave API da Settings > Developer
3. Un account Brevo con accesso API
4. Un account Tajo

Autenticazione

Autenticazione con chiave API

ActiveCampaign usa una chiave API passata come header o parametro di query.

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

Trova URL e chiave API in ActiveCampaign Settings > Developer.

Configurazione

Setup di base

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

Mappatura dei campi

Mappa i campi ActiveCampaign agli attributi di contatto Brevo:

Mappatura dei campi personalizzati

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

Endpoint API

Contatti

Deal

Automazioni

E-commerce (Deep Data)

Tracciamento eventi

Eventi

Eventi contatto

Eventi deal

Eventi di automazione

Esempi di codice

Inizializza il connettore

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

Migra i contatti su 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
// }

Traccia eventi personalizzati

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

Limiti di velocità

Limiti di velocità dell’API ActiveCampaign:

Limiti aggiuntivi:

• Importazione in blocco: 250 contatti per batch
• Frequenza importazione in blocco: 1 import alla volta
• Tracciamento eventi: 2 richieste/secondo
• Limite giornaliero: Nessun limite giornaliero esplicito (solo basato sulla velocità)

Risoluzione dei problemi

Problemi comuni

Modalità debug

Abilita il logging dettagliato:

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

Testa la connessione

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

Best practice

1. Usa l’endpoint contact sync - Usa /contact/sync per le operazioni di upsert invece di create/update separate
2. Mappa i campi per ID - Gli ID dei campi personalizzati sono stabili; le label possono cambiare
3. Preserva le appartenenze alle liste - Migra le assegnazioni a liste insieme ai dati dei contatti
4. Sincronizza le pipeline dei deal - Mappa gli stage delle pipeline per una reportistica CRM coerente
5. Implementa il tracciamento eventi - Usa il site tracking per dati comportamentali in Brevo
6. Importazioni in batch - Usa il bulk import per dataset più grandi di 1.000 contatti

Sicurezza

• Autenticazione con chiave API - Accesso basato su token tramite header Api-Token
• Verifica webhook - Convalida gli intervalli IP di origine dei webhook
• Cifratura TLS - Tutte le comunicazioni API cifrate via HTTPS
• Accesso a livello di account - La chiave API fornisce accesso completo all’account; usala con cura
• Restrizioni IP - Disponibili sui piani Enterprise

Risorse correlate

• Documentazione API ActiveCampaign
• Guida ai webhook ActiveCampaign
• Connettore Mailchimp
• Connettore Brevo
• Skill Customer Sync