Коннекторы

Коннекторы, это готовые интеграции для синхронизации данных между вашими платформами и Brevo. Они обеспечивают аутентификацию, маппинг данных и синхронизацию в реальном времени.

Что такое коннекторы?

Коннектор, это двунаправленный мост данных, который:

• Аутентифицируется безопасно с внешними платформами
• Синхронизирует данные в режиме реального времени или пакетном режиме
• Маппирует поля между схемами платформ и Brevo
• Активирует скиллы для работы с синхронизированными данными

Доступные коннекторы

Платформы электронной коммерции

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}"

    # Параметры синхронизации данных
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Маппинг полей
    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_KEY

3. Настройте маппинг полей

Сопоставьте поля платформы с атрибутами контактов Brevo:

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE

4. Включите синхронизацию данных

Запустите синхронизацию:

tajo connectors sync shopify --full

5. Активируйте скиллы

Включите скиллы, использующие синхронизированные данные:

tajo skills enable abandoned-cart
tajo skills enable customer-sync

Следующие шаги

• Коннектор Shopify, начало работы с Shopify