コネクター

コネクター

コネクターは、お使いのプラットフォームと Brevo の間でデータを同期する、あらかじめ構築された統合機能です。認証、データマッピング、リアルタイム同期を担います。

コネクターとは?

コネクター とは、以下を行う双方向のデータブリッジです。

  • 認証 - 外部プラットフォームと安全に認証します
  • データ同期 - リアルタイムまたはバッチモードで同期します
  • フィールドマッピング - プラットフォームのスキーマと Brevo の間でフィールドをマッピングします
  • スキルの有効化 - 同期されたデータに対してスキルが動作できるようにします

利用可能なコネクター

eコマースプラットフォーム

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で無料で始める