ActiveCampaign 커넥터

ActiveCampaign 계정을 Tajo를 통해 Brevo에 연결하여 포괄적인 연락처 마이그레이션, 거래 파이프라인 동기화, 자동화 매핑, 두 플랫폼 간의 통합된 마케팅 데이터를 구현하십시오.

개요

기능

• 연락처 마이그레이션 - 맞춤 필드, 태그, 목록 멤버십이 포함된 연락처 마이그레이션
• 거래 파이프라인 동기화 - 매출 추적을 위한 거래 단계, 값, 소유자 동기화
• 자동화 매핑 - ActiveCampaign 자동화를 Brevo 워크플로 트리거에 매핑
• 이벤트 추적 - 행동 세그먼테이션을 위한 사이트 추적 및 맞춤 이벤트 동기화
• 목록 및 태그 동기화 - Brevo에서 목록 구조 및 태그 기반 세그먼트 복제
• 이커머스 통합 - Deep Data(주문, 고객, 카트)를 Brevo에 동기화
• 맞춤 객체 동기화 - ActiveCampaign 맞춤 객체를 Brevo 속성에 매핑
• 점수 동기화 - 리드 및 연락처 점수를 Brevo 속성으로 전송

사전 요구 사항

시작하기 전에 다음이 준비되어 있는지 확인하십시오.

1. ActiveCampaign 계정 (Lite, Plus, Professional 또는 Enterprise)
2. Settings > Developer의 API URL 및 API 키
3. API 접근이 가능한 Brevo 계정
4. Tajo 계정

인증

API 키 인증

ActiveCampaign은 헤더 또는 쿼리 매개변수로 전달되는 API 키를 사용합니다.

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

ActiveCampaign Settings > Developer에서 API URL과 키를 찾으십시오.

구성

기본 설정

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

    # 데이터 동기화 옵션
    sync:
      contacts: true
      deals: true
      automations: true
      events: true
      ecommerce: true

    # Brevo로의 목록 매핑
    list_mapping:
      "Main List": 50
      "Newsletter": 51
      "Customers": 52

필드 매핑

ActiveCampaign 필드를 Brevo 연락처 속성에 매핑합니다.

맞춤 필드 매핑

field_mapping:
  # 표준 필드
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  phone: SMS

  # 참여 필드
  score: LEAD_SCORE
  rating: ENGAGEMENT_RATING

  # 거래 필드
  deals.value: DEAL_VALUE
  deals.stage: DEAL_STAGE
  deals.owner: DEAL_OWNER

  # 맞춤 필드
  fieldValues.company: COMPANY_NAME
  fieldValues.industry: INDUSTRY
  fieldValues.plan_tier: PLAN_TIER

API 엔드포인트

연락처

거래

자동화

이커머스 (Deep Data)

이벤트 추적

이벤트

연락처 이벤트

거래 이벤트

자동화 이벤트

코드 예제

커넥터 초기화

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

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

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

연락처를 Brevo로 마이그레이션

// 맞춤 필드 및 태그가 포함된 전체 연락처 마이그레이션
await tajo.connectors.sync('activecampaign', {
  type: 'full',
  resources: ['contacts', 'deals', 'events'],
  options: {
    includeTags: true,
    includeCustomFields: true,
    includeScores: true,
    includeListMemberships: true
  }
});

// 동기화 상태 확인
const status = await tajo.connectors.status('activecampaign');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsMigrated: 28000,
//   dealsSynced: 4500,
//   eventsSynced: 120000
// }

맞춤 이벤트 추적

// ActiveCampaign 이벤트를 Brevo로 전달
await tajo.activecampaign.trackEvent({
  email: '[email protected]',
  event: 'product_demo_requested',
  eventData: {
    product: 'Enterprise Plan',
    source: 'website'
  }
});

속도 제한

ActiveCampaign API 속도 제한:

추가 제한:

• 대량 가져오기: 배치당 250개 연락처
• 대량 가져오기 빈도: 한 번에 1개 가져오기
• 이벤트 추적: 2 요청/초
• 일일 한도: 명시적 일일 한도 없음 (속도 기반만)

문제 해결

일반적인 문제

디버그 모드

자세한 로깅 활성화:

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

연결 테스트

tajo connectors test activecampaign
# ✓ API 연결 성공
# ✓ 연락처 읽기 가능
# ✓ 거래 읽기 가능
# ✓ 자동화 접근 가능
# ✓ 이벤트 추적 활성화됨

모범 사례

1. 연락처 동기화 엔드포인트 사용 - 별도의 생성/업데이트 대신 upsert 작업에 /contact/sync 사용
2. ID로 필드 매핑 - 맞춤 필드 ID는 안정적; 레이블은 변경될 수 있음
3. 목록 멤버십 보존 - 연락처 데이터와 함께 목록 할당 마이그레이션
4. 거래 파이프라인 동기화 - 일관된 CRM 보고를 위해 파이프라인 단계 매핑
5. 이벤트 추적 구현 - Brevo의 행동 데이터를 위해 사이트 추적 사용
6. 일괄 가져오기 - 1,000개 이상의 연락처 데이터 세트에 대량 가져오기 사용

보안

• API 키 인증 - Api-Token 헤더를 통한 토큰 기반 접근
• 웹훅 확인 - 웹훅 소스 IP 범위 검증
• TLS 암호화 - HTTPS를 통한 모든 API 통신 암호화
• 계정 수준 접근 - API 키는 전체 계정 접근을 제공; 주의해서 사용
• IP 제한 - Enterprise 요금제에서 사용 가능

관련 리소스

• ActiveCampaign API 문서
• ActiveCampaign 웹훅 가이드
• Mailchimp 커넥터
• Brevo 커넥터
• 고객 동기화 스킬