موصل BigCommerce

موصل BigCommerce

اربط متجر BigCommerce الخاص بك مع Brevo من خلال Tajo لمزامنة كاملة لبيانات التجارة الإلكترونية. زامن العملاء والطلبات والمنتجات وأحداث السلة لتشغيل حملات تسويقية مستهدفة، واسترداد السلات المهجورة، وأتمتة ما بعد الشراء.

نظرة عامة

الميزات

• مزامنة العملاء - مزامنة بيانات العملاء في الوقت الفعلي مع جهات اتصال Brevo
• تتبع الطلبات - أحداث دورة حياة الطلبات لتدفقات التسويق ما بعد الشراء
• مزامنة كتالوج المنتجات - مزامنة المنتجات لتوصيات البريد الإلكتروني والمحتوى الديناميكي
• استرداد السلات المهجورة - تتبع واسترداد السلات المهجورة برسائل بريد إلكتروني آلية
• دعم المتاجر المتعددة - ربط واجهات متاجر BigCommerce متعددة
• تحديثات مدفوعة بـ webhook - تحديثات بيانات في الوقت الفعلي عبر webhooks BigCommerce
• الحقول المخصصة - ربط حقول BigCommerce المخصصة بسمات جهات اتصال Brevo
• تتبع المخزون - مزامنة مستويات المخزون لإشعارات العودة إلى المخزون

المتطلبات الأساسية

قبل البدء، تأكد من توفر ما يلي:

1. متجر BigCommerce مع صلاحيات مالك المتجر أو المسؤول
2. حساب API لـ BigCommerce مع نطاقات OAuth مناسبة
3. Store Hash الخاص بك (موجود في عنوان URL للمتجر أو بيانات اعتماد API)
4. حساب Brevo مع وصول إلى API
5. حساب Tajo مع بيانات اعتماد API

المصادقة

بيانات اعتماد حساب API

يستخدم BigCommerce حسابات API قائمة على OAuth. أنشئ واحدًا في لوحة تحكم BigCommerce ضمن Settings > API > API Accounts.

ستتلقى:

• Client ID - معرّف التطبيق الخاص بك
• Client Secret - سر التطبيق الخاص بك (خزّنه بأمان)
• Access Token - يُستخدم لمصادقة API
• Store Hash - معرّف متجرك الفريد

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"

نطاقات OAuth المطلوبة

الإعداد

الإعداد الأساسي

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

تعيين حقول العميل

ربط حقول عملاء BigCommerce بسمات 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

إعداد 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"

نقاط نهاية واجهة البرمجة

أمثلة على الكود

تهيئة موصل 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
});

جلب ومزامنة العملاء

// جلب العملاء من 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 }

التعامل مع أحداث Webhook

// BigCommerce webhook handler
app.post('/webhooks/bigcommerce', async (req, res) => {
  const { scope, store_id, data } = req.body;

  // التحقق من أن webhook من متجرك
  if (store_id !== process.env.BC_STORE_HASH) {
    return res.status(401).send('Unauthorized');
  }

  // إعادة التوجيه إلى Tajo
  await tajo.connectors.handleWebhook('bigcommerce', {
    topic: scope,
    payload: data
  });

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

مزامنة كتالوج المنتجات

// مزامنة كاملة لكتالوج المنتجات
await tajo.connectors.sync('bigcommerce', {
  type: 'full',
  resources: ['products'],
  includeVariants: true,
  includeImages: true
});

// التحقق من حالة المزامنة
const status = await tajo.connectors.status('bigcommerce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   customersCount: 8200,
//   ordersCount: 4500,
//   productsCount: 620
// }

حدود المعدل

حدود إضافية:

استكشاف الأخطاء وإصلاحها

أفضل الممارسات

1. استخدم V3 API حيثما أمكن - يوفر V3 API تقسيمًا وتصفية واستجابات JSON أفضل
2. راقب ترويسات حد المعدل - تتبع X-Rate-Limit-Requests-Left لتجنب بلوغ الحدود
3. سجّل webhooks للمزامنة الآنية - استخدم webhooks بدلاً من الاستطلاع لتحديثات العملاء والطلبات
4. تحديثات العملاء بالدفعات - استخدم نقاط نهاية العملاء بالجملة V3 لمزامنات البيانات الكبيرة
5. ضمّن المتغيرات في مزامنة المنتجات - زامن متغيرات المنتج لتتبع دقيق للمخزون
6. إعداد webhooks للسلات المهجورة - مهم لأتمتة البريد الإلكتروني لاسترداد السلة
7. استخدم التقسيم - قسّم دائمًا نقاط نهاية القائمة؛ 250 سجل كحد أقصى لكل صفحة

الأمان

• مصادقة رمز OAuth - وصول API آمن قائم على الرموز
• صلاحيات مقيدة - حسابات API مقيدة بنطاقات بيانات محددة
• HTTPS فقط - جميع اتصالات API مشفرة عبر TLS
• التحقق من Webhook - تحقق من مصدر webhook باستخدام store hash
• متوافق مع PCI DSS - يعالج BigCommerce بيانات الدفع بأمان
• SOC 2 Type II - منصة BigCommerce معتمدة من SOC 2

موارد ذات صلة

• موصل Shopify
• موصل WooCommerce
• مهارة مزامنة العملاء
• مهارة السلة المهجورة