Capacidades
- Extrair os objetos padrão do CRM via SOQL.
- Carga incremental por
LastModifiedDate— só o que mudou entra a cada ciclo. - Registro automático no Data Catalog com linhagem.
Objetos suportados
Campos customizados além dos padrão acima: [verificar].
Pré-requisitos
Connected App no Salesforce
Um Connected App com OAuth habilitado, para obter o Consumer Key e o Consumer Secret.
Usuário de integração
Um usuário Salesforce com acesso de leitura aos objetos e permissão de API habilitada.
Configuração
O conector usa o fluxo OAuth username-password do Salesforce. Você precisa de cinco credenciais: usuário, senha, security token, Consumer Key e Consumer Secret.1
Crie um Connected App
Em Setup → App Manager → New Connected App, habilite Enable OAuth Settings, adicione os escopos de API e salve. Copie o Consumer Key e o Consumer Secret.
2
Obtenha o security token
Com o usuário de integração, acesse Settings → Reset My Security Token. O token chega por e-mail e é anexado à senha na autenticação.
3
Adicione o conector no Console
Em Data Pipelines, clique em + Nova Conexão, busque por Salesforce e preencha:
- Nome do Conector — Obrigatório. Identifica o conector na lista.
- Usuário — Obrigatório. Login do usuário de integração.
- Senha — Obrigatório. Senha do usuário.
- Security Token — Obrigatório. Token obtido acima.
- Consumer Key (Client ID) — Obrigatório. Do Connected App.
- Consumer Secret (Client Secret) — Obrigatório. Do Connected App.
Autenticação e escopos
A autenticação é OAuth username-password contra o Connected App. Os escopos abaixo cobrem leitura de API.
O usuário de integração precisa de acesso de leitura (perfil ou permission set) aos objetos Contact, Account, Opportunity, Lead e Case.
Frequência de sync
A frequência é definida por conector, na tela de configuração. Para CRM, horário costuma ser o padrão. Veja Frequência de sync para o detalhe de cada opção.Limitações conhecidas
- Só os cinco objetos padrão listados são ingeridos. Objetos customizados e campos customizados: [verificar].
- O fluxo username-password depende do security token, que precisa ser reemitido a cada troca de senha.
- Salesforce impõe limites de chamadas de API por dia (API request limits). Volumes altos com frequência agressiva podem esbarrar nesse teto. [verificar]
- Anexos, arquivos e histórico de campos (field history) não são ingeridos.
Troubleshooting
Próximos passos
HubSpot CRM
Conector de CRM alternativo, com contatos, empresas e negócios.
Memory
Como os dados de CRM viram entidades no grafo do Memory.