BigCommerce کنیکٹر

BigCommerce کنیکٹر

مکمل ای-کامرس ڈیٹا سنکرونائزیشن کے لیے Tajo کے ذریعے اپنے BigCommerce اسٹور کو Brevo سے منسلک کریں۔ ہدفی مارکیٹنگ مہمات، ترک شدہ کارٹ کی بحالی، اور خریداری کے بعد کی آٹومیشن کو طاقت دینے کے لیے گاہکوں، آرڈرز، پروڈکٹس، اور کارٹ ایونٹس کو سنک کریں۔

جائزہ

خصوصیات

• گاہک سنک - Brevo رابطوں میں ریئل ٹائم گاہک ڈیٹا سنکرونائزیشن
• آرڈر ٹریکنگ - خریداری کے بعد کے مارکیٹنگ فلوز کے لیے آرڈر لائف سائیکل ایونٹس
• پروڈکٹ کیٹلاگ سنک - ای میل سفارشات اور متحرک مواد کے لیے پروڈکٹس سنک کریں
• کارٹ ترک کرنا - خودکار ای میلز کے ساتھ ترک شدہ کارٹس کو ٹریک اور بحال کریں
• ملٹی اسٹور فرنٹ سپورٹ - متعدد BigCommerce اسٹور فرنٹس کو منسلک کریں
• Webhook سے چلنے والے اپ ڈیٹس - BigCommerce webhooks کے ذریعے ریئل ٹائم ڈیٹا اپ ڈیٹس
• کسٹم فیلڈز - BigCommerce کسٹم فیلڈز کو Brevo رابطہ خصوصیات پر میپ کریں
• انوینٹری ٹریکنگ - بیک ان اسٹاک نوٹیفکیشنز کے لیے اسٹاک لیولز سنک کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. اسٹور اونر یا ایڈمن رسائی کے ساتھ BigCommerce اسٹور
2. مناسب OAuth اسکوپس کے ساتھ BigCommerce API اکاؤنٹ
3. آپ کا اسٹور ہیش (آپ کے اسٹور URL یا API اسناد میں پایا جاتا ہے)
4. API رسائی کے ساتھ Brevo اکاؤنٹ
5. API اسناد کے ساتھ Tajo اکاؤنٹ

تصدیق

API اکاؤنٹ اسناد

BigCommerce OAuth پر مبنی API اکاؤنٹس استعمال کرتا ہے۔ اپنے 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"

API اینڈ پوائنٹس

کوڈ کی مثالیں

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
});

گاہکوں کو حاصل کریں اور سنک کریں

// Fetch customers from 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;

  // Verify the webhook is from your store
  if (store_id !== process.env.BC_STORE_HASH) {
    return res.status(401).send('Unauthorized');
  }

  // Forward to Tajo
  await tajo.connectors.handleWebhook('bigcommerce', {
    topic: scope,
    payload: data
  });

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

پروڈکٹ کیٹلاگ سنک کریں

// Full product catalog sync
await tajo.connectors.sync('bigcommerce', {
  type: 'full',
  resources: ['products'],
  includeVariants: true,
  includeImages: true
});

// Check sync status
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 بہتر pagination، فلٹرنگ، اور JSON جوابات پیش کرتا ہے
2. شرح کی حد کے ہیڈرز کی نگرانی کریں - حدود سے بچنے کے لیے X-Rate-Limit-Requests-Left کو ٹریک کریں
3. ریئل ٹائم سنک کے لیے webhooks رجسٹر کریں - گاہک اور آرڈر اپ ڈیٹس کے لیے polling کے بجائے webhooks استعمال کریں
4. گاہک اپ ڈیٹس بیچ کریں - بڑے ڈیٹا سنک کے لیے V3 بلک گاہک اینڈ پوائنٹس استعمال کریں
5. پروڈکٹ سنک میں ویریئنٹس شامل کریں - درست انوینٹری ٹریکنگ کے لیے پروڈکٹ ویریئنٹس سنک کریں
6. ترک شدہ کارٹ webhooks سیٹ اپ کریں - کارٹ ریکوری ای میل آٹومیشن کے لیے اہم
7. Pagination استعمال کریں - ہمیشہ فہرست اینڈ پوائنٹس کو pagination کریں؛ زیادہ سے زیادہ 250 ریکارڈز فی صفحہ

سیکیورٹی

• OAuth ٹوکن تصدیق - محفوظ ٹوکن پر مبنی API رسائی
• اسکوپڈ اجازتیں - API اکاؤنٹس مخصوص ڈیٹا اسکوپس تک محدود
• صرف HTTPS - تمام API مواصلات TLS کے ذریعے انکرپٹڈ
• Webhook تصدیق - اسٹور ہیش کا استعمال کرتے ہوئے webhook سورس کی تصدیق کریں
• PCI DSS کمپلائنٹ - BigCommerce ادائیگی کے ڈیٹا کو محفوظ طریقے سے سنبھالتا ہے
• SOC 2 Type II - BigCommerce پلیٹ فارم SOC 2 مصدقہ ہے

متعلقہ وسائل

• Shopify کنیکٹر
• WooCommerce کنیکٹر
• گاہک سنک اسکل
• ترک شدہ کارٹ اسکل