BigCommerce कनेक्टर

BigCommerce कनेक्टर

संपूर्ण ई-कॉमर्स डेटा सिंक्रोनाइज़ेशन के लिए अपने BigCommerce स्टोर को Tajo के माध्यम से Brevo से कनेक्ट करें। लक्षित मार्केटिंग अभियानों, त्याग किए गए कार्ट रिकवरी, और पोस्ट-परचेज़ ऑटोमेशन को शक्ति देने के लिए ग्राहकों, ऑर्डर, उत्पादों, और कार्ट इवेंट्स को सिंक करें।

अवलोकन

विशेषताएं

• ग्राहक सिंक - Brevo कॉन्टैक्ट्स में रीयल-टाइम ग्राहक डेटा सिंक्रोनाइज़ेशन
• ऑर्डर ट्रैकिंग - पोस्ट-परचेज़ मार्केटिंग फ्लो के लिए ऑर्डर जीवनचक्र इवेंट्स
• उत्पाद कैटलॉग सिंक - ईमेल सिफारिशों और डायनामिक सामग्री के लिए उत्पाद सिंक करें
• कार्ट छोड़ना - स्वचालित ईमेल के साथ त्याग किए गए कार्ट्स को ट्रैक करें और रिकवर करें
• मल्टी-स्टोरफ्रंट समर्थन - कई BigCommerce स्टोरफ्रंट्स को कनेक्ट करें
• वेबहुक-आधारित अपडेट - BigCommerce वेबहुक्स के माध्यम से रीयल-टाइम डेटा अपडेट
• कस्टम फ़ील्ड्स - BigCommerce कस्टम फ़ील्ड्स को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें
• इन्वेंट्री ट्रैकिंग - बैक-इन-स्टॉक सूचनाओं के लिए स्टॉक स्तर सिंक करें

पूर्वावश्यकताएं

शुरू करने से पहले, सुनिश्चित करें कि आपके पास है:

1. स्टोर मालिक या एडमिन एक्सेस वाला एक BigCommerce स्टोर
2. उचित OAuth स्कोप्स के साथ एक BigCommerce API खाता
3. आपका Store Hash (आपके स्टोर 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

वेबहुक कॉन्फ़िगरेशन

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 }

वेबहुक इवेंट्स संभालें

// 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 बेहतर पेजीनेशन, फ़िल्टरिंग, और JSON प्रतिक्रियाएं प्रदान करता है
2. दर सीमा हेडर्स की निगरानी करें - सीमाओं से बचने के लिए X-Rate-Limit-Requests-Left ट्रैक करें
3. रीयल-टाइम सिंक के लिए वेबहुक्स पंजीकृत करें - ग्राहक और ऑर्डर अपडेट के लिए पोलिंग के बजाय वेबहुक्स का उपयोग करें
4. बैच ग्राहक अपडेट करें - बड़े डेटा सिंक के लिए V3 बल्क ग्राहक एंडपॉइंट्स का उपयोग करें
5. उत्पाद सिंक में वेरिएंट शामिल करें - सटीक इन्वेंट्री ट्रैकिंग के लिए उत्पाद वेरिएंट सिंक करें
6. त्याग किए गए कार्ट वेबहुक्स सेट अप करें - कार्ट रिकवरी ईमेल ऑटोमेशन के लिए महत्वपूर्ण
7. पेजीनेशन का उपयोग करें - हमेशा सूची एंडपॉइंट्स को पेजिनेट करें; प्रति पेज अधिकतम 250 रिकॉर्ड्स

सुरक्षा

• OAuth टोकन प्रमाणीकरण - सुरक्षित टोकन-आधारित API एक्सेस
• स्कोप्ड अनुमतियां - API खाते विशिष्ट डेटा स्कोप्स तक सीमित
• केवल HTTPS - TLS के माध्यम से सभी API संचार एन्क्रिप्टेड
• वेबहुक सत्यापन - स्टोर हैश का उपयोग करके वेबहुक स्रोत सत्यापित करें
• PCI DSS अनुरूप - BigCommerce भुगतान डेटा को सुरक्षित रूप से संभालता है
• SOC 2 Type II - BigCommerce प्लेटफ़ॉर्म SOC 2 प्रमाणित है

संबंधित संसाधन

• Shopify Connector
• WooCommerce Connector
• Customer Sync Skill
• Abandoned Cart Skill