Shopify कनेक्टर

संपूर्ण ग्राहक डेटा सिंक्रोनाइज़ेशन, त्याग किए गए कार्ट रिकवरी, और स्वचालित मार्केटिंग अभियानों के लिए अपने Shopify स्टोर को Brevo से कनेक्ट करें।

अवलोकन

विशेषताएं

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

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

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

1. एडमिन एक्सेस वाला एक Shopify स्टोर
2. API एक्सेस वाला एक Brevo खाता
3. एक Tajo खाता

इंस्टॉलेशन

विकल्प 1: Shopify App Store (अनुशंसित)

1. Shopify App Store में Tajo ऐप पर जाएं
2. “Add app” पर क्लिक करें
3. अनुरोधित अनुमतियां प्रदान करें
4. अपना Brevo खाता कनेक्ट करें

विकल्प 2: मैनुअल इंस्टॉलेशन

चरण 1: एक Shopify ऐप बनाएं

1. अपने Shopify एडमिन पर जाएं → Settings → Apps and sales channels
2. “Develop apps” → “Create an app” पर क्लिक करें
3. इसका नाम “Tajo Integration” रखें

चरण 2: API स्कोप्स कॉन्फ़िगर करें

इन स्कोप्स को सक्षम करें:

read_customers
write_customers
read_orders
read_products
read_checkouts
write_script_tags

चरण 3: ऐप इंस्टॉल करें

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

चरण 4: वेबहुक्स कॉन्फ़िगर करें

Tajo स्वचालित रूप से इन वेबहुक्स को पंजीकृत करता है:

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

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

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

फ़ील्ड मैपिंग

Shopify फ़ील्ड्स को Brevo कॉन्टैक्ट एट्रिब्यूट्स में मैप करें:

कस्टम एट्रिब्यूट मैपिंग

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

उत्पाद सिंक

ईमेल सिफारिशों के लिए उत्पादों को सिंक करें:

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

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

इन्वेंट्री ट्रैकिंग

स्टॉक स्तर सिंक्रोनाइज़ेशन सक्षम करें:

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

इवेंट्स

ग्राहक इवेंट्स

ऑर्डर इवेंट्स

कार्ट इवेंट्स

सक्षम किए गए स्किल्स

Shopify कनेक्टर इन स्किल्स को सक्षम करता है:

कोड उदाहरण

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

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

प्रारंभिक सिंक चलाएं

// 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
// }

कार्ट इवेंट्स ट्रैक करें

अपने Shopify थीम में Tajo स्क्रिप्ट जोड़ें:

<!-- 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.example.com/shopify.js"></script>

कस्टम वेबहुक हैंडलर

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

मॉनिटरिंग

डैशबोर्ड मेट्रिक्स

Tajo डैशबोर्ड में अपने Shopify कनेक्शन की निगरानी करें:

• सिंक स्थिति: रीयल-टाइम कनेक्शन स्वास्थ्य
• सिंक किए गए ग्राहक: Shopify से कुल कॉन्टैक्ट्स
• ट्रैक किए गए ऑर्डर: संसाधित ऑर्डर इवेंट्स
• कार्ट रिकवरी: त्याग किए गए कार्ट प्रदर्शन
• त्रुटि दर: विफल सिंक प्रयास

वेबहुक लॉग्स

वेबहुक डिलीवरी स्थिति देखें:

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

सिंक इतिहास

ऐतिहासिक सिंक संचालन देखें:

tajo connectors history shopify --limit 10

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

सामान्य समस्याएं

डीबग मोड

विस्तृत लॉगिंग सक्षम करें:

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

कनेक्शन परीक्षण करें

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

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

1. परीक्षण स्टोर से शुरू करें - पहले विकास स्टोर का उपयोग करें
2. प्रारंभिक सिंक ऑफ-आवर्स में चलाएं - बड़े सिंक धीमे हो सकते हैं
3. कस्टम एट्रिब्यूट्स मैप करें - केवल डिफ़ॉल्ट मैपिंग पर निर्भर न रहें
4. कार्ट ट्रैकिंग सक्षम करें - त्याग किए गए कार्ट रिकवरी के लिए महत्वपूर्ण
5. वेबहुक स्वास्थ्य की निगरानी करें - विफल डिलीवरी के लिए अलर्ट सेट करें
6. बैच इंपोर्ट का उपयोग करें - 10,000 से अधिक रिकॉर्ड्स के ऐतिहासिक डेटा के लिए

सुरक्षा

• OAuth 2.0 - सुरक्षित टोकन-आधारित प्रमाणीकरण
• वेबहुक सत्यापन - HMAC सिग्नेचर सत्यापन
• एन्क्रिप्टेड स्टोरेज - API क्रेडेंशियल्स विश्राम पर एन्क्रिप्टेड
• स्कोप्ड एक्सेस - केवल न्यूनतम आवश्यक अनुमतियां

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

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