Brevo конектор

Brevo конектор

Свържи своя акаунт в Brevo с Tajo за унифицирано управление на контакти, транзакционно изпращане на съобщения през имейл, SMS и WhatsApp и цялостна маркетингова автоматизация.

Преглед

Функции

• Съобщения през множество канали – Изпращай транзакционни имейли, SMS и WhatsApp от унифициран API
• Управление на контакти – Създавай, обновявай и сегментирай контакти с персонализирани атрибути
• Маркетингови кампании – Програмно създавай и изпращай имейл кампании
• Проследяване на събития – Проследявай персонализирани събития и уебсайт активност чрез Brevo Tracker
• eCommerce синхронизация – Синхронизирай продукти, поръчки и данни за кошница за персонализирани кампании
• Loyalty програми – Управлявай loyalty абонаменти, точки и данни за членове
• Поддръжка на уебхуци – Известия за събития в реално време за транзакционни, маркетингови и CRM събития
• Conversations – Интеграция на live chat widget и програмно управление на съобщения

Предварителни условия

Преди да започнеш, увери се, че имаш:

1. Акаунт в Brevo (Free, Starter, Business или Enterprise план)
2. API ключ, генериран от Brevo Settings > API Keys
3. Акаунт в Tajo с API достъп
4. Верифициран sender domain за изпращане на имейли

Автентикация

Brevo поддържа два метода за автентикация:

Автентикация с API ключ (препоръчително)

Включи своя API ключ в хедъра api-key с всяка заявка. Най-подходящо за директни интеграции и server-to-server комуникация.

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 предоставя token-базирана система с дефинирани периоди на валидност.

Конфигурация

Основна настройка

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

Мапване на полета

Мапвай своите data полета към атрибути на контактите в 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 крайни точки

Основни крайни точки

eCommerce крайни точки

Крайни точки за кампании

Събития

Транзакционни събития

eCommerce събития

Примери с код

Инициализация на конектора

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 налага rate limits в три нива на базата на плана ти:

Отстраняване на проблеми

Чести проблеми

Режим за дебъг

Активирай подробно логване:

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. Внедри верификация на уебхуци – Валидирай подписите на уебхуци с username/password автентикация
3. Пакетирай импорти на контакти – Използвай масов импорт за големи набори от данни вместо отделни API извиквания
4. Мониторирай rate limits – Проверявай rate limit хедърите, за да избегнеш 429 грешки
5. Използвай проследяване на събития – Внедри Brevo Tracker за цялостни данни за поведение на клиентите
6. Настрой правилна sender автентикация – Конфигурирай SPF, DKIM и DMARC за оптимална доставимост

Сигурност

• Автентикация с API ключ – Token-базиран достъп чрез хедъра api-key
• OAuth 2.0 – Token-базиран делегиран достъп за частни интеграции
• Верификация на уебхуци – Username и password автентикация за сигурни извиквания на уебхуци
• TLS криптиране – Цялата API комуникация е криптирана при пренос
• IP whitelisting – Опционални IP ограничения, налични на Enterprise планове

Свързани ресурси

• Brevo API документация
• Brevo ръководство за автентикация
• Brevo Rate Limits
• Shopify конектор
• Customer Sync скил
• Brevo Contacts API