कनेक्टर्स

कनेक्टर्स

कनेक्टर्स पहले से तैयार इंटीग्रेशन हैं जो आपके प्लेटफ़ॉर्म और Brevo के बीच डेटा सिंक करते हैं। वे प्रमाणीकरण, डेटा मैपिंग, और रीयल-टाइम सिंक्रोनाइज़ेशन को संभालते हैं।

कनेक्टर्स क्या हैं?

एक कनेक्टर एक द्वि-दिशात्मक डेटा ब्रिज है जो:

• बाहरी प्लेटफ़ॉर्म के साथ सुरक्षित रूप से प्रमाणित करता है
• रीयल-टाइम या बैच मोड में डेटा सिंक करता है
• प्लेटफ़ॉर्म स्कीमा और Brevo के बीच फ़ील्ड मैप करता है
• सिंक्रोनाइज़्ड डेटा पर कार्य करने के लिए स्किल्स सक्षम करता है

उपलब्ध कनेक्टर्स

ई-कॉमर्स प्लेटफ़ॉर्म

CRM सिस्टम

भुगतान

कनेक्टर आर्किटेक्चर

graph LR
    A[Your Platform] <-->|OAuth/API Key| B[Tajo Connector]
    B <-->|Real-time Webhooks| C[Event Processing]
    C --> D[Field Mapping]
    D --> E[Brevo API]
    B <-->|Batch Sync| F[Scheduled Jobs]
    F --> D

डेटा प्रवाह

1. प्रमाणीकरण: OAuth 2.0 या API कीज़ के माध्यम से सुरक्षित कनेक्शन
2. रीयल-टाइम इवेंट्स: वेबहुक्स तुरंत परिवर्तनों को कैप्चर करते हैं
3. बैच सिंक: ऐतिहासिक डेटा के लिए शेड्यूल किए गए जॉब्स
4. फ़ील्ड मैपिंग: Brevo एट्रिब्यूट्स के लिए कॉन्फ़िगर करने योग्य मैपिंग
5. Brevo API: कॉन्टैक्ट्स, इवेंट्स, और लिस्ट्स में सिंक किया गया डेटा

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

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

connectors:
  shopify:
    enabled: true
    shop_url: "your-store.myshopify.com"
    api_key: "${SHOPIFY_API_KEY}"
    api_secret: "${SHOPIFY_API_SECRET}"

    # Data sync settings
    sync:
      customers: true
      orders: true
      products: true
      carts: true

    # Field mappings
    field_mapping:
      email: email
      first_name: FIRSTNAME
      last_name: LASTNAME
      total_spent: TOTAL_SPENT

सिंक मोड्स

त्वरित प्रारंभ

1. अपना कनेक्टर चुनें

ऊपर दिए गए कैटलॉग से अपने प्लेटफ़ॉर्म के लिए कनेक्टर चुनें।

2. प्रमाणीकरण करें

OAuth या API क्रेडेंशियल्स का उपयोग करके अपने प्लेटफ़ॉर्म को कनेक्ट करें:

tajo connectors connect shopify \
  --shop-url your-store.myshopify.com \
  --api-key $SHOPIFY_API_KEY

3. फ़ील्ड मैपिंग कॉन्फ़िगर करें

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

field_mapping:
  email: email
  firstName: FIRSTNAME
  lastName: LASTNAME
  totalOrders: ORDER_COUNT
  totalSpent: TOTAL_REVENUE
  lastOrderDate: LAST_ORDER_DATE

4. डेटा सिंक सक्षम करें

डेटा सिंक करना शुरू करें:

tajo connectors sync shopify --full

5. स्किल्स सक्रिय करें

सिंक किए गए डेटा का उपयोग करने वाले स्किल्स सक्षम करें:

tajo skills enable abandoned-cart
tajo skills enable customer-sync

कस्टम कनेक्टर्स

कैटलॉग में न होने वाले प्लेटफ़ॉर्म्स के लिए अपना खुद का कनेक्टर बनाएं:

Connector SDK

import { ConnectorSDK } from '@tajo/connector-sdk';

const connector = new ConnectorSDK({
  name: 'my-platform',
  version: '1.0.0',

  // Authentication
  auth: {
    type: 'oauth2',
    authorizationUrl: 'https://api.myplatform.com/oauth/authorize',
    tokenUrl: 'https://api.myplatform.com/oauth/token'
  },

  // Data mappings
  resources: {
    customers: {
      endpoint: '/api/customers',
      mapping: {
        email: 'contact.email',
        name: 'contact.full_name'
      }
    }
  },

  // Webhooks
  webhooks: {
    customer_created: '/webhooks/customer',
    order_placed: '/webhooks/order'
  }
});

export default connector;

अगले कदम

• Shopify कनेक्टर - Shopify के साथ शुरुआत करें
• डेटा मैपिंग गाइड - फ़ील्ड मैपिंग सीखें
• Connector SDK - कस्टम कनेक्टर्स बनाएं
• प्रमाणीकरण पैटर्न्स - अपने कनेक्शन सुरक्षित करें