Salesforce Bağlayıcısı

Salesforce CRM’inizi Tajo üzerinden Brevo’ya bağlayarak kurumsal düzeyde kişi senkronizasyonu, aday yönetimi, fırsat takibi ve CRM verilerinizle güçlendirilmiş pazarlama otomasyonu elde edin.

Genel Bakış

Özellikler

• Çift yönlü kişi/aday senkronizasyonu - Salesforce kişileri ve adaylarını Brevo kişi listeleri ile senkronize edin
• Fırsat takibi - Gelire dayalı segmentasyon için fırsat aşamalarını ve tutarlarını eşleyin
• Hesap hiyerarşisi - Brevo’daki hesap bazlı pazarlama için şirket hesaplarını senkronize edin
• Özel nesne eşleme - Salesforce özel nesnelerini Brevo öznitelikleri ve olaylarına eşleyin
• Kampanya üyesi senkronizasyonu - Salesforce kampanya üyelerini Brevo listeleri ile senkronize edin
• Aktivite takibi - Etkileşim puanlaması için görevleri, olayları ve e-posta aktivitelerini senkronize edin
• Gerçek zamanlı akış - Anlık veri güncellemeleri için Salesforce Streaming API’sini kullanın
• SOQL sorgu desteği - Senkronize edilen verileri özel SOQL sorgularıyla filtreleyin

Ön Koşullar

Başlamadan önce sahip olmanız gerekenler:

1. Bir Salesforce org (API erişimi olan herhangi bir sürüm)
2. Salesforce Kurulumunda yapılandırılmış bir Connected App
3. Salesforce kullanıcı profiliniz için API erişimi etkinleştirilmiş
4. API erişimi olan bir Brevo hesabı
5. Bir Tajo hesabı

Kimlik Doğrulama

OAuth 2.0 Web Server Flow (Önerilen)

Kullanıcı yetkilendirmesi ile üretim entegrasyonları için en iyisi.

# 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}"

Kullanıcı Adı-Şifre Akışı

Kullanıcı etkileşimi olmadan sunucudan sunucuya entegrasyonlar için.

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}"

Yapılandırma

Temel Kurulum

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

Alan Eşleme

Salesforce alanlarını Brevo kişi özniteliklerine eşleyin:

Özel Alan Eşlemesi

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 Uç Noktaları

REST API Kaynakları

Bulk API

Streaming API

Olaylar

Kayıt Olayları (Change Data Capture)

Platform Events

Kod Örnekleri

Bağlayıcıyı Başlat

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 Filtresi ile Kişileri Senkronize Et

// 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
// }

Gerçek Zamanlı Akış

// 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
  }
});

Hız Limitleri

Salesforce REST API limitleri, sürümünüze ve lisans sayınıza bağlıdır:

Ek limitler:

• Eşzamanlı API limiti: 25 uzun süreli istek
• Bulk API: 24 saatte 15.000 toplu iş
• Streaming API: Günde 2.000 olay (artırılabilir)
• Composite API: Composite istek başına 25 alt istek

Sorun Giderme

Sık Karşılaşılan Sorunlar

Hata Ayıklama Modu

Ayrıntılı günlüklemeyi etkinleştirin:

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

Bağlantıyı Test Et

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

En İyi Uygulamalar

1. Büyük senkronizasyonlar için Bulk API kullanın - 2.000’in üzerindeki veri kümeleri için Bulk API 2.0’a geçin
2. Change Data Capture uygulayın - Yoklama yerine gerçek zamanlı senkronizasyon için CDC kullanın
3. Yalnızca gerekli alanları eşleyin - Yalnızca gerekli alanları senkronize ederek API kullanımını azaltın
4. Belirteç yenilemeyi yönetin - Otomatik OAuth belirteci yenileme mantığı uygulayın
5. Composite istekleri kullanın - İstek sayısını azaltmak için ilgili API çağrılarını birleştirin
6. Önce sandbox’ta test edin - Üretim dağıtımından önce bir Salesforce sandbox org’u kullanın

Güvenlik

• OAuth 2.0 - Birden fazla grant türü ile endüstri standardı yetkilendirme
• IP kısıtlamaları - Salesforce, oturum açma IP aralıklarını ve güvenilir IP ayarlarını destekler
• TLS 1.2+ - Tüm API iletişimi minimum TLS 1.2 ile şifrelenir
• Alan düzeyinde güvenlik - Profil başına ayrıntılı alan erişim kontrolü
• Oturum yönetimi - Yapılandırılabilir oturum zaman aşımı ve eşzamanlı oturum limitleri

İlgili Kaynaklar

• Salesforce REST API Dokümantasyonu
• Salesforce Bulk API 2.0 Rehberi
• HubSpot Bağlayıcısı
• Müşteri Senkronizasyon Yeteneği
• Brevo Kişiler API’si