Konektor ActiveCampaign

Propojte svůj účet ActiveCampaign s Brevo přes Tajo pro komplexní migraci kontaktů, synchronizaci obchodního pipeline, mapování automatizací a sjednocená marketingová data napříč oběma platformami.

Přehled

Funkce

• Migrace kontaktů – Migrujte kontakty s vlastními poli, štítky a členstvím v seznamech
• Synchronizace obchodního pipeline – Synchronizujte fáze, hodnoty a vlastníky obchodů pro sledování příjmů
• Mapování automatizací – Mapujte automatizace ActiveCampaign na spouštěče pracovních toků Brevo
• Sledování událostí – Synchronizujte sledování webu a vlastní události pro behaviorální segmentaci
• Synchronizace seznamů a štítků – Replikujte struktury seznamů a segmenty na základě štítků v Brevo
• Integrace e-commerce – Synchronizujte Deep Data (objednávky, zákazníci, košíky) do Brevo
• Synchronizace vlastních objektů – Mapujte vlastní objekty ActiveCampaign na atributy Brevo
• Synchronizace skóre – Přeneste skóre potenciálních zákazníků a kontaktů na atributy Brevo

Předpoklady

Než začnete, ujistěte se, že máte:

1. Účet ActiveCampaign (Lite, Plus, Professional nebo Enterprise)
2. URL API a API klíč z Nastavení > Developer
3. Účet Brevo s přístupem k API
4. Účet Tajo

Ověření

Ověření API klíčem

ActiveCampaign používá API klíč předávaný jako hlavičku nebo parametr dotazu.

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

URL API a klíč naleznete v ActiveCampaign Nastavení > Developer.

Konfigurace

Základní nastavení

connectors:
  activecampaign:
    enabled: true
    api_url: "https://yourcompany.api-us1.com"
    api_key: "${AC_API_KEY}"

    # Možnosti synchronizace dat
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Mapování seznamů na Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Mapování polí

Mapujte pole ActiveCampaign na atributy kontaktů Brevo:

Mapování vlastních polí

field_mapping:
  # Standardní pole
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Pole zapojení
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Pole obchodů
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Vlastní pole
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

Koncové body API

Kontakty

Obchody

Automatizace

E-commerce (Deep Data)

Sledování událostí

Události

Kontaktní události

Události obchodů

Události automatizací

Příklady kódu

Inicializace konektoru

import { TajoClient } from '@tajo/sdk';

const tajo = new TajoClient({
  apiKey: process.env.TAJO_API_KEY,
  brevoApiKey: process.env.BREVO_API_KEY
});

// Připojení ActiveCampaign
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

Migrace kontaktů do Brevo

// Úplná migrace kontaktů s vlastními poli a štítky
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// Kontrola stavu synchronizace
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

Sledování vlastních událostí

// Přeposílání událostí ActiveCampaign do Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

Omezení rychlosti

Limity rychlosti ActiveCampaign API:

Další limity:

• Hromadný import: 250 kontaktů na dávku
• Frekvence hromadného importu: 1 import najednou
• Sledování událostí: 2 požadavky/sekundu
• Denní limit: Žádný explicitní denní limit (pouze na základě rychlosti)

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test activecampaign
# ✓ Připojení API úspěšné
# ✓ Kontakty čitelné
# ✓ Obchody čitelné
# ✓ Automatizace přístupné
# ✓ Sledování událostí povoleno

Osvědčené postupy

1. Používejte koncový bod synchronizace kontaktů – Používejte /contact/sync pro operace upsert místo oddělených vytváření/aktualizací
2. Mapujte pole podle ID – ID vlastních polí jsou stabilní; popisky se mohou měnit
3. Zachovejte členství v seznamech – Migrujte přiřazení seznamů společně s daty kontaktů
4. Synchronizujte obchodní pipeline – Mapujte fáze pipeline pro konzistentní CRM reporting
5. Implementujte sledování událostí – Používejte sledování webu pro behaviorální data v Brevo
6. Dávkové importy – Používejte hromadný import pro datové sady větší než 1 000 kontaktů

Zabezpečení

• Ověřování API klíčem – Přístup na základě tokenu přes hlavičku Api-Token
• Ověření webhooků – Ověřujte rozsahy zdrojových IP adres webhooků
• Šifrování TLS – Veškerá API komunikace šifrovaná přes HTTPS
• Přístup na úrovni účtu – API klíč poskytuje plný přístup k účtu; používejte opatrně
• IP omezení – Dostupná na plánech Enterprise

Související zdroje

• Dokumentace ActiveCampaign API
• Průvodce webhooky ActiveCampaign
• Konektor Mailchimp
• Konektor Brevo
• Dovednost synchronizace zákazníků