BigCommerce-Connector

Verbinde deinen BigCommerce-Shop mit Brevo über Tajo für eine vollständige Synchronisation deiner E-Commerce-Daten. Synchronisiere Kund:innen, Bestellungen, Produkte und Warenkorb-Events, um zielgerichtete Marketingkampagnen, Warenkorb-Abandonment-Recovery und automatisierte Post-Purchase-Flows zu ermöglichen.

Überblick

Funktionen

• Kundendaten-Synchronisation – Echtzeit-Synchronisation von Kundendaten mit Brevo-Kontakten
• Bestellverfolgung – Bestell-Lifecycle-Events für Post-Purchase-Marketing-Flows
• Produktkatalog-Synchronisation – Synchronisiere Produkte für E-Mail-Empfehlungen und dynamische Inhalte
• Warenkorb-Abandonment – Verfolge und reaktiviere abgebrochene Warenkörbe mit automatisierten E-Mails
• Multi-Storefront-Unterstützung – Verbinde mehrere BigCommerce-Storefronts
• Webhook-gesteuerte Updates – Echtzeit-Datenaktualisierungen über BigCommerce-Webhooks
• Benutzerdefinierte Felder – Mappe BigCommerce-Custom-Fields auf Brevo-Kontaktattribute
• Bestandsverfolgung – Synchronisiere Lagerbestände für Wieder-verfügbar-Benachrichtigungen

Voraussetzungen

Bevor du beginnst, stelle sicher, dass du Folgendes hast:

1. Einen BigCommerce-Shop mit Store-Owner- oder Admin-Zugang
2. Einen BigCommerce-API-Account mit geeigneten OAuth-Scopes
3. Deinen Store Hash (findest du in deiner Shop-URL oder in den API-Zugangsdaten)
4. Einen Brevo-Account mit API-Zugang
5. Einen Tajo-Account mit API-Zugangsdaten

Authentifizierung

API-Account-Zugangsdaten

BigCommerce nutzt OAuth-basierte API-Accounts. Erstelle einen in deinem BigCommerce-Control-Panel unter Settings > API > API Accounts.

Du erhältst:

• Client ID – Dein App-Identifier
• Client Secret – Dein App-Secret (sicher aufbewahren)
• Access Token – Wird für die API-Authentifizierung verwendet
• Store Hash – Dein eindeutiger Shop-Identifier

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"

Erforderliche OAuth-Scopes

Konfiguration

Grundlegende Einrichtung

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

Kundenfeld-Mapping

Mappe BigCommerce-Kundenfelder auf Brevo-Attribute:

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

Webhook-Konfiguration

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-Endpoints

Code-Beispiele

BigCommerce-Connector initialisieren

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
});

Kund:innen abrufen und synchronisieren

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

Webhook-Events verarbeiten

// 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');
});

Produktkatalog synchronisieren

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

Rate Limits

Zusätzliche Limits:

Fehlerbehebung

Best Practices

1. Nutze wo möglich die V3-API – Die V3-API bietet bessere Pagination, Filterung und JSON-Antworten
2. Überwache Rate-Limit-Header – Verfolge X-Rate-Limit-Requests-Left, um Limits nicht zu überschreiten
3. Webhooks für Echtzeit-Synchronisation registrieren – Nutze Webhooks statt Polling für Kunden- und Bestell-Updates
4. Kunden-Updates batchen – Nutze die V3-Bulk-Endpoints für große Datensynchronisationen
5. Varianten in die Produkt-Synchronisation einbeziehen – Synchronisiere Produktvarianten für genaue Bestandsverfolgung
6. Webhooks für abgebrochene Warenkörbe einrichten – Entscheidend für Warenkorb-Recovery-Automation
7. Pagination nutzen – List-Endpoints immer paginieren; max. 250 Datensätze pro Seite

Sicherheit

• OAuth-Token-Authentifizierung – Sicherer Token-basierter API-Zugriff
• Gescopete Berechtigungen – API-Accounts auf spezifische Daten-Scopes beschränkt
• Nur HTTPS – Gesamte API-Kommunikation via TLS verschlüsselt
• Webhook-Verifizierung – Webhook-Quelle über Store Hash verifizieren
• PCI-DSS-konform – BigCommerce verarbeitet Zahlungsdaten sicher
• SOC 2 Type II – Die BigCommerce-Plattform ist SOC-2-zertifiziert

Verwandte Ressourcen

• Shopify-Connector
• WooCommerce-Connector
• Customer-Sync-Skill
• Abandoned-Cart-Skill