Connecteur BigCommerce

Connecteur BigCommerce

Connectez votre boutique BigCommerce à Brevo via Tajo pour une synchronisation complète des données e-commerce. Synchronisez clients, commandes, produits et événements de panier pour alimenter des campagnes marketing ciblées, la récupération de paniers abandonnés et l’automatisation post-achat.

Vue d’ensemble

Fonctionnalités

• Synchronisation des clients, Synchronisation en temps réel des données client vers les contacts Brevo
• Suivi des commandes, Événements du cycle de vie des commandes pour les workflows marketing post-achat
• Synchronisation du catalogue produits, Synchronisez les produits pour les recommandations e-mail et le contenu dynamique
• Abandon de panier, Suivez et récupérez les paniers abandonnés avec des e-mails automatisés
• Prise en charge multi-vitrines, Connectez plusieurs vitrines BigCommerce
• Mises à jour via webhooks, Mises à jour en temps réel via les webhooks BigCommerce
• Champs personnalisés, Mappez les champs personnalisés BigCommerce vers les attributs de contact Brevo
• Suivi des stocks, Synchronisez les niveaux de stock pour les notifications de retour en stock

Prérequis

Avant de commencer, assurez-vous de disposer de :

1. Une boutique BigCommerce avec accès Store Owner ou Admin
2. Un compte API BigCommerce avec les scopes OAuth appropriés
3. Votre Store Hash (trouvé dans l’URL de votre boutique ou vos identifiants API)
4. Un compte Brevo avec accès API
5. Un compte Tajo avec des identifiants API

Authentification

Identifiants de compte API

BigCommerce utilise des comptes API basés sur OAuth. Créez-en un dans votre panneau de contrôle BigCommerce sous Settings > API > API Accounts.

Vous recevrez :

• Client ID, Identifiant de votre application
• Client Secret, Secret de votre application (stockez-le en sécurité)
• Access Token, Utilisé pour l’authentification API
• Store Hash, Identifiant unique de votre boutique

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"

Scopes OAuth requis

Configuration

Configuration de base

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

Mappage des champs client

Mappez les champs client BigCommerce vers les attributs 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

Configuration des webhooks

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"

Endpoints API

Exemples de code

Initialiser le connecteur 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
});

Récupérer et synchroniser les clients

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

Gérer les événements webhook

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

Synchroniser le catalogue produits

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

Limites de débit

Limites supplémentaires :

Dépannage

Bonnes pratiques

1. Utilisez la V3 API dès que possible, La V3 API offre une meilleure pagination, un meilleur filtrage et des réponses JSON
2. Surveillez les en-têtes de limite de débit, Suivez X-Rate-Limit-Requests-Left pour éviter d’atteindre les limites
3. Enregistrez les webhooks pour la synchronisation en temps réel, Utilisez les webhooks plutôt que le polling pour les mises à jour de clients et de commandes
4. Regroupez les mises à jour client, Utilisez les endpoints client en masse V3 pour les synchronisations volumineuses
5. Incluez les variantes dans la synchronisation produits, Synchronisez les variantes produit pour un suivi de stock précis
6. Configurez des webhooks de panier abandonné, Essentiel pour l’automatisation des e-mails de récupération
7. Utilisez la pagination, Paginez toujours les endpoints de liste ; max 250 enregistrements par page

Sécurité

• Authentification par jeton OAuth, Accès API sécurisé par jeton
• Permissions délimitées, Comptes API restreints à des scopes de données spécifiques
• HTTPS uniquement, Toutes les communications API chiffrées via TLS
• Vérification des webhooks, Vérifiez la source des webhooks via le store hash
• Conformité PCI DSS, BigCommerce gère les données de paiement en toute sécurité
• SOC 2 Type II, La plateforme BigCommerce est certifiée SOC 2

Ressources associées

• Connecteur Shopify
• Connecteur WooCommerce
• Skill Customer Sync
• Skill Abandoned Cart