Brevo コネクター

Brevo コネクター

Brevo アカウントを Tajo に接続して、統一されたコンタクト管理、メール・SMS・WhatsApp にまたがるトランザクショナルメッセージング、包括的なマーケティングオートメーションを実現します。

概要

機能

• マルチチャネルメッセージング - 統一 API でトランザクショナルメール、SMS、WhatsApp を送信
• コンタクト管理 - カスタム属性でコンタクトを作成、更新、セグメント化
• マーケティングキャンペーン - プログラム的にメールキャンペーンを作成・送信
• イベントトラッキング - Brevo Tracker でカスタムイベントとサイトアクティビティを追跡
• eコマース同期 - パーソナライズ化されたキャンペーン向けに商品、注文、カートデータを同期
• ロイヤリティプログラム - ロイヤリティの購読、ポイント、会員データを管理
• ウェブフック対応 - トランザクショナル、マーケティング、CRM イベントのリアルタイム通知
• 会話機能 - ライブチャットウィジェット統合とプログラム的メッセージ管理

前提条件

開始する前に、以下をご用意ください。

1. Brevo アカウント (Free、Starter、Business、Enterprise プランのいずれか)
2. Brevo Settings > API Keys から生成した API キー
3. API アクセス付きの Tajo アカウント
4. メール送信用に認証済みの送信者ドメイン

認証

Brevo は 2 つの認証方式をサポートします。

API キー認証 (推奨)

リクエストごとに api-key ヘッダーに API キーを含めます。直接統合やサーバー間通信に最適です。

curl -X GET "https://api.brevo.com/v3/account" \
  -H "api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json"

OAuth 2.0 認証

ユーザー固有の権限や委任アクセスを必要とする組織内プライベート統合には OAuth 2.0 を使用します。OAuth は有効期間が設定されたトークンベースのシステムを提供します。

設定

基本セットアップ

connectors:
  brevo:
    enabled: true
    api_key: "${BREVO_API_KEY}"
    api_version: "v3"

    # Data sync options
    sync:
      contacts: true
      campaigns: true
      transactional: true
      events: true
      ecommerce: true

    # List assignment
    lists:
      all_customers: 5
      newsletter: 6
      buyers: 7

フィールドマッピング

データフィールドを Brevo コンタクト属性にマッピングします。

カスタム属性マッピング

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # Marketing fields
  opt_in: OPT_IN
  signup_source: SIGNUP_SOURCE
  preferred_language: LANGUAGE

  # eCommerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_REVENUE
  last_order_date: LAST_ORDER_DATE

  # Loyalty fields
  loyalty_tier: VIP_TIER
  loyalty_points: LOYALTY_POINTS

API エンドポイント

コアエンドポイント

eコマースエンドポイント

キャンペーンエンドポイント

イベント

トランザクショナルイベント

eコマースイベント

コード例

コネクターの初期化

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

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

// Connect Brevo account
await tajo.connectors.connect('brevo', {
  apiKey: process.env.BREVO_API_KEY
});

トランザクショナルメールの送信

// Send a transactional email via Brevo
await tajo.brevo.sendTransactionalEmail({
  to: [{ email: '[email protected]', name: 'John Doe' }],
  templateId: 12,
  params: {
    ORDER_ID: '12345',
    ORDER_TOTAL: '$59.99',
    DELIVERY_DATE: '2024-02-15'
  }
});

コンタクトの同期

// Bulk import contacts to Brevo
await tajo.connectors.sync('brevo', {
  type: 'full',
  resources: ['contacts'],
  options: {
    listIds: [5, 6],
    updateExisting: true,
    emptyContactsAttributes: false
  }
});

// Check sync status
const status = await tajo.connectors.status('brevo');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 25400,
//   campaignsSent: 142,
//   eventsTracked: 89320
// }

カスタムイベントの追跡

// Track a custom event for a contact
await tajo.brevo.trackEvent({
  email: '[email protected]',
  event: 'product_purchased',
  eventdata: {
    id: 'txn_98765',
    data: {
      product_name: 'Premium Widget',
      price: 49.99,
      currency: 'USD'
    }
  }
});

レート制限

Brevo はプランに応じて 3 段階のレート制限を適用します。

トラブルシューティング

よくある問題

デバッグモード

詳細ログを有効化します。

connectors:
  brevo:
    debug: true
    log_level: verbose
    log_webhooks: true

接続テスト

tajo connectors test brevo
# ✓ API connection successful
# ✓ Contacts API accessible
# ✓ Transactional email ready
# ✓ SMS sending configured
# ✓ Webhooks registered

ベストプラクティス

1. API キーローテーションを使用 - セキュリティのため API キーを定期的にローテーション
2. ウェブフック検証を実装 - ユーザー名/パスワード認証でウェブフック署名を検証
3. コンタクトをバッチでインポート - 個別 API コールではなく大規模データには一括インポートを使用
4. レート制限を監視 - レート制限ヘッダーを確認して 429 エラーを回避
5. イベントトラッキングを活用 - Brevo Tracker を実装して包括的な顧客行動データを取得
6. 適切な送信者認証を設定 - 最適な到達性のため SPF、DKIM、DMARC を設定

セキュリティ

• API キー認証 - api-key ヘッダー経由のシークレットトークンベースアクセス
• OAuth 2.0 - プライベート統合向けのトークンベース委任アクセス
• ウェブフック検証 - ウェブフックコール向けのユーザー名/パスワード認証
• TLS 暗号化 - すべての API 通信を転送時に暗号化
• IP ホワイトリスト - Enterprise プランで任意の IP 制限が利用可能

関連リソース

• Brevo API ドキュメント
• Brevo 認証ガイド
• Brevo レート制限
• Shopify コネクター
• 顧客同期スキル
• Brevo Contacts API