コネクター
コネクター
コネクターは、お使いのプラットフォームと Brevo の間でデータを同期する、あらかじめ構築された統合機能です。認証、データマッピング、リアルタイム同期を担います。
コネクターとは?
コネクター とは、以下を行う双方向のデータブリッジです。
- 認証 - 外部プラットフォームと安全に認証します
- データ同期 - リアルタイムまたはバッチモードで同期します
- フィールドマッピング - プラットフォームのスキーマと Brevo の間でフィールドをマッピングします
- スキルの有効化 - 同期されたデータに対してスキルが動作できるようにします
利用可能なコネクター
eコマースプラットフォーム
S
Shopify Official
Shopify顧客、注文、商品、カートトラッキングを含む Shopify の完全統合
顧客 注文 商品 イベント
W
WooCommerce Official
WordPressREST API とウェブフック対応の WordPress/WooCommerce 統合
顧客 注文 商品
M
Magento
Adobe Commerceエンタープライズ eコマース向け Adobe Commerce (Magento 2) 統合
顧客 注文 商品
B
BigCommerce
BigCommerceマルチチャネル対応の BigCommerce ストアフロント統合
顧客 注文 商品
CRM システム
S
Salesforce
Salesforceリード、コンタクト、商談のための Salesforce CRM 統合
コンタクト リード 商談
H
HubSpot
HubSpotコンタクト、取引、マーケティングオートメーションのための HubSpot CRM 統合
コンタクト 取引 アクティビティ
P
Pipedrive
Pipedrive個人、取引、組織のための Pipedrive CRM 統合
個人 取引 組織
決済
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 の利用を開始
- データマッピングガイド - フィールドマッピングを学ぶ
- Connector SDK - カスタムコネクターを構築
- 認証パターン - 接続のセキュリティを確保