الموصلات

الموصلات هي عمليات تكامل مُسبقة البناء تزامن البيانات بين منصاتك و 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. الأحداث في الوقت الفعلي: يلتقط webhooks التغييرات فورًا
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

الخطوات التالية

• موصل Shopify - ابدأ مع Shopify