커넥터

커넥터

커넥터는 플랫폼과 Brevo 간의 데이터를 동기화하는 사전 구축된 통합입니다. 인증, 데이터 매핑, 실시간 동기화를 처리합니다.

커넥터란 무엇인가요?

커넥터는 다음 기능을 제공하는 양방향 데이터 브릿지입니다.

  • 인증 - 외부 플랫폼과 안전하게 인증합니다
  • 데이터 동기화 - 실시간 또는 배치 모드로 동기화합니다
  • 필드 매핑 - 플랫폼 스키마와 Brevo 간에 필드를 매핑합니다
  • 스킬 활성화 - 동기화된 데이터에 대해 스킬이 작동할 수 있도록 합니다

사용 가능한 커넥터

이커머스 플랫폼

CRM 시스템

결제

커넥터 아키텍처

graph LR
A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
B <-->|Real-time Webhooks| C[Event Processing]
C --> D[Field Mapping]
D --> E[Brevo API]
B <-->|Batch Sync| F[Scheduled Jobs]
F --> D

데이터 흐름

  1. 인증: OAuth 2.0 또는 API 키를 통한 안전한 연결
  2. 실시간 이벤트: 웹훅이 변경 사항을 즉시 캡처합니다
  3. 배치 동기화: 과거 데이터를 위한 예약 작업
  4. 필드 매핑: Brevo 속성에 대한 구성 가능한 매핑
  5. Brevo API: 데이터가 연락처, 이벤트 및 리스트로 동기화됩니다

설정

기본 설정

connectors:
shopify:
enabled: true
shop_url: "your-store.myshopify.com"
api_key: "${SHOPIFY_API_KEY}"
api_secret: "${SHOPIFY_API_SECRET}"
# Data sync settings
sync:
customers: true
orders: true
products: true
carts: true
# Field mappings
field_mapping:
email: email
first_name: FIRSTNAME
last_name: LASTNAME
total_spent: TOTAL_SPENT

동기화 모드

모드설명사용 사례
실시간웹훅을 통한 즉시 동기화중요한 고객 업데이트
배치예약된 동기화 (매시간/매일)과거 데이터, 리포트
하이브리드실시간 + 배치 폴백두 방식의 장점을 모두 활용

빠른 시작

1. 커넥터 선택

위 카탈로그에서 플랫폼에 맞는 커넥터를 선택하세요.

2. 인증

OAuth 또는 API 자격 증명을 사용해 플랫폼을 연결하세요.

Terminal window
tajo connectors connect shopify \
--shop-url your-store.myshopify.com \
--api-key $SHOPIFY_API_KEY

3. 필드 매핑 구성

플랫폼 필드를 Brevo 연락처 속성에 매핑하세요.

field_mapping:
email: email
firstName: FIRSTNAME
lastName: LASTNAME
totalOrders: ORDER_COUNT
totalSpent: TOTAL_REVENUE
lastOrderDate: LAST_ORDER_DATE

4. 데이터 동기화 활성화

데이터 동기화를 시작하세요.

Terminal window
tajo connectors sync shopify --full

5. 스킬 활성화

동기화된 데이터를 사용하는 스킬을 활성화하세요.

Terminal window
tajo skills enable abandoned-cart
tajo skills enable customer-sync

커스텀 커넥터

카탈로그에 없는 플랫폼을 위한 커스텀 커넥터를 직접 만들 수 있습니다.

커스텀 커넥터

Any Platform

Tajo Connector SDK를 사용해 커스텀 커넥터를 구축하세요

커스텀 데이터

Connector SDK

import { ConnectorSDK } from '@tajo/connector-sdk';
const connector = new ConnectorSDK({
name: 'my-platform',
version: '1.0.0',
// Authentication
auth: {
type: 'oauth2',
authorizationUrl: 'https://api.myplatform.com/oauth/authorize',
tokenUrl: 'https://api.myplatform.com/oauth/token'
},
// Data mappings
resources: {
customers: {
endpoint: '/api/customers',
mapping: {
email: 'contact.email',
name: 'contact.full_name'
}
}
},
// Webhooks
webhooks: {
customer_created: '/webhooks/customer',
order_placed: '/webhooks/order'
}
});
export default connector;

다음 단계

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

AI 어시스턴트

안녕하세요! 문서에 대해 무엇이든 물어보세요.

Brevo로 무료로 시작하기