Konektor Salesforce

Konektor Salesforce

Propojte svůj Salesforce CRM s Brevo přes Tajo pro podnikovou synchronizaci kontaktů, správu leadů, sledování příležitostí a marketingovou automatizaci poháněnou daty z CRM.

Přehled

Funkce

• Obousměrná synchronizace kontaktů/leadů – Synchronizujte kontakty a leady Salesforce se seznamy kontaktů Brevo
• Sledování příležitostí – Mapujte fáze a částky obchodů pro segmentaci na základě výnosů
• Hierarchie účtů – Synchronizujte firemní účty pro marketing na základě účtů v Brevo
• Mapování vlastních objektů – Mapujte vlastní objekty Salesforce na atributy a události Brevo
• Synchronizace členů kampaní – Synchronizujte členy kampaní Salesforce se seznamy Brevo
• Sledování aktivit – Synchronizujte úkoly, události a e-mailové aktivity pro hodnocení zapojení
• Streamování v reálném čase – Používejte Streaming API Salesforce pro okamžité aktualizace dat
• Podpora SOQL dotazů – Filtrujte synchronizovaná data pomocí vlastních SOQL dotazů

Předpoklady

Než začnete, ujistěte se, že máte:

1. Organizaci Salesforce (jakékoli vydání s přístupem k API)
2. Nakonfigurovanou Připojenou aplikaci v Nastavení Salesforce
3. Povolený přístup k API pro váš uživatelský profil Salesforce
4. Účet Brevo s přístupem k API
5. Účet Tajo

Ověření

Webový server flow OAuth 2.0 (doporučeno)

Nejlepší pro produkční integrace s autorizací uživatele.

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

# Krok 2: Výměna kódu za tokeny
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}"

Flow uživatelského jména a hesla

Pro integrace server-server bez interakce uživatele.

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

Konfigurace

Základní nastavení

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

    # Možnosti synchronizace dat
    sync:
      contacts: true
      leads: true
      accounts: true
      opportunities: true
      campaigns: true

    # Směr synchronizace
    direction: salesforce_to_brevo

    # Přiřazení seznamů Brevo
    lists:
      all_leads: 15
      qualified_leads: 16
      customers: 17

Mapování polí

Mapujte pole Salesforce na atributy kontaktů Brevo:

Mapování vlastních polí

field_mapping:
  # Standardní pole
  Email: email
  FirstName: FIRSTNAME
  LastName: LASTNAME
  Phone: SMS

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

  # Pole příležitostí
  Amount: DEAL_VALUE
  StageName: DEAL_STAGE
  CloseDate: EXPECTED_CLOSE_DATE

  # Vlastní pole
  Preferred_Channel__c: PREFERRED_CHANNEL
  Customer_Tier__c: VIP_TIER

Koncové body API

Prostředky REST API

Bulk API

Streaming API

Události

Události záznamů (Change Data Capture)

Platformové události

Příklady kódu

Inicializace konektoru

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

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

// Připojení 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
});

Synchronizace kontaktů s filtrem SOQL

// Synchronizace pouze kvalifikovaných leadů ze 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
});

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

Streamování v reálném čase

// Přihlášení k odběru Change Data Capture Salesforce
await tajo.connectors.stream('salesforce', {
  channels: [
    '/data/ContactChangeEvent',
    '/data/LeadChangeEvent',
    '/data/OpportunityChangeEvent'
  ],
  handler: async (event) => {
    console.log(`Zjištěna změna: ${event.entity} ${event.changeType}`);
    // Automaticky synchronizováno do Brevo přes Tajo
  }
});

Omezení rychlosti

Limity REST API Salesforce závisí na vašem vydání a počtu licencí:

Další limity:

• Souběžný limit API: 25 dlouhodobých požadavků
• Bulk API: 15 000 dávek za 24 hodin
• Streaming API: 2 000 událostí za den (lze zvýšit)
• Composite API: 25 poddotazů na composite požadavek

Řešení problémů

Časté problémy

Režim ladění

Povolte podrobné protokolování:

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

Test připojení

tajo connectors test salesforce
# ✓ OAuth token platný
# ✓ Kontakty přístupné
# ✓ Leady přístupné
# ✓ Účty přístupné
# ✓ Příležitosti přístupné
# ✓ Bulk API povoleno

Osvědčené postupy

1. Používejte Bulk API pro velké synchronizace – Pro datové sady nad 2 000 záznamů přepněte na Bulk API 2.0
2. Implementujte Change Data Capture – Používejte CDC pro synchronizaci v reálném čase místo pollingu
3. Mapujte pouze potřebná pole – Snižte využití API synchronizací pouze požadovaných polí
4. Zpracovávejte obnovení tokenů – Implementujte logiku automatického obnovení OAuth tokenů
5. Používejte composite požadavky – Kombinujte související volání API ke snížení počtu požadavků
6. Nejprve testujte v sandboxu – Před nasazením do produkce použijte sandboxovou organizaci Salesforce

Zabezpečení

• OAuth 2.0 – Průmyslově standardní autorizace s více typy grantu
• Omezení IP – Salesforce podporuje přihlašovací rozsahy IP a nastavení důvěryhodných IP
• TLS 1.2+ – Veškerá komunikace API šifrována minimálně TLS 1.2
• Zabezpečení na úrovni polí – Podrobné řízení přístupu k polím na profil
• Správa relací – Konfigurovatelný časový limit relace a limity souběžných relací

Související zdroje

• Dokumentace Salesforce REST API
• Průvodce Salesforce Bulk API 2.0
• Konektor HubSpot
• Dovednost synchronizace zákazníků
• API kontaktů Brevo