کنیکٹرز

کنیکٹرز

کنیکٹرز پہلے سے بنے ہوئے انٹیگریشنز ہیں جو آپ کے پلیٹ فارمز اور 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 - کسٹم کنیکٹرز بنائیں
• تصدیق کے نمونے - اپنے کنکشنز کو محفوظ بنائیں