Shopify Connector

Shopify Connector

Kết nối cửa hàng Shopify của bạn với Brevo để đồng bộ hóa đầy đủ dữ liệu khách hàng, khôi phục giỏ hàng bị bỏ rơi và tự động hóa chiến dịch marketing.

Tổng quan

Tính năng

• Đồng bộ khách hàng thời gian thực - Dữ liệu khách hàng được đồng bộ ngay lập tức tới liên hệ Brevo
• Theo dõi đơn hàng - Sự kiện đơn hàng cho flow sau mua
• Đồng bộ danh mục sản phẩm - Sản phẩm có sẵn cho gợi ý
• Khôi phục giỏ hàng bị bỏ rơi - Theo dõi và khôi phục giỏ hàng bị bỏ rơi
• Hành vi duyệt web - Theo dõi lượt xem trang và sự quan tâm sản phẩm
• Hỗ trợ đa cửa hàng - Kết nối nhiều cửa hàng Shopify

Điều kiện tiên quyết

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

1. Một cửa hàng Shopify với quyền admin
2. Một tài khoản Brevo có API access
3. Một tài khoản Tajo

Cài đặt

Phương án 1: Shopify App Store (Khuyến nghị)

1. Truy cập ứng dụng Tajo trên Shopify App Store
2. Nhấp “Add app”
3. Cấp các quyền được yêu cầu
4. Kết nối tài khoản Brevo của bạn

Phương án 2: Cài đặt thủ công

Bước 1: Tạo một Shopify App

1. Vào Shopify admin → Settings → Apps and sales channels
2. Nhấp “Develop apps” → “Create an app”
3. Đặt tên “Tajo Integration”

Bước 2: Cấu hình API Scopes

Bật các scope sau:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

Bước 3: Cài đặt App

# Using Tajo CLI
tajo connectors install shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY \
  --api-secret $SHOPIFY_API_SECRET

Bước 4: Cấu hình Webhook

Tajo tự động đăng ký các webhook sau:

Cấu hình

Thiết lập cơ bản

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_version: "2024-01"

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      carts: true
      inventory: false  # Optional

    # List assignment
    lists:
      all_customers: 5
      buyers: 6
      abandoned_cart: 7

Ánh xạ trường

Ánh xạ các trường Shopify tới thuộc tính liên hệ Brevo:

Ánh xạ thuộc tính tùy chỉnh

field_mapping:
  # Standard fields
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  phone: SMS

  # E-commerce metrics
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  last_order_date: LAST_ORDER_DATE

  # Custom fields
  customer_type: CUSTOMER_TYPE
  preferred_language: LANGUAGE
  loyalty_tier: VIP_TIER

  # Computed fields
  average_order_value: AOV
  days_since_last_order: RECENCY

Đồng bộ sản phẩm

Đồng bộ sản phẩm cho gợi ý email:

sync:
  products:
    enabled: true
    include_variants: true
    include_images: true
    categories_as_tags: true

    # Filter products
    filter:
      status: active
      exclude_tags: ["hidden", "wholesale-only"]

Theo dõi tồn kho

Bật đồng bộ mức tồn kho:

sync:
  inventory:
    enabled: true
    low_stock_threshold: 10
    out_of_stock_events: true

Sự kiện

Sự kiện khách hàng

Sự kiện đơn hàng

Sự kiện giỏ hàng

Skill được kích hoạt

Shopify Connector kích hoạt các skill sau:

Ví dụ code

Khởi tạo Connector

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

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

// Connect Shopify store
await tajo.connectors.connect('shopify', {
  shopUrl: 'your-store.myshopify.com',
  apiKey: process.env.SHOPIFY_API_KEY,
  apiSecret: process.env.SHOPIFY_API_SECRET
});

Chạy đồng bộ ban đầu

// Full historical sync
await tajo.connectors.sync('shopify', {
  type: 'full',
  resources: ['customers', 'orders', 'products'],
  since: '2023-01-01'
});

// Check sync status
const status = await tajo.connectors.status('shopify');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 15420,
//   ordersCount: 8234,
//   productsCount: 342
// }

Theo dõi sự kiện giỏ hàng

Thêm script Tajo vào theme Shopify của bạn:

<!-- Add to theme.liquid before </head> -->
{% if customer %}
<script>
  window.tajoConfig = {
    customerId: "{{ customer.id }}",
    customerEmail: "{{ customer.email }}",
    customerName: "{{ customer.first_name }}"
  };
</script>
{% endif %}
<script src="https://cdn.tajo.io/shopify.js"></script>

Webhook Handler tùy chỉnh

// Handle Shopify webhooks manually
app.post('/webhooks/shopify', async (req, res) => {
  const hmac = req.get('X-Shopify-Hmac-SHA256');

  // Verify webhook signature
  if (!verifyShopifyWebhook(req.body, hmac)) {
    return res.status(401).send('Unauthorized');
  }

  const topic = req.get('X-Shopify-Topic');

  // Forward to Tajo
  await tajo.connectors.handleWebhook('shopify', {
    topic,
    payload: req.body
  });

  res.status(200).send('OK');
});

Giám sát

Metrics Dashboard

Giám sát kết nối Shopify của bạn trong Tajo dashboard:

• Trạng thái đồng bộ: Tình trạng kết nối thời gian thực
• Khách hàng đã đồng bộ: Tổng liên hệ từ Shopify
• Đơn hàng được theo dõi: Sự kiện đơn hàng đã xử lý
• Khôi phục giỏ hàng: Hiệu quả giỏ hàng bị bỏ rơi
• Tỷ lệ lỗi: Các lần đồng bộ thất bại

Webhook Logs

Xem trạng thái phân phối webhook:

tajo connectors logs shopify --type webhook --last 24h

Lịch sử đồng bộ

Kiểm tra các lần đồng bộ trước đây:

tajo connectors history shopify --limit 10

Xử lý sự cố

Vấn đề thường gặp

Chế độ Debug

Bật ghi log chi tiết:

connectors:
  shopify:
    debug: true
    log_level: verbose
    log_webhooks: true

Kiểm tra kết nối

tajo connectors test shopify
# ✓ API connection successful
# ✓ Webhooks registered
# ✓ Products accessible
# ✓ Customers readable
# ✓ Orders readable

Phương pháp tốt nhất

1. Bắt đầu với cửa hàng thử nghiệm - Sử dụng development store trước
2. Chạy đồng bộ ban đầu ngoài giờ cao điểm - Đồng bộ lớn có thể chậm
3. Ánh xạ thuộc tính tùy chỉnh - Đừng chỉ dựa vào ánh xạ mặc định
4. Bật theo dõi giỏ hàng - Quan trọng cho khôi phục giỏ hàng bị bỏ rơi
5. Giám sát tình trạng webhook - Thiết lập cảnh báo cho phân phối thất bại
6. Sử dụng import theo lô - Cho dữ liệu lịch sử trên 10.000 bản ghi

Bảo mật

• OAuth 2.0 - Xác thực dựa trên token an toàn
• Xác minh webhook - Kiểm tra chữ ký HMAC
• Lưu trữ mã hóa - Thông tin API được mã hóa khi lưu
• Truy cập có scope - Chỉ các quyền tối thiểu cần thiết

Tài nguyên liên quan

• WooCommerce Connector
• Customer Sync Skill
• Abandoned Cart Skill
• Brevo Contacts API