Konektor ActiveCampaign

Połącz swoje konto ActiveCampaign z Brevo przez Tajo dla kompleksowej migracji kontaktów, synchronizacji pipeline transakcji, mapowania automatyzacji i ujednoliconych danych marketingowych na obu platformach.

Przegląd

Funkcje

• Migracja kontaktów - Migruj kontakty z niestandardowymi polami, tagami i przynależnościami do list
• Synchronizacja pipeline transakcji - Synchronizuj etapy transakcji, wartości i właścicieli dla śledzenia przychodów
• Mapowanie automatyzacji - Mapuj automatyzacje ActiveCampaign na wyzwalacze workflow Brevo
• Śledzenie zdarzeń - Synchronizuj śledzenie witryny i niestandardowe zdarzenia dla segmentacji behawioralnej
• Synchronizacja list i tagów - Replikuj struktury list i segmenty oparte na tagach w Brevo
• Integracja e-commerce - Synchronizuj Deep Data (zamówienia, klientów, koszyki) z Brevo
• Synchronizacja niestandardowych obiektów - Mapuj niestandardowe obiekty ActiveCampaign na atrybuty Brevo
• Synchronizacja wyników - Przenieś wyniki leadów i kontaktów do atrybutów Brevo

Wymagania wstępne

Zanim zaczniesz, upewnij się, że masz:

1. Konto ActiveCampaign (Lite, Plus, Professional lub Enterprise)
2. URL API i klucz API z Settings > Developer
3. Konto Brevo z dostępem do API
4. Konto Tajo

Uwierzytelnianie

Uwierzytelnianie kluczem API

ActiveCampaign używa klucza API przekazywanego jako nagłówek lub parametr zapytania.

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

Znajdź URL API i klucz w ActiveCampaign Settings > Developer.

Konfiguracja

Podstawowa konfiguracja

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

Mapowanie pól

Mapuj pola ActiveCampaign na atrybuty kontaktów Brevo:

Mapowanie niestandardowych pól

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

Endpointy API

Kontakty

Transakcje

Automatyzacje

E-commerce (Deep Data)

Śledzenie zdarzeń

Zdarzenia

Zdarzenia kontaktów

Zdarzenia transakcji

Zdarzenia automatyzacji

Przykłady kodu

Inicjalizacja konektora

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

Migruj kontakty do 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
// }

Śledź niestandardowe zdarzenia

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

Limity API

Limity szybkości ActiveCampaign API:

Dodatkowe limity:

• Import zbiorczy: 250 kontaktów na partię
• Częstotliwość importu zbiorczego: 1 import na raz
• Śledzenie zdarzeń: 2 żądania/sekundę
• Limit dzienny: Brak wyraźnego limitu dziennego (tylko oparty na szybkości)

Rozwiązywanie problemów

Typowe problemy

Tryb debug

Włącz szczegółowe logowanie:

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

Test połączenia

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

Najlepsze praktyki

1. Używaj endpointa sync kontaktu - Używaj /contact/sync dla operacji upsert zamiast osobnych create/update
2. Mapuj pola przez ID - ID niestandardowych pól są stabilne; etykiety mogą się zmieniać
3. Zachowaj przynależności do list - Migruj przypisania list razem z danymi kontaktów
4. Synchronizuj pipeline transakcji - Mapuj etapy pipeline’u dla spójnego raportowania CRM
5. Wdrożyj śledzenie zdarzeń - Używaj śledzenia witryny dla danych behawioralnych w Brevo
6. Importy wsadowe - Używaj importu zbiorczego dla zestawów danych większych niż 1 000 kontaktów

Bezpieczeństwo

• Uwierzytelnianie kluczem API - Dostęp oparty na tokenach przez nagłówek Api-Token
• Weryfikacja webhooków - Waliduj zakresy IP źródeł webhooków
• Szyfrowanie TLS - Cała komunikacja API szyfrowana przez HTTPS
• Dostęp na poziomie konta - Klucz API zapewnia pełny dostęp do konta; używaj ostrożnie
• Ograniczenia IP - Dostępne na planach Enterprise

Powiązane zasoby

• Dokumentacja ActiveCampaign API
• Przewodnik webhooków ActiveCampaign
• Konektor Mailchimp
• Konektor Brevo
• Skill synchronizacji klientów