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ínhGiá Trị
Nền TảngBigCommerce
Danh MụcThương Mại Điện Tử
Độ Phức Tạp Thiết LậpTrung Bình
Tích Hợp Chính Thức
Dữ Liệu Đồng BộCustomers, Orders, Products, Carts
URL APIhttps://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

Terminal window
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

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ứcEndpointMô Tả
GET/v3/customersLiệt kê customers
GET/v2/ordersLiệt kê orders
GET/v3/catalog/productsLiệt kê products
GET/v3/carts/{cartId}Lấy chi tiết cart
POST/v3/hooksTạo webhook

Sự Kiện

Sự KiệnKích HoạtTrường Hợp Sử Dụng
store/order/createdOrder mới được đặtXác nhận order
store/order/statusUpdatedTrạng thái order thay đổiCập nhật vận chuyển
store/customer/createdKhách hàng mới đăng kýEmail chào mừng
store/cart/abandonedGiỏ hàng bị bỏEmail recovery
store/cart/updatedGiỏ hàng được cập nhậtTheo 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 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-LeftX-Rate-Limit-Time-Reset-Ms. Tajo tự động xử lý throttling khi cần.

Giới Hạn Tốc Độ

GóiGiới Hạn
Standard20.000 yêu cầu/giờ
Plus20.000 yêu cầu/giờ
Pro60.000 yêu cầu/giờ
EnterpriseTùy chỉnh

Khắc Phục Sự Cố

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

Tài Nguyên Liên Quan

Subscribe to updates

developer-docs

Drop your email or phone number — we'll send you what matters next.

Trợ lý AI

Xin chào! Hãy hỏi tôi về tài liệu.

Bắt đầu miễn phí với Brevo