Konektor BigCommerce

Hubungkan toko BigCommerce Anda ke Brevo melalui Tajo untuk sinkronisasi data e-commerce yang lengkap. Sinkronkan pelanggan, pesanan, produk, dan event keranjang untuk menjalankan kampanye pemasaran tertarget, pemulihan keranjang yang ditinggalkan, dan otomatisasi pascapembelian.

Ikhtisar

Fitur

• Sinkronisasi pelanggan - Sinkronisasi data pelanggan secara real-time ke kontak Brevo
• Pelacakan pesanan - Event siklus hidup pesanan untuk alur pemasaran pascapembelian
• Sinkronisasi katalog produk - Sinkronkan produk untuk rekomendasi email dan konten dinamis
• Keranjang yang ditinggalkan - Lacak dan pulihkan keranjang yang ditinggalkan dengan email otomatis
• Dukungan multi-storefront - Hubungkan beberapa storefront BigCommerce sekaligus
• Pembaruan berbasis webhook - Pembaruan data real-time melalui webhook BigCommerce
• Custom field - Petakan custom field BigCommerce ke atribut kontak Brevo
• Pelacakan inventaris - Sinkronkan level stok untuk notifikasi stok kembali tersedia

Prasyarat

Sebelum memulai, pastikan Anda memiliki:

1. Toko BigCommerce dengan akses Store Owner atau Admin
2. API account BigCommerce dengan scope OAuth yang sesuai
3. Store Hash Anda (terdapat pada URL toko atau kredensial API)
4. Akun Brevo dengan akses API
5. Akun Tajo dengan kredensial API

Autentikasi

Kredensial API account

BigCommerce menggunakan API account berbasis OAuth. Buat satu di control panel BigCommerce Anda melalui Settings > API > API Accounts.

Anda akan menerima:

• Client ID - Identifier aplikasi Anda
• Client Secret - Secret aplikasi Anda (simpan dengan aman)
• Access Token - Dipakai untuk autentikasi API
• Store Hash - Identifier unik toko Anda

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"

Scope OAuth yang diperlukan

Konfigurasi

Penyiapan dasar

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

Pemetaan field pelanggan

Petakan field pelanggan BigCommerce ke atribut 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

Konfigurasi webhook

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"

Endpoint API

Contoh kode

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

Ambil dan sinkronkan pelanggan

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

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

Sinkronkan katalog produk

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

Batas rate

Batas tambahan:

Pemecahan masalah

Praktik terbaik

1. Gunakan API V3 bila memungkinkan - API V3 menawarkan paginasi, pemfilteran, dan respons JSON yang lebih baik
2. Pantau header batas rate - Lacak X-Rate-Limit-Requests-Left agar tidak menyentuh batas
3. Daftarkan webhook untuk sinkronisasi real-time - Gunakan webhook alih-alih polling untuk pembaruan pelanggan dan pesanan
4. Kelompokkan pembaruan pelanggan - Gunakan endpoint bulk customer V3 untuk sinkronisasi data berskala besar
5. Sertakan varian dalam sinkronisasi produk - Sinkronkan varian produk agar pelacakan inventaris akurat
6. Siapkan webhook keranjang yang ditinggalkan - Krusial untuk otomatisasi email pemulihan keranjang
7. Gunakan paginasi - Selalu paginasikan endpoint daftar, maksimum 250 record per halaman

Keamanan

• Autentikasi token OAuth - Akses API berbasis token yang aman
• Izin ber-scope - API account dibatasi pada scope data tertentu
• Hanya HTTPS - Seluruh komunikasi API dienkripsi melalui TLS
• Verifikasi webhook - Verifikasi sumber webhook menggunakan store hash
• Patuh PCI DSS - BigCommerce menangani data pembayaran secara aman
• SOC 2 Type II - Platform BigCommerce bersertifikat SOC 2

Sumber daya terkait

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