---
title: "Trình Kết Nối BigCommerce"
description: "Hướng dẫn tích hợp BigCommerce đầy đủ để đồng bộ customers, orders, products và cart events với Brevo qua Tajo."
url: https://tajo.io/vi/docs/connectors/ecommerce/bigcommerce/
markdown: https://tajo.io/vi/docs/connectors/ecommerce/bigcommerce.md
lang: vi-VN
robots: noindex
---

Đăng ký quyền truy cập sớm

Nhập tên và địa chỉ email công việc của bạn. Chúng tôi sẽ gửi liên kết để xác nhận yêu cầu truy cập Tajo.

# Trình Kết Nối BigCommerce

Trạng thái trình kết nối: Đang phát triển Đang xây dựng. Chưa được xác minh.

| Trường nguồn | Trường đích | Giá trị mẫu |
| --- | --- | --- |
| `record.id` | `source_id` | `record_1042` |
| `record.updated_at` | `updated_at` | `2026-10-18T08:00:00Z` |
| `record.value` | `value` | `sample_value` |

Kết nối cửa hàng BigCommerce của bạn với Brevo qua Tajo để đồng bộ dữ liệu khách hàng, theo dõi orders, kích hoạt email abandoned cart và tạo campaigns marketing cá nhân hóa.

## Tổng Quan

| Thuộc Tính | Giá Trị |
| --- | --- |
| **Nền Tảng** | BigCommerce |
| **Danh Mục** | Thương Mại Điện Tử |
| **Độ Phức Tạp Thiết Lập** | Trung Bình |
| **Tích Hợp Chính Thức** | Không |
| **Dữ Liệu Đồng Bộ** | Customers, Orders, Products, Carts |
| **URL API** | `https://api.bigcommerce.com/stores/{store_hash}/v3` |

## Tính Năng

- **Đồng bộ customers** - Nhập BigCommerce customers sang liên hệ Brevo với lịch sử mua hàng
- **Theo dõi orders** - Đồng bộ trạng thái orders sang sự kiện Brevo
- **Emails abandoned cart** - Kích hoạt campaigns khi giỏ hàng bị bỏ
- **Đồng bộ products** - Đồng bộ catalog sản phẩm cho email cá nhân hóa
- **Phân đoạn** - Tạo phân đoạn Brevo dựa trên hành vi mua hàng BigCommerce
- **Webhooks** - Nhận cập nhật theo thời gian thực cho sự kiện order và customer

## Yêu Cầu

Trước khi bắt đầu, hãy đảm bảo bạn có:

1. Tài khoản BigCommerce (Standard, Plus, Pro, hoặc Enterprise)
2. API credentials từ BigCommerce Advanced Settings
3. Tài khoản Brevo với quyền truy cập API
4. Tài khoản Tajo

## Xác Thực

### Xác Thực V2/V3 API

```bash
curl "https://api.bigcommerce.com/stores/{store_hash}/v3/customers" \
  -H "X-Auth-Token: YOUR_API_TOKEN" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json"
```

Tạo API credentials trong BigCommerce Advanced Settings > API Accounts.

#### Quyền Cần Thiết

```
Customers: Read-Only
Orders: Read-Only
Products: Read-Only
Carts: Read-Only
```

## Cấu Hình

### Thiết Lập Cơ Bản

```yaml
connectors:
  bigcommerce:
    enabled: true
    store_hash: "${BC_STORE_HASH}"
    client_id: "${BC_CLIENT_ID}"
    access_token: "${BC_ACCESS_TOKEN}"

    sync:
      customers: true
      orders: true
      products: true
      carts: true

    brevo_list_ids:
      all_customers: 20
      new_customers: 21
      repeat_customers: 22
```

### Ánh Xạ Trường

#### Ánh Xạ Mặc Định

| Parameter | Type | Description |
| --- | --- | --- |
| `email` required | string | Địa chỉ email khách hàng (định danh duy nhất) |
| `first_name` optional | string | Ánh xạ sang thuộc tính FIRSTNAME |
| `last_name` optional | string | Ánh xạ sang thuộc tính LASTNAME |
| `phone` optional | string | Ánh xạ sang thuộc tính SMS |
| `total_spent` optional | number | Tổng chi tiêu trong cửa hàng |
| `orders_count` optional | integer | Tổng số orders đã đặt |

## API Endpoints

| Phương Thức | Endpoint | Mô Tả |
| --- | --- | --- |
| `GET` | `/v3/customers` | Liệt kê customers |
| `GET` | `/v2/orders` | Liệt kê orders |
| `GET` | `/v3/catalog/products` | Liệt kê products |
| `GET` | `/v3/carts/{cartId}` | Lấy chi tiết cart |
| `POST` | `/v3/hooks` | Tạo webhook |

## Sự Kiện

| Sự Kiện | Kích Hoạt | Trường Hợp Sử Dụng |
| --- | --- | --- |
| `store/order/created` | Order mới được đặt | Xác nhận order |
| `store/order/statusUpdated` | Trạng thái order thay đổi | Cập nhật vận chuyển |
| `store/customer/created` | Khách hàng mới đăng ký | Email chào mừng |
| `store/cart/abandoned` | Giỏ hàng bị bỏ | Email recovery |
| `store/cart/updated` | Giỏ hàng được cập nhật | Theo dõi giỏ hàng |

## Ví Dụ Code

### Khởi Tạo Trình Kết Nối

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

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

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

### Đồng Bộ Customers Sang Brevo

```javascript
// Đồng bộ customers từ BigCommerce sang Brevo
await tajo.connectors.sync('bigcommerce', {
  type: 'incremental',
  resources: ['customers', 'orders'],
  since: '2024-01-01'
});
```

Header Giới Hạn Tốc Độ

BigCommerce trả về giới hạn tốc độ qua headers `X-Rate-Limit-Requests-Left` và `X-Rate-Limit-Time-Reset-Ms`. Tajo tự động xử lý throttling khi cần.

## Giới Hạn Tốc Độ

| Gói | Giới Hạn |
| --- | --- |
| Standard | 20.000 yêu cầu/giờ |
| Plus | 20.000 yêu cầu/giờ |
| Pro | 60.000 yêu cầu/giờ |
| Enterprise | Tùy chỉnh |

## Khắc Phục Sự Cố

| Sự Cố | Nguyên Nhân | Giải Pháp |
| --- | --- | --- |
| 401 Unauthorized | API token không hợp lệ | Xác minh access token trong BC settings |
| 403 Forbidden | Quyền không đủ | Kiểm tra quyền trên API account |
| Webhook không nhận | SSL certificate | Đảm bảo webhook URL sử dụng HTTPS |

## Tài Nguyên Liên Quan

- [Tài Liệu API BigCommerce](https://developer.bigcommerce.com/docs/build/rest-api)
- [Trình Kết Nối Shopify](https://tajo.io/vi/docs/connectors/ecommerce/shopify)
- [Customer Sync Skill](https://tajo.io/vi/docs/skills/data-sync/customer-sync)