커넥터
커넥터
커넥터는 플랫폼과 Brevo 간의 데이터를 동기화하는 사전 구축된 통합입니다. 인증, 데이터 매핑, 실시간 동기화를 처리합니다.
커넥터란 무엇인가요?
커넥터는 다음 기능을 제공하는 양방향 데이터 브릿지입니다.
- 인증 - 외부 플랫폼과 안전하게 인증합니다
- 데이터 동기화 - 실시간 또는 배치 모드로 동기화합니다
- 필드 매핑 - 플랫폼 스키마와 Brevo 간에 필드를 매핑합니다
- 스킬 활성화 - 동기화된 데이터에 대해 스킬이 작동할 수 있도록 합니다
사용 가능한 커넥터
이커머스 플랫폼
S
Shopify Official
Shopify고객, 주문, 제품 및 장바구니 추적을 포함한 완전한 Shopify 통합
고객 주문 제품 이벤트
W
WooCommerce Official
WordPressREST API 및 웹훅 지원을 포함한 WordPress/WooCommerce 통합
고객 주문 제품
M
Magento
Adobe Commerce엔터프라이즈 이커머스를 위한 Adobe Commerce (Magento 2) 통합
고객 주문 제품
B
BigCommerce
BigCommerce멀티채널 지원을 포함한 BigCommerce 스토어프론트 통합
고객 주문 제품
CRM 시스템
S
Salesforce
Salesforce리드, 연락처 및 기회를 위한 Salesforce CRM 통합
연락처 리드 기회
H
HubSpot
HubSpot연락처, 거래 및 마케팅 자동화를 위한 HubSpot CRM 통합
연락처 거래 활동
P
Pipedrive
Pipedrivepersons, 거래 및 조직을 위한 Pipedrive CRM 통합
Persons 거래 조직
결제
S
Stripe
Stripe구독, 인보이스 및 트랜잭션을 위한 Stripe 결제 통합
고객 이벤트 구독
P
PayPal
PayPal트랜잭션 및 결제 이벤트를 위한 PayPal 통합
트랜잭션 분쟁
커넥터 아키텍처
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데이터 흐름
- 인증: OAuth 2.0 또는 API 키를 통한 안전한 연결
- 실시간 이벤트: 웹훅이 변경 사항을 즉시 캡처합니다
- 배치 동기화: 과거 데이터를 위한 예약 작업
- 필드 매핑: Brevo 속성에 대한 구성 가능한 매핑
- 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 자격 증명을 사용해 플랫폼을 연결하세요.
tajo connectors connect shopify \ --shop-url your-store.myshopify.com \ --api-key $SHOPIFY_API_KEY3. 필드 매핑 구성
플랫폼 필드를 Brevo 연락처 속성에 매핑하세요.
field_mapping: email: email firstName: FIRSTNAME lastName: LASTNAME totalOrders: ORDER_COUNT totalSpent: TOTAL_REVENUE lastOrderDate: LAST_ORDER_DATE4. 데이터 동기화 활성화
데이터 동기화를 시작하세요.
tajo connectors sync shopify --full5. 스킬 활성화
동기화된 데이터를 사용하는 스킬을 활성화하세요.
tajo skills enable abandoned-carttajo skills enable customer-sync커스텀 커넥터
카탈로그에 없는 플랫폼을 위한 커스텀 커넥터를 직접 만들 수 있습니다.
커
커스텀 커넥터
Any PlatformTajo 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;다음 단계
- Shopify 커넥터 - Shopify 시작하기
- Data Mapping Guide - 필드 매핑 학습하기
- Connector SDK - 커스텀 커넥터 구축하기
- Authentication Patterns - 연결 보안 강화하기