Salesforce کنیکٹر

Salesforce کنیکٹر

انٹرپرائز گریڈ رابطہ سنکرونائزیشن، لیڈ مینجمنٹ، موقع ٹریکنگ، اور اپنے CRM ڈیٹا سے چلنے والی مارکیٹنگ آٹومیشن کے لیے Tajo کے ذریعے اپنے Salesforce CRM کو Brevo سے منسلک کریں۔

جائزہ

خصوصیات

• دو طرفہ رابطہ/لیڈ سنک - Salesforce رابطوں اور لیڈز کو Brevo رابطہ فہرستوں کے ساتھ سنک کریں
• موقع ٹریکنگ - آمدنی پر مبنی سیگمنٹیشن کے لیے ڈیل مراحل اور رقوم میپ کریں
• اکاؤنٹ ہائرارکی - Brevo میں اکاؤنٹ بیسڈ مارکیٹنگ کے لیے کمپنی اکاؤنٹس سنک کریں
• کسٹم آبجیکٹ میپنگ - Salesforce کسٹم آبجیکٹس کو Brevo خصوصیات اور ایونٹس پر میپ کریں
• کمپین ممبر سنک - Salesforce کمپین ممبرز کو Brevo فہرستوں کے ساتھ سنک کریں
• سرگرمی ٹریکنگ - مصروفیت کی اسکورنگ کے لیے ٹاسکس، ایونٹس، اور ای میل سرگرمیاں سنک کریں
• ریئل ٹائم اسٹریمنگ - فوری ڈیٹا اپ ڈیٹس کے لیے Salesforce Streaming API استعمال کریں
• SOQL کوئری سپورٹ - کسٹم SOQL کوئریز کے ساتھ سنک شدہ ڈیٹا کو فلٹر کریں

شرائط

شروع کرنے سے پہلے، یقینی بنائیں کہ آپ کے پاس ہے:

1. Salesforce org (API رسائی کے ساتھ کوئی بھی ایڈیشن)
2. Salesforce Setup میں تشکیل کردہ Connected App
3. آپ کے Salesforce صارف پروفائل کے لیے API رسائی فعال
4. API رسائی کے ساتھ Brevo اکاؤنٹ
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 استعمال کریں - 2,000 سے زیادہ ریکارڈز والے ڈیٹا سیٹس کے لیے Bulk API 2.0 پر سوئچ کریں
2. Change Data Capture نافذ کریں - پولنگ کی بجائے ریئل ٹائم سنک کے لیے CDC استعمال کریں
3. صرف ضروری فیلڈز میپ کریں - صرف مطلوبہ فیلڈز سنک کرکے API استعمال کم کریں
4. ٹوکن ریفریش کو سنبھالیں - خودکار OAuth ٹوکن ریفریش منطق نافذ کریں
5. کمپوزٹ درخواستیں استعمال کریں - درخواست کاؤنٹ کم کرنے کے لیے متعلقہ API کالز کو یکجا کریں
6. پہلے سینڈ باکس میں ٹیسٹ کریں - پروڈکشن تعیناتی سے پہلے Salesforce سینڈ باکس org استعمال کریں

سیکیورٹی

• 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