WooCommerce कनेक्टर

WooCommerce कनेक्टर

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

अवलोकन

विशेषताएं

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

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

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

1. WooCommerce प्लगइन इंस्टॉल और सक्रिय के साथ एक WordPress साइट
2. WooCommerce REST API सक्षम (Settings > Advanced > REST API)
3. API Consumer Key और Consumer Secret जनरेट किए गए
4. आपकी साइट को API प्रमाणीकरण के लिए HTTPS का उपयोग करना चाहिए
5. API एक्सेस वाला एक Brevo खाता
6. API क्रेडेंशियल्स के साथ एक Tajo खाता

प्रमाणीकरण

REST API कीज़

WooCommerce प्रमाणीकरण के लिए Consumer Key और Consumer Secret जोड़े का उपयोग करता है। इन्हें WooCommerce > Settings > Advanced > REST API में जनरेट करें।

OAuth 1.0a (HTTPS साइट्स)

curl https://yourstore.com/wp-json/wc/v3/orders \
  -u "consumer_key:consumer_secret"

क्वेरी स्ट्रिंग प्रमाणीकरण (HTTPS)

curl "https://yourstore.com/wp-json/wc/v3/orders?consumer_key=ck_xxx&consumer_secret=cs_xxx"

अनुमति स्तर

कॉन्फ़िगरेशन

बुनियादी सेटअप

connectors:
  woocommerce:
    enabled: true
    store_url: "https://yourstore.com"
    consumer_key: "ck_your_consumer_key"
    consumer_secret: "cs_your_consumer_secret"
    api_version: "wc/v3"
    verify_ssl: true

    # Data sync options
    sync:
      customers: true
      orders: true
      products: true
      coupons: true

    # Brevo list assignment
    lists:
      all_customers: 50
      buyers: 51
      abandoned_cart: 52

ग्राहक फ़ील्ड मैपिंग

WooCommerce ग्राहक फ़ील्ड्स को Brevo एट्रिब्यूट्स में मैप करें:

customer_mapping:
  email: email
  first_name: FIRSTNAME
  last_name: LASTNAME
  billing.phone: SMS
  billing.company: COMPANY
  billing.city: CITY
  billing.state: STATE
  billing.country: COUNTRY
  billing.postcode: ZIP

  # E-commerce metrics (computed)
  orders_count: ORDER_COUNT
  total_spent: TOTAL_SPENT
  date_created: SIGNUP_DATE

  # Meta fields
  meta_data.loyalty_points: LOYALTY_POINTS
  meta_data.preferred_category: PREF_CATEGORY

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

WooCommerce > Settings > Advanced > Webhooks में वेबहुक्स पंजीकृत करें:

webhooks:
  - topic: "customer.created"
    event: "customer_created"
  - topic: "customer.updated"
    event: "customer_updated"
  - topic: "order.created"
    event: "order_placed"
  - topic: "order.updated"
    event: "order_updated"
  - topic: "order.completed"
    event: "order_fulfilled"
  - topic: "order.refunded"
    event: "order_refunded"
  - topic: "coupon.created"
    event: "coupon_created"
  - topic: "product.created"
    event: "product_added"
  - topic: "product.updated"
    event: "product_updated"

API एंडपॉइंट्स

कोड उदाहरण

WooCommerce कनेक्टर प्रारंभ करें

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

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

// Connect WooCommerce store
await tajo.connectors.connect('woocommerce', {
  storeUrl: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET
});

ग्राहक प्राप्त करें और सिंक करें

// Fetch customers using WooCommerce REST API
const WooCommerce = require('@woocommerce/woocommerce-rest-api').default;

const api = new WooCommerce({
  url: 'https://yourstore.com',
  consumerKey: process.env.WC_CONSUMER_KEY,
  consumerSecret: process.env.WC_CONSUMER_SECRET,
  version: 'wc/v3'
});

// List customers with pagination
const response = await api.get('customers', {
  per_page: 100,
  page: 1,
  orderby: 'registered_date',
  order: 'desc'
});

const customers = response.data;
// [{ id, email, first_name, last_name, billing, shipping, ... }]

// Pagination info from headers
const totalPages = response.headers['x-wp-totalpages'];
const totalItems = response.headers['x-wp-total'];

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

// WooCommerce webhook handler
app.post('/webhooks/woocommerce', async (req, res) => {
  const topic = req.headers['x-wc-webhook-topic'];
  const signature = req.headers['x-wc-webhook-signature'];

  // Verify webhook signature
  const expectedSignature = crypto
    .createHmac('sha256', WEBHOOK_SECRET)
    .update(JSON.stringify(req.body))
    .digest('base64');

  if (signature !== expectedSignature) {
    return res.status(401).send('Invalid signature');
  }

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

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

बैच संचालन

// Batch create, update, and delete products
const batchResponse = await api.post('products/batch', {
  create: [
    { name: 'New Product', type: 'simple', regular_price: '19.99' }
  ],
  update: [
    { id: 123, regular_price: '24.99' }
  ],
  delete: [456]
});

दर सीमाएं

WooCommerce स्वयं API दर सीमाएं लागू नहीं करता है, लेकिन अंतर्निहित WordPress सर्वर और होस्टिंग प्रदाता सीमाएं लगा सकते हैं:

समस्या निवारण

सर्वोत्तम प्रथाएं

1. रीयल-टाइम सिंक के लिए वेबहुक्स का उपयोग करें - API पोल करने के बजाय WooCommerce वेबहुक्स कॉन्फ़िगर करें
2. वेबहुक सिग्नेचर सत्यापित करें - हमेशा X-WC-Webhook-Signature हेडर मान्य करें
3. सभी सूची अनुरोधों को पेजिनेट करें - page और per_page पैरामीटर का उपयोग करें; X-WP-TotalPages हेडर जांचें
4. _fields पैरामीटर का उपयोग करें - प्रतिक्रिया आकार कम करने और प्रदर्शन में सुधार के लिए केवल आवश्यक फ़ील्ड्स का अनुरोध करें
5. बैच संचालन - बल्क बनाएं/अपडेट/हटाएं संचालन के लिए बैच एंडपॉइंट्स का उपयोग करें (100 आइटम तक)
6. बड़े सिंक शेड्यूल करें - सर्वर तनाव से बचने के लिए ऑफ-पीक घंटों में प्रारंभिक पूर्ण सिंक चलाएं
7. HTTPS सक्षम करें - OAuth प्रमाणीकरण के लिए WooCommerce API को HTTPS की आवश्यकता होती है

सुरक्षा

• OAuth 1.0a - Consumer Key/Secret जोड़ों के माध्यम से सुरक्षित प्रमाणीकरण
• HMAC वेबहुक सिग्नेचर - आने वाले वेबहुक्स के लिए SHA-256 सिग्नेचर सत्यापन
• HTTPS आवश्यक - API को प्रमाणीकरण के लिए TLS एन्क्रिप्शन की आवश्यकता है
• अनुमति स्कोपिंग - API कीज़ को Read, Write, या Read/Write पर सेट किया जा सकता है
• WordPress सुरक्षा - WordPress कोर सुरक्षा अपडेट से लाभान्वित
• PCI विचार - भुगतान डेटा WooCommerce भुगतान गेटवे द्वारा संभाला जाता है, API के माध्यम से उजागर नहीं

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

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