Коннектор WooCommerce

Коннектор WooCommerce

Подключите магазин WooCommerce к Brevo через Tajo для полной синхронизации данных электронной коммерции. Используйте WooCommerce REST API для синхронизации клиентов, заказов, товаров и данных о купонах для таргетированных маркетинговых кампаний и автоматизированных рабочих процессов.

Обзор

Возможности

• Синхронизация клиентов, синхронизация данных клиентов в реальном времени с контактами Brevo
• Отслеживание заказов, полное отслеживание событий жизненного цикла заказов для постпокупочных потоков
• Синхронизация каталога товаров, синхронизация товаров и их вариантов для email-рекомендаций
• Управление купонами, синхронизация промокодов для рекламных кампаний
• Поддержка вебхуков, обновления в реальном времени через вебхуки WooCommerce
• Брошенные корзины, отслеживание и восстановление брошенных корзин
• Поддержка мультисайтов, подключение мультисайтовых установок WooCommerce на WordPress
• Пользовательские мета-поля, сопоставление пользовательских мета-данных WooCommerce с атрибутами Brevo

Предварительные требования

Прежде чем начать, убедитесь, что у вас есть:

1. Сайт на WordPress с установленным и активированным плагином WooCommerce
2. WooCommerce REST API включён (Settings > Advanced > REST API)
3. Сгенерированный Consumer Key и Consumer Secret
4. Сайт должен использовать HTTPS для аутентификации API
5. Аккаунт Brevo с доступом к API
6. Аккаунт Tajo с API-учётными данными

Аутентификация

REST API Keys

WooCommerce использует пары Consumer Key и Consumer Secret для аутентификации. Генерируйте их в WooCommerce > Settings > Advanced > REST API.

OAuth 1.0a (HTTPS-сайты)

curl https://yourstore.com/wp-json/wc/v3/orders \
  -u "consumer_key:consumer_secret"

Аутентификация через строку запроса (HTTPS)

curl "https://yourstore.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx"

Уровни разрешений

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

Базовая настройка

connectors:
  woocommerce:
    enabled: true
    store_url: "https://yourstore.com"
    consumer_key: "ck_your_consumer_key"
    consumer_secret: "cs_your_consumer_secret"
    api_version: "wc/v3"
    verify_ssl: true

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

    # Назначение листов Brevo
    lists:
      all_customers: 50
      buyers: 51
      abandoned_cart: 52

Сопоставление полей клиентов

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

customer_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  billing.phone: SMS
  billing.company: COMPANY
  billing.city: CITY
  billing.state: STATE
  billing.country: COUNTRY
  billing.postcode: ZIP

  # Метрики электронной коммерции (вычисляемые)
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  date_created: SIGNUP_DATE

  # Мета-поля
  meta_data.loyalty_points: LOYALTY_POINTS
  meta_data.preferred_category: PREF_CATEGORY

Конфигурация вебхуков

Зарегистрируйте вебхуки в WooCommerce > Settings > Advanced > Webhooks:

webhooks:
  - topic: "customer.created"
    event: "customer_created"
  - topic: "customer.updated"
    event: "customer_updated"
  - topic: "order.created"
    event: "order_placed"
  - topic: "order.updated"
    event: "order_updated"
  - topic: "order.completed"
    event: "order_fulfilled"
  - topic: "order.refunded"
    event: "order_refunded"
  - topic: "coupon.created"
    event: "coupon_created"
  - topic: "product.created"
    event: "product_added"
  - topic: "product.updated"
    event: "product_updated"

Эндпоинты API

Примеры кода

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

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

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

// Подключение магазина WooCommerce
await tajo.connectors.connect('woocommerce', {
  storeUrl: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET
});

Получение и синхронизация клиентов

// Получение клиентов через WooCommerce REST API
const WooCommerce = require('@woocommerce/woocommerce-rest-api').default;

const api = new WooCommerce({
  url: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET,
  version: 'wc/v3'
});

// Список клиентов с пагинацией
const response = await api.get('customers', {
  per_page: 100,
  page: 1,
  orderby: 'registered_date',
  order: 'desc'
});

const customers = response.data;
// [{ id, email, first_name, last_name, billing, shipping, ... }]

// Информация о пагинации из заголовков
const totalPages = response.headers['x-wp-totalpages'];
const totalItems = response.headers['x-wp-total'];

Обработка событий вебхука

// Обработчик вебхуков WooCommerce
app.post('/webhooks/woocommerce', async (req, res) => {
  const topic = req.headers['x-wc-webhook-topic'];
  const signature = req.headers['x-wc-webhook-signature'];

  // Проверка подписи вебхука
  const expectedSignature = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('base64');

  if (signature !== expectedSignature) {
    return res.status(401).send('Invalid signature');
  }

  // Пересылка в Tajo
  await tajo.connectors.handleWebhook('woocommerce', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});

Пакетные операции

// Пакетное создание, обновление и удаление товаров
const batchResponse = await api.post('products/batch', {
  create: [
    { name: 'New Product', type: 'simple', regular_price: '19.99' }
  ],
  update: [
    { id: 123, regular_price: '24.99' }
  ],
  delete: [456]
});

Ограничения скорости

WooCommerce сам по себе не устанавливает ограничения API, но базовый WordPress-сервер и хостинг-провайдер могут устанавливать лимиты:

Устранение неполадок

Лучшие практики

1. Используйте вебхуки для синхронизации в реальном времени, настраивайте вебхуки WooCommerce вместо опроса API
2. Верифицируйте подписи вебхуков, всегда валидируйте заголовок X-WC-Webhook-Signature
3. Пагинируйте все list-запросы, используйте параметры page и per_page; проверяйте заголовок X-WP-TotalPages
4. Используйте параметр _fields, запрашивайте только нужные поля для уменьшения размера ответа
5. Пакетные операции, используйте пакетные эндпоинты для массового создания/обновления/удаления (до 100 элементов)
6. Планируйте крупные синхронизации, запускайте полные начальные синхронизации в нерабочее время
7. Включайте HTTPS, WooCommerce API требует TLS для OAuth-аутентификации

Безопасность

• OAuth 1.0a, безопасная аутентификация через пары Consumer Key/Secret
• HMAC-подписи вебхуков, SHA-256 верификация подписи для входящих вебхуков
• Требуется HTTPS, API требует TLS-шифрования для аутентификации
• Ограничение прав, API-ключи можно настроить на Read, Write или Read/Write
• Безопасность WordPress, наследует обновления безопасности ядра WordPress
• Аспекты PCI, платёжные данные обрабатываются платёжными шлюзами WooCommerce, не раскрываются через API

Связанные ресурсы

• Коннектор Shopify
• Коннектор BigCommerce
• Скилл синхронизации клиентов
• Скилл брошенной корзины