Conector Salesforce

Conector Salesforce

Conecte seu Salesforce CRM ao Brevo via Tajo para sincronização de contatos de nível empresarial, gestão de leads, rastreamento de oportunidades e automação de marketing impulsionada pelos dados do seu CRM.

Visão geral

Recursos

• Sincronização bidirecional de contatos/leads - Sincronize contatos e leads do Salesforce com listas de contatos do Brevo
• Rastreamento de oportunidades - Mapeie estágios e valores de negócios para segmentação baseada em receita
• Hierarquia de contas - Sincronize contas de empresas para marketing baseado em conta no Brevo
• Mapeamento de objetos personalizados - Mapeie objetos personalizados do Salesforce para atributos e eventos do Brevo
• Sincronização de membros de campanha - Sincronize membros de campanha do Salesforce com listas do Brevo
• Rastreamento de atividades - Sincronize tarefas, eventos e atividades de e-mail para pontuação de engajamento
• Streaming em tempo real - Use a Streaming API do Salesforce para atualizações instantâneas de dados
• Suporte a consultas SOQL - Filtre dados sincronizados com consultas SOQL personalizadas

Pré-requisitos

Antes de começar, certifique-se de que você tem:

1. Uma org Salesforce (qualquer edição com acesso à API)
2. Um Connected App configurado em Salesforce Setup
3. Acesso à API habilitado para o perfil do seu usuário Salesforce
4. Uma conta Brevo com acesso à API
5. Uma conta Tajo

Autenticação

OAuth 2.0 Web Server Flow (Recomendado)

Ideal para integrações em produção com autorização do usuário.

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

Fluxo Username-Password

Para integrações servidor-para-servidor sem interação do usuário.

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

Configuração

Configuração básica

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

Mapeamento de campos

Mapeie campos do Salesforce para atributos de contato do Brevo:

Mapeamento de campos personalizados

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

Endpoints da API

Recursos da REST API

Bulk API

Streaming API

Eventos

Eventos de registro (Change Data Capture)

Platform Events

Exemplos de código

Inicializar o conector

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

Sincronizar contatos com filtro 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
// }

Streaming em tempo real

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

Limites de taxa

Os limites da REST API do Salesforce dependem da sua edição e contagem de licenças:

Limites adicionais:

• Limite de API concorrente: 25 requisições de longa duração
• Bulk API: 15.000 lotes por 24 horas
• Streaming API: 2.000 eventos por dia (pode ser aumentado)
• Composite API: 25 sub-requisições por requisição composta

Solução de problemas

Problemas comuns

Modo de depuração

Habilite o log detalhado:

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

Testar conexão

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

Melhores práticas

1. Use a Bulk API para grandes sincronizações - Mude para a Bulk API 2.0 para conjuntos de dados acima de 2.000 registros
2. Implemente Change Data Capture - Use CDC para sincronização em tempo real em vez de polling
3. Mapeie apenas os campos necessários - Reduza o uso da API sincronizando apenas campos obrigatórios
4. Trate a renovação de token - Implemente lógica de renovação automática de token OAuth
5. Use requisições compostas - Combine chamadas de API relacionadas para reduzir a contagem de requisições
6. Teste primeiro em sandbox - Use uma org sandbox do Salesforce antes do deploy em produção

Segurança

• OAuth 2.0 - Autorização padrão de mercado com múltiplos tipos de grant
• Restrições de IP - O Salesforce suporta faixas de IP de login e configurações de IP confiáveis
• TLS 1.2+ - Toda comunicação com a API é criptografada com TLS 1.2 no mínimo
• Segurança em nível de campo - Controle granular de acesso a campos por perfil
• Gerenciamento de sessão - Timeout de sessão configurável e limites de sessões concorrentes

Recursos relacionados

• Documentação da REST API do Salesforce
• Guia da Bulk API 2.0 do Salesforce
• Conector HubSpot
• Skill de sincronização de clientes
• API de contatos do Brevo