Trình Kết Nối BigCommerce
Trình Kết Nối BigCommerce
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 | Có |
| 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ó:
- Tài khoản BigCommerce (Standard, Plus, Pro, hoặc Enterprise)
- API credentials từ BigCommerce Advanced Settings
- Tài khoản Brevo với quyền truy cập API
- Tài khoản Tajo
Xác Thực
Xác Thực V2/V3 API
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-OnlyOrders: Read-OnlyProducts: Read-OnlyCarts: Read-OnlyCấu Hình
Thiết Lập Cơ Bản
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
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
// Đồng bộ customers từ BigCommerce sang Brevoawait 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 |