ActiveCampaign Konektor

Povežite svoj ActiveCampaign račun s Brevom putem Taja za sveobuhvatnu migraciju kontakata, sinkronizaciju prodajnog cjevovoda, mapiranje automatizacija i unificiranje marketinških podataka na obje platforme.

Pregled

Značajke

• Migracija kontakata - Migrirajte kontakte s prilagođenim poljima, oznakama i članstvima na popisu
• Sinkronizacija prodajnog cjevovoda - Sinkronizirajte faze, vrijednosti i vlasnike poslova za praćenje prihoda
• Mapiranje automatizacija - Mapirajte ActiveCampaign automatizacije na okidače Brevo tijekova rada
• Praćenje događaja - Sinkronizirajte praćenje stranica i prilagođene događaje za bihevioralnu segmentaciju
• Sinkronizacija popisa i oznaka - Replicirajte strukture popisa i segmente temeljene na oznakama u Brevu
• E-commerce integracija - Sinkronizirajte Deep Data (narudžbe, klijente, košarice) s Brevom
• Sinkronizacija prilagođenih objekata - Mapirajte ActiveCampaign prilagođene objekte na Brevo atribute
• Sinkronizacija bodova - Prenesite bodove leadova i kontakata na Brevo atribute

Preduvjeti

Prije nego što počnete, osigurajte da imate:

1. ActiveCampaign račun (Lite, Plus, Professional ili Enterprise)
2. API URL i API ključ iz Postavke > Developer
3. Brevo račun s API pristupom
4. Tajo račun

Autentifikacija

Autentifikacija API ključem

ActiveCampaign koristi API ključ proslijeđen kao zaglavlje ili parametar upita.

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

Pronađite svoj API URL i ključ u ActiveCampaign Postavke > Developer.

Konfiguracija

Osnovna konfiguracija

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

    # Opcije sinkronizacije podataka
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Mapiranje popisa na Brevo
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

Mapiranje polja

Mapirajte ActiveCampaign polja na atribute kontakata u Brevu:

Mapiranje prilagođenih polja

field_mapping:
  # Standardna polja
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # Polja angažmana
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # Polja poslova
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # Prilagođena polja
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

API krajnje točke

Kontakti

Poslovi

Automatizacije

E-commerce (Deep Data)

Praćenje događaja

Događaji

Događaji kontakata

Događaji poslova

Događaji automatizacija

Primjeri koda

Inicijalizacija konektora

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

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

// Povezivanje ActiveCampaign-a
await tajo.connectors.connect('activecampaign', {
  apiUrl: process.env.AC_API_URL,
  apiKey: process.env.AC_API_KEY
});

Migracija kontakata u Brevo

// Potpuna migracija kontakata s prilagođenim poljima i oznakama
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

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

Praćenje prilagođenih događaja

// Prosljeđivanje ActiveCampaign događaja u Brevo
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

Ograničenja brzine

Ograničenja ActiveCampaign API-ja:

Dodatna ograničenja:

• Skupni uvoz: 250 kontakata po seriji
• Učestalost skupnog uvoza: 1 uvoz istovremeno
• Praćenje događaja: 2 zahtjeva/sekundi
• Dnevno ograničenje: Nema eksplicitnog dnevnog ograničenja (samo ograničenje brzine)

Rješavanje problema

Uobičajeni problemi

Način otklanjanja grešaka

Omogućite opširno zapisivanje:

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

Testiranje veze

tajo connectors test activecampaign
# ✓ API veza uspješna
# ✓ Kontakti čitljivi
# ✓ Poslovi čitljivi
# ✓ Automatizacije dostupne
# ✓ Praćenje događaja omogućeno

Preporučene prakse

1. Koristite krajnju točku za sinkronizaciju kontakata - Koristite /contact/sync za upsert operacije umjesto zasebnog stvaranja/ažuriranja
2. Mapirajte polja po ID-u - ID-ovi prilagođenih polja su stabilni; oznake se mogu promijeniti
3. Sačuvajte članstva na popisima - Migrirajte dodjele popisa zajedno s podacima kontakata
4. Sinkronizirajte prodajne cjevovode - Mapirajte faze cjevovoda za dosljedno CRM izvješćivanje
5. Implementirajte praćenje događaja - Koristite praćenje stranica za bihevioralne podatke u Brevu
6. Skupni uvozi - Koristite skupni uvoz za skupove podataka veće od 1.000 kontakata

Sigurnost

• Autentifikacija API ključem - Pristup temeljen na tokenima putem zaglavlja Api-Token
• Verifikacija webhookova - Provjerite IP raspone izvora webhookova
• TLS enkripcija - Sva API komunikacija šifrirana putem HTTPS-a
• Pristup na razini računa - API ključ pruža potpuni pristup računu; koristite s oprezom
• IP ograničenja - Dostupno na Enterprise planovima

Povezani resursi

• ActiveCampaign API dokumentacija
• ActiveCampaign vodič za Webhooks
• Mailchimp Konektor
• Brevo Konektor
• Vještina sinkronizacije korisnika