BigCommerce конектор

BigCommerce конектор

Свържи магазина си в BigCommerce с Brevo през Tajo за пълна синхронизация на e-commerce данни. Синхронизирай клиенти, поръчки, продукти и събития от кошницата, за да захраниш таргетирани маркетингови кампании, възстановяване на изоставени кошници и автоматизация след покупка.

Преглед

Функции

• Синхронизация на клиенти – Синхронизация на клиентски данни в реално време към контактите в Brevo
• Проследяване на поръчки – Събития от жизнения цикъл на поръчките за потоци след покупка
• Синхронизация на продуктовия каталог – Синхронизирай продукти за имейл препоръки и динамично съдържание
• Изоставена кошница – Проследявай и възстановявай изоставени кошници с автоматизирани имейли
• Поддръжка на множество витрини – Свържи няколко витрини на BigCommerce
• Обновления чрез уебхуци – Обновления на данни в реално време чрез BigCommerce уебхуци
• Персонализирани полета – Мапвай персонализирани полета на BigCommerce към атрибути на контактите в Brevo
• Проследяване на наличности – Синхронизирай нивата на наличности за известия при попълване на склад

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

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

1. Магазин в BigCommerce с достъп Store Owner или Admin
2. API акаунт в BigCommerce с подходящи OAuth обхвати
3. Твоя Store Hash (намира се в URL-а на магазина или в API credentials)
4. Акаунт в Brevo с API достъп
5. Акаунт в Tajo с API credentials

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

API Account credentials

BigCommerce използва OAuth-базирани API акаунти. Създай един в контролния панел на BigCommerce от Settings > API > API Accounts.

Ще получиш:

• Client ID – Идентификатор на приложението
• Client Secret – Таен ключ на приложението (съхранявай сигурно)
• Access Token – Използва се за API автентикация
• Store Hash – Уникален идентификатор на магазина

curl https://api.bigcommerce.com/stores/{store_hash}/v3/catalog/products \
  -H "X-Auth-Token: YOUR_ACCESS_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"

Необходими OAuth обхвати

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

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

connectors:
  bigcommerce:
    enabled: true
    store_hash: "your-store-hash"
    access_token: "your-access-token"
    client_id: "your-client-id"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false

    # Brevo list assignment
    lists:
      all_customers: 40
      buyers: 41
      abandoned_cart: 42

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

Мапвай полетата на клиенти в BigCommerce към атрибути в Brevo:

customer_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS
  company: COMPANY

  # Address fields
  addresses[0].city: CITY
  addresses[0].state: STATE
  addresses[0].country: COUNTRY
  addresses[0].zip: ZIP

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  date_created: SIGNUP_DATE

  # Customer group
  customer_group_id: CUSTOMER_GROUP

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

webhooks:
  - scope: "store/customer/created"
    destination: "customer_created"
  - scope: "store/customer/updated"
    destination: "customer_updated"
  - scope: "store/order/created"
    destination: "order_placed"
  - scope: "store/order/updated"
    destination: "order_updated"
  - scope: "store/order/statusUpdated"
    destination: "order_status_changed"
  - scope: "store/cart/created"
    destination: "cart_created"
  - scope: "store/cart/updated"
    destination: "cart_updated"
  - scope: "store/cart/abandoned"
    destination: "cart_abandoned"
  - scope: "store/inventory/updated"
    destination: "inventory_changed"

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

Примери с код

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

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

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

// Connect BigCommerce store
await tajo.connectors.connect('bigcommerce', {
  storeHash: process.env.BC_STORE_HASH,
  accessToken: process.env.BC_ACCESS_TOKEN,
  clientId: process.env.BC_CLIENT_ID
});

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

// Fetch customers from BigCommerce
const response = await fetch(
  `https://api.bigcommerce.com/stores/${STORE_HASH}/v3/customers?limit=250`,
  {
    headers: {
      'X-Auth-Token': ACCESS_TOKEN,
      'Content-Type': 'application/json'
    }
  }
);

const { data, meta } = await response.json();
// data: [{ id, email, first_name, last_name, phone, ... }]
// meta.pagination: { total, count, per_page, current_page, total_pages }

Обработка на уебхук събития

// BigCommerce webhook handler
app.post('/webhooks/bigcommerce', async (req, res) => {
  const { scope, store_id, data } = req.body;

  // Verify the webhook is from your store
  if (store_id !== process.env.BC_STORE_HASH) {
    return res.status(401).send('Unauthorized');
  }

  // Forward to Tajo
  await tajo.connectors.handleWebhook('bigcommerce', {
    topic: scope,
    payload: data
  });

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

Синхронизация на продуктовия каталог

// Full product catalog sync
await tajo.connectors.sync('bigcommerce', {
  type: 'full',
  resources: ['products'],
  includeVariants: true,
  includeImages: true
});

// Check sync status
const status = await tajo.connectors.status('bigcommerce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 8200,
//   ordersCount: 4500,
//   productsCount: 620
// }

Ограничения на заявките

Допълнителни лимити:

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

Добри практики

1. Използвай V3 API, където е възможно – V3 API предлага по-добра пагинация, филтриране и JSON отговори
2. Мониторирай хедъри за лимити – Следи X-Rate-Limit-Requests-Left, за да избегнеш достигане на лимита
3. Регистрирай уебхуци за синхронизация в реално време – Използвай уебхуци вместо polling за обновления на клиенти и поръчки
4. Пакетни обновления на клиенти – Използвай V3 bulk крайните точки за клиенти за големи синхронизации
5. Включвай вариации в синхронизацията на продукти – Синхронизирай вариациите на продуктите за точно проследяване на наличности
6. Настрой уебхуци за изоставени кошници – Критично за автоматизация на имейли за възстановяване
7. Използвай пагинация – Винаги пагинирай списъчните крайни точки; макс. 250 записа на страница

Сигурност

• Автентикация с OAuth токен – Сигурен достъп до API на база токени
• Scoped разрешения – API акаунтите са ограничени до конкретни обхвати на данни
• Само HTTPS – Цялата API комуникация е криптирана чрез TLS
• Верификация на уебхуци – Проверка на източника на уебхук чрез store hash
• PCI DSS съвместимост – BigCommerce обработва данни за плащания сигурно
• SOC 2 Type II – Платформата BigCommerce е SOC 2 сертифицирана

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

• Shopify конектор
• WooCommerce конектор
• Customer Sync скил
• Abandoned Cart скил