موصل Salesforce

موصل Salesforce

اربط Salesforce CRM الخاص بك بـ Brevo عبر Tajo لمزامنة جهات الاتصال على مستوى المؤسسات، وإدارة العملاء المحتملين، وتتبع الفرص، وأتمتة التسويق المدعومة ببيانات CRM الخاصة بك.

نظرة عامة

الميزات

• مزامنة ثنائية الاتجاه لجهات الاتصال/العملاء المحتملين - زامن جهات اتصال Salesforce والعملاء المحتملين مع قوائم جهات اتصال Brevo
• تتبع الفرص - اربط مراحل الصفقات والمبالغ للتقسيم القائم على الإيرادات
• التسلسل الهرمي للحساب - زامن حسابات الشركات للتسويق القائم على الحسابات في Brevo
• ربط الكائنات المخصصة - اربط كائنات Salesforce المخصصة بسمات Brevo وأحداثه
• مزامنة أعضاء الحملة - زامن أعضاء حملة Salesforce مع قوائم Brevo
• تتبع النشاط - زامن المهام والأحداث وأنشطة البريد الإلكتروني لتسجيل التفاعل
• البث في الوقت الفعلي - استخدم Salesforce Streaming API للتحديثات الفورية للبيانات
• دعم استعلامات SOQL - صفِّ البيانات المُزامنة باستعلامات SOQL مخصصة

المتطلبات المسبقة

قبل أن تبدأ، تأكد من توفر ما يلي:

1. مؤسسة Salesforce (أي إصدار مع وصول API)
2. تطبيق متصل مُعدّ في Salesforce Setup
3. تفعيل وصول API لملف تعريف مستخدم Salesforce الخاص بك
4. حساب Brevo مع وصول API
5. حساب Tajo

المصادقة

تدفق خادم الويب OAuth 2.0 (موصى به)

الأفضل لعمليات تكامل الإنتاج مع تفويض المستخدم.

# Step 1: Authorize
https://login.salesforce.com/services/oauth2/authorize?
  response_type=code&
  client_id={consumer_key}&
  redirect_uri={callback_url}

# Step 2: Exchange code for tokens
curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=authorization_code" \
  -d "code={auth_code}" \
  -d "client_id={consumer_key}" \
  -d "client_secret={consumer_secret}" \
  -d "redirect_uri={callback_url}"

تدفق اسم المستخدم وكلمة المرور

لعمليات التكامل من خادم إلى خادم دون تفاعل المستخدم.

curl -X POST https://login.salesforce.com/services/oauth2/token \
  -d "grant_type=password" \
  -d "client_id={consumer_key}" \
  -d "client_secret={consumer_secret}" \
  -d "username={username}" \
  -d "password={password}{security_token}"

الإعداد

الإعداد الأساسي

connectors:
  salesforce:
    enabled: true
    instance_url: "https://yourorg.my.salesforce.com"
    api_version: "v59.0"
    auth:
      type: oauth2
      consumer_key: "${SF_CONSUMER_KEY}"
      consumer_secret: "${SF_CONSUMER_SECRET}"
      refresh_token: "${SF_REFRESH_TOKEN}"

    # Data sync options
    sync:
      contacts: true
      leads: true
      accounts: true
      opportunities: true
      campaigns: true

    # Sync direction
    direction: salesforce_to_brevo

    # Brevo list assignment
    lists:
      all_leads: 15
      qualified_leads: 16
      customers: 17

ربط الحقول

اربط حقول Salesforce بسمات جهات اتصال Brevo:

ربط الحقول المخصصة

field_mapping:
  # Standard fields
  Email: email
  FirstName: FIRSTNAME
  LastName: LASTNAME
  Phone: SMS

  # CRM fields
  LeadSource: LEAD_SOURCE
  Lead_Score__c: LEAD_SCORE
  Account.Name: COMPANY_NAME
  Account.Industry: INDUSTRY

  # Opportunity fields
  Amount: DEAL_VALUE
  StageName: DEAL_STAGE
  CloseDate: EXPECTED_CLOSE_DATE

  # Custom fields
  Preferred_Channel__c: PREFERRED_CHANNEL
  Customer_Tier__c: VIP_TIER

نقاط نهاية API

موارد REST API

Bulk API

Streaming API

الأحداث

أحداث السجلات (Change Data Capture)

Platform Events

أمثلة البرمجة

تهيئة الموصل

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

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

// Connect Salesforce
await tajo.connectors.connect('salesforce', {
  instanceUrl: 'https://yourorg.my.salesforce.com',
  consumerKey: process.env.SF_CONSUMER_KEY,
  consumerSecret: process.env.SF_CONSUMER_SECRET,
  refreshToken: process.env.SF_REFRESH_TOKEN
});

مزامنة جهات الاتصال باستخدام فلتر SOQL

// Sync only qualified leads from Salesforce
await tajo.connectors.sync('salesforce', {
  type: 'filtered',
  resources: ['leads'],
  filter: "SELECT Id, Email, FirstName, LastName, LeadScore__c FROM Lead WHERE Status = 'Qualified' AND Email != null",
  brevoListId: 16
});

// Check sync status
const status = await tajo.connectors.status('salesforce');
console.log(status);
// {
//   connected: true,
//   lastSync: '2024-01-15T10:30:00Z',
//   contactsSynced: 18400,
//   leadsSynced: 7200,
//   opportunitiesSynced: 3100
// }

البث في الوقت الفعلي

// Subscribe to Salesforce Change Data Capture
await tajo.connectors.stream('salesforce', {
  channels: [
    '/data/ContactChangeEvent',
    '/data/LeadChangeEvent',
    '/data/OpportunityChangeEvent'
  ],
  handler: async (event) => {
    console.log(`Change detected: ${event.entity} ${event.changeType}`);
    // Automatically synced to Brevo by Tajo
  }
});

حدود المعدل

تعتمد حدود Salesforce REST API على إصدارك وعدد التراخيص:

حدود إضافية:

• حد API المتزامن: 25 طلبًا طويل التشغيل
• Bulk API: 15,000 دفعة لكل 24 ساعة
• Streaming API: 2,000 حدث يوميًا (يمكن زيادتها)
• Composite API: 25 طلبًا فرعيًا لكل طلب مركب

استكشاف الأخطاء

المشكلات الشائعة

وضع التصحيح

فعّل تسجيلًا مفصلاً:

connectors:
  salesforce:
    debug: true
    log_level: verbose
    log_api_calls: true

اختبار الاتصال

tajo connectors test salesforce
# ✓ OAuth token valid
# ✓ Contacts accessible
# ✓ Leads accessible
# ✓ Accounts accessible
# ✓ Opportunities accessible
# ✓ Bulk API enabled

أفضل الممارسات

1. استخدم Bulk API للمزامنات الكبيرة - بدّل إلى Bulk API 2.0 لمجموعات البيانات التي تتجاوز 2,000 سجل
2. نفّذ Change Data Capture - استخدم CDC للمزامنة الفورية بدلاً من الاستطلاع
3. اربط الحقول الضرورية فقط - قلل استخدام API بمزامنة الحقول المطلوبة فقط
4. تعامل مع تحديث الرمز - نفّذ منطق تحديث رمز OAuth التلقائي
5. استخدم الطلبات المركبة - ادمج استدعاءات API ذات الصلة لتقليل عدد الطلبات
6. اختبر في بيئة التجربة أولاً - استخدم مؤسسة بيئة تجربة Salesforce قبل نشر الإنتاج

الأمان

• OAuth 2.0 - تفويض معياري صناعي مع أنواع منح متعددة
• قيود IP - يدعم Salesforce نطاقات IP لتسجيل الدخول وإعدادات IP الموثوقة
• TLS 1.2+ - جميع اتصالات API مشفرة بحد أدنى TLS 1.2
• أمان على مستوى الحقل - تحكم دقيق في الوصول إلى الحقل لكل ملف تعريف
• إدارة الجلسات - مهلة جلسة قابلة للتكوين وحدود جلسات متزامنة

موارد ذات صلة

• وثائق Salesforce REST API
• دليل Salesforce Bulk API 2.0
• موصل HubSpot
• مهارة مزامنة العملاء
• Brevo Contacts API