Salesforce
Consultar e atualizar dados comerciais no Salesforce CRM.
O que faz
Consulte e gerencie contas, contatos, leads, oportunidades, casos e tarefas da organização Salesforce autorizada. Execute relatórios e consultas SOQL e consulte objetos em páginas leves. A criação ou alteração de campos e objetos personalizados ainda não está disponível.
Quando usar: Use quando o seu fluxo precisar consultar e atualizar dados comerciais no Salesforce CRM.
Exemplo de situação: Encontrar um cliente e registrar o resultado do atendimento no funil.
Antes de começar
Conexão necessária: OAuth.
Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
Passo a passo
- Adicione Salesforce ao desenho a partir da aba Blocos e ligue a entrada dele à etapa anterior.
- Conecte a conta pelo botão de autorização do campo de credencial e confira qual usuário ou organização foi escolhido.
- Escolha a operação. O painel mostra só os campos que essa operação usa.
- Preencha os campos obrigatórios. Para usar um dado de uma etapa anterior, digite < e escolha o bloco e o campo.
- Clique em Executar com dados de teste e confira, no terminal, o que entrou e o que saiu do bloco.
- Só publique depois de conferir o resultado da execução de teste.
Para configurar o gatilho
- Copie a URL do webhook acima e defina um Segredo do webhook. No Salesforce, crie uma External Credential (que guarda o segredo) e uma Named Credential cuja URL seja esta URL do webhook, com um cabeçalho personalizado que envie o mesmo valor como Authorization: Bearer … ou X-Sim-Webhook-Secret: …. Se o valor do cabeçalho usar uma fórmula {!$Credential…}, marque Allow Formulas in HTTP Header ao adicioná-lo — caso contrário, o Salesforce envia o texto literal da fórmula em vez do segredo. A ação HTTP Callout do Flow exige uma Named Credential — ela não consegue chamar uma URL qualquer diretamente.
- Na External Credential, adicione um Permission Set com External Credential Principal Access ativado e atribua-o ao usuário com que o Flow é executado (o usuário Automated Process, nos flows acionados por registro) — caso contrário, o callout falha na autenticação.
- Acesse Setup → Flows e clique em New Flow.
- Selecione Record-Triggered Flow para o objeto certo e Registro criado como condição de entrada.
- Adicione um HTTP Callout usando a Named Credential do passo 1 — POST, corpo em JSON, caminho /. Flows acionados por registro só podem fazer callouts no caminho Run Asynchronously, então coloque esta ação nele.
- Inclua eventType no corpo JSON com um valor que este gatilho aceite (ex.: para Registro criado, use record_created, created ou after_insert).
- Se você usar Tipo de objeto (opcional), inclua também os metadados do tipo correspondente no corpo JSON (por exemplo objectType, sobjectType ou attributes.type); caso contrário, o evento será rejeitado.
- Salve o Flow e clique em Activate.
- Clique em "Salvar" acima para ativar o gatilho.
Operações
| Operação | O que faz |
|---|---|
| Obter contas | Obtém contas com o bloco Salesforce. |
| Criar conta | Cria conta com o bloco Salesforce. |
| Atualizar conta | Atualiza conta com o bloco Salesforce. |
| Excluir conta | Exclui conta com o bloco Salesforce. |
| Obter contatos | Obtém contatos com o bloco Salesforce. |
| Criar contato | Cria contato com o bloco Salesforce. |
| Atualizar contato | Atualiza contato com o bloco Salesforce. |
| Excluir contato | Exclui contato com o bloco Salesforce. |
| Obter leads | Obtém leads com o bloco Salesforce. |
| Criar lead | Cria lead com o bloco Salesforce. |
| Atualizar lead | Atualiza lead com o bloco Salesforce. |
| Excluir lead | Exclui lead com o bloco Salesforce. |
| Obter oportunidades | Obtém oportunidades com o bloco Salesforce. |
| Criar oportunidade | Cria oportunidade com o bloco Salesforce. |
| Atualizar oportunidade | Atualiza oportunidade com o bloco Salesforce. |
| Excluir oportunidade | Exclui oportunidade com o bloco Salesforce. |
| Obter casos | Obtém casos com o bloco Salesforce. |
| Criar caso | Cria caso com o bloco Salesforce. |
| Atualizar caso | Atualiza caso com o bloco Salesforce. |
| Excluir caso | Exclui caso com o bloco Salesforce. |
| Obter tarefas | Obtém tarefas com o bloco Salesforce. |
| Criar tarefa | Cria tarefa com o bloco Salesforce. |
| Atualizar tarefa | Atualiza tarefa com o bloco Salesforce. |
| Excluir tarefa | Exclui tarefa com o bloco Salesforce. |
| Listar relatórios | Lista relatórios com o bloco Salesforce. |
| Obter relatório | Obtém relatório com o bloco Salesforce. |
| Executar relatório | Executa relatório com o bloco Salesforce. |
| Listar tipos de relatório | Lista tipos de relatório com o bloco Salesforce. |
| Listar painéis | Lista painéis com o bloco Salesforce. |
| Obter painel | Obtém painel com o bloco Salesforce. |
| Atualizar painel | Atualiza painel com o bloco Salesforce. |
| Executar consulta SOQL | Executa consulta SOQL com o bloco Salesforce. |
| Obter mais resultados da consulta | Obtém mais resultados da consulta com o bloco Salesforce. |
| Descrever objeto | Descreve objeto com o bloco Salesforce. |
| Listar objetos | Lista objetos com o bloco Salesforce. |
| Executar consulta da Tooling API | Executa consulta da Tooling API com o bloco Salesforce. |
Campos
Operação
Escolhe qual ação este bloco executará.
- Opções:
- Obter contas · Criar conta · Atualizar conta · Excluir conta · Obter contatos · Criar contato · Atualizar contato · Excluir contato · Obter leads · Criar lead · Atualizar lead · Excluir lead · Obter oportunidades · Criar oportunidade · Atualizar oportunidade · Excluir oportunidade · Obter casos · Criar caso · Atualizar caso · Excluir caso · Obter tarefas · Criar tarefa · Atualizar tarefa · Excluir tarefa · Listar relatórios · Obter relatório · Executar relatório · Listar tipos de relatório · Listar painéis · Obter painel · Atualizar painel · Executar consulta SOQL · Obter mais resultados da consulta · Descrever objeto · Listar objetos · Executar consulta da Tooling API
- Padrão:
- Obter contas
Conta do Salesforce
ObrigatórioSeleciona a conta já conectada que autoriza o acesso ao serviço.
- Exemplo:
- (escolha a conta conectada)
Conta do Salesforce
ObrigatórioEm campos adicionaisInforma manualmente a credencial usada pela integração no modo avançado.
Campos a retornar
Em campos adicionaisCampos separados por vírgula.
- Aparece em:
- Obter contas, Obter contatos, Obter leads, Obter oportunidades, Obter casos, Obter tarefas
- Exemplo:
- { "chave": "valor" }
Limite
Em campos adicionaisDefine um valor numérico, quantidade ou limite da operação.
- Aparece em:
- Obter contas, Obter contatos, Obter leads, Obter oportunidades, Obter casos, Obter tarefas, Listar objetos
- Exemplo:
- 10
Continuar após o objeto
Em campos adicionaisDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Listar objetos
- Exemplo:
- Exemplo de atendimento
Ordenar por
Em campos adicionaisCampo e direção (ex.: "Name ASC").
- Aparece em:
- Obter contas, Obter contatos, Obter leads, Obter oportunidades, Obter casos, Obter tarefas
- Exemplo:
- "Name ASC"
ID da conta
Obrigatório conforme a operaçãoInforme o ID da conta no Salesforce.
- Aparece em:
- Atualizar conta, Excluir conta, Criar contato, Atualizar contato, Criar caso, Atualizar caso, Criar oportunidade, Atualizar oportunidade
- Exemplo:
- id-do-recurso
Nome
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar conta, Atualizar conta, Criar oportunidade, Atualizar oportunidade
- Exemplo:
- Exemplo de atendimento
Tipo
Em campos adicionaisClassificação da conta no Salesforce, usando um dos valores da lista configurada na sua organização (ex.: Customer ou Prospect).
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- Tipo
Setor
Em campos adicionaisSetor de atuação da empresa da conta, usando um dos valores da lista do Salesforce (ex.: Transportation).
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- Setor
Telefone
Identifica a conversa, o canal ou o telefone de destino.
- Aparece em:
- Criar conta, Atualizar conta, Criar contato, Atualizar contato, Criar lead, Atualizar lead
- Exemplo:
- +5511999999999
Site
Em campos adicionaisEndereço do site da empresa da conta (ex.: https://www.minhaempresa.com.br).
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- Site
Rua de cobrança
Em campos adicionaisInforme a rua do endereço de cobrança.
- Aparece em:
- Criar conta, Atualizar conta
Cidade de cobrança
Em campos adicionaisInforme a cidade de cobrança.
- Aparece em:
- Criar conta, Atualizar conta
Estado de cobrança
Em campos adicionaisInforme o estado/província de cobrança.
- Aparece em:
- Criar conta, Atualizar conta
CEP de cobrança
Em campos adicionaisInforme o CEP de cobrança.
- Aparece em:
- Criar conta, Atualizar conta
País de cobrança
Em campos adicionaisInforme o país de cobrança.
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- 10
Receita anual
Em campos adicionaisReceita anual (número).
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- Receita anual (número)
Número de funcionários
Em campos adicionaisQuantidade de funcionários (número inteiro).
- Aparece em:
- Criar conta, Atualizar conta
- Exemplo:
- 10
ID do contato
Obrigatório conforme a operaçãoID do contato.
- Aparece em:
- Obter contatos, Atualizar contato, Excluir contato, Criar caso, Atualizar caso
- Exemplo:
- id-do-recurso
Sobrenome
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar contato, Atualizar contato, Criar lead, Atualizar lead
- Exemplo:
- Exemplo de atendimento
Nome
Define o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar contato, Atualizar contato, Criar lead, Atualizar lead
- Exemplo:
- Exemplo de atendimento
E-mail
Informa o destinatário ou endereço de e-mail usado pela operação.
- Aparece em:
- Criar contato, Atualizar contato, Criar lead, Atualizar lead
- Exemplo:
- cliente@exemplo.com
Cargo
Define o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar contato, Atualizar contato, Criar lead, Atualizar lead
- Exemplo:
- Exemplo de atendimento
Departamento
Em campos adicionaisDepartamento em que o contato trabalha na empresa (ex.: Compras).
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- Departamento
Rua de correspondência
Em campos adicionaisInforme a rua do endereço de correspondência.
- Aparece em:
- Criar contato, Atualizar contato
Cidade de correspondência
Em campos adicionaisInforme a cidade de correspondência.
- Aparece em:
- Criar contato, Atualizar contato
Estado de correspondência
Em campos adicionaisInforme o estado/província de correspondência.
- Aparece em:
- Criar contato, Atualizar contato
CEP de correspondência
Em campos adicionaisInforme o CEP de correspondência.
- Aparece em:
- Criar contato, Atualizar contato
País de correspondência
Em campos adicionaisInforme o país de correspondência.
- Aparece em:
- Criar contato, Atualizar contato
- Exemplo:
- 10
ID do lead
Obrigatório conforme a operaçãoID do lead.
- Aparece em:
- Obter leads, Atualizar lead, Excluir lead
- Exemplo:
- id-do-recurso
Empresa
Obrigatório conforme a operaçãoNome da empresa.
- Aparece em:
- Criar lead, Atualizar lead
- Exemplo:
- Nome da empresa
Status
Situação do lead, caso ou tarefa no Salesforce, usando exatamente um dos valores configurados na sua organização (ex.: Working para um caso ou Completed para uma tarefa).
- Aparece em:
- Criar lead, Atualizar lead, Criar caso, Atualizar caso, Criar tarefa, Atualizar tarefa
- Exemplo:
- Status
Origem do lead
Em campos adicionaisInforme a origem do lead.
- Aparece em:
- Criar lead, Atualizar lead
ID da oportunidade
Obrigatório conforme a operaçãoID da oportunidade.
- Aparece em:
- Obter oportunidades, Atualizar oportunidade, Excluir oportunidade
- Exemplo:
- id-do-recurso
Fase
Obrigatório conforme a operaçãoInforme o nome da fase.
- Aparece em:
- Criar oportunidade, Atualizar oportunidade
- Exemplo:
- Exemplo de atendimento
Data de fechamento
Obrigatório conforme a operaçãoAAAA-MM-DD (obrigatório ao criar).
- Aparece em:
- Criar oportunidade, Atualizar oportunidade
- Exemplo:
- 2026-09-15
Valor
Valor do negócio.
- Aparece em:
- Criar oportunidade, Atualizar oportunidade
- Exemplo:
- 150.00
Probabilidade
Em campos adicionaisProbabilidade de ganho (0-100).
- Aparece em:
- Criar oportunidade, Atualizar oportunidade
- Exemplo:
- Probabilidade de ganho (0-100)
ID do caso
Obrigatório conforme a operaçãoID do caso.
- Aparece em:
- Obter casos, Atualizar caso, Excluir caso
- Exemplo:
- id-do-recurso
Assunto
Obrigatório conforme a operaçãoDefine o nome ou título usado para identificar o recurso.
- Aparece em:
- Criar caso, Atualizar caso, Criar tarefa, Atualizar tarefa
- Exemplo:
- Exemplo de atendimento
Prioridade
Prioridade do caso ou da tarefa no Salesforce, usando um dos valores da lista (ex.: High, Medium ou Low em casos; High, Normal ou Low em tarefas).
- Aparece em:
- Criar caso, Atualizar caso, Criar tarefa, Atualizar tarefa
- Exemplo:
- Prioridade
Origem
Em campos adicionaisOrigem (ex.: Phone, Email, Web).
- Aparece em:
- Criar caso, Atualizar caso
- Exemplo:
- Phone, Email, Web
ID da tarefa
Obrigatório conforme a operaçãoID da tarefa.
- Aparece em:
- Obter tarefas, Atualizar tarefa, Excluir tarefa
- Exemplo:
- id-do-recurso
Prazo
Define a data, o horário ou a programação usada pela operação.
- Aparece em:
- Criar tarefa, Atualizar tarefa
- Exemplo:
- 2026-09-15
ID do contato/lead relacionado
Em campos adicionaisID do contato ou do lead.
- Aparece em:
- Criar tarefa, Atualizar tarefa
- Exemplo:
- id-do-recurso
ID da conta/oportunidade relacionada
Em campos adicionaisID da conta ou da oportunidade.
- Aparece em:
- Criar tarefa, Atualizar tarefa
- Exemplo:
- id-do-recurso
ID do relatório
Obrigatório conforme a operaçãoID do relatório.
- Aparece em:
- Obter relatório, Executar relatório
- Exemplo:
- id-do-recurso
Termo de busca
Em campos adicionaisBusque relatórios pelo nome.
- Aparece em:
- Listar relatórios
Incluir detalhes
Em campos adicionaisDefine se este comportamento fica ativado ou desativado.
- Aparece em:
- Executar relatório
- Opções:
- Sim · Não
- Padrão:
- Sim
Filtros do relatório
Em campos adicionaisDefine a consulta ou o filtro aplicado aos dados.
- Aparece em:
- Executar relatório
- Exemplo:
- status = 'ativo'
ID do painel
Obrigatório conforme a operaçãoID do painel.
- Aparece em:
- Obter painel, Atualizar painel
- Exemplo:
- id-do-recurso
Consulta SOQL
Obrigatório conforme a operaçãoInforma a consulta usada para localizar ou transformar dados.
- Aparece em:
- Executar consulta SOQL, Executar consulta da Tooling API
- Exemplo:
- SELECT * FROM clientes WHERE status = 'ativo'
URL dos próximos registros
Obrigatório conforme a operaçãoURL da resposta da consulta anterior.
- Aparece em:
- Obter mais resultados da consulta
- Exemplo:
- https://api.exemplo.com/v1/recurso
Nome do objeto
Obrigatório conforme a operaçãoNome de API (ex.: Account, Lead, Custom_Object__c).
- Aparece em:
- Descrever objeto
- Exemplo:
- Exemplo de atendimento
Descrição
Em campos adicionaisInforma o conteúdo de texto que será enviado ou processado.
- Aparece em:
- Criar conta, Atualizar conta, Criar contato, Atualizar contato, Criar lead, Atualizar lead, Criar oportunidade, Atualizar oportunidade, Criar caso, Atualizar caso, Criar tarefa, Atualizar tarefa
- Exemplo:
- Descrição
Saídas
Para usar um resultado deste bloco em uma etapa seguinte, digite < no campo e escolha o bloco e o campo. A referência tem o formato <salesforce.success>: antes do ponto vai o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
| Referência | Tipo | O que contém |
|---|---|---|
<salesforce.success> | boolean | Indica se a operação foi concluída com sucesso. |
<salesforce.output> | json | Resultado da operação: registro(s) sObject nas operações de obter/criar/atualizar/excluir (contas, contatos, leads, oportunidades, casos, tarefas); dados de relatório/painel nas operações de análise; records[] + paginação nas consultas SOQL; esquema do sObject nas operações de descrever/listar objetos. |
Exemplo de uso
Objetivo: Encontrar um cliente e registrar o resultado do atendimento no funil.
- Operação
- Obter contas
- Conta do Salesforce
- (escolha a conta conectada)
Os valores são ilustrativos. Teste primeiro com dados fictícios ou de homologação.
Erros comuns e como resolver
- O bloco não executa
- Confira se existe um caminho de setas que parte do gatilho (ou do Início) até este bloco. Blocos soltos no desenho são ignorados.
- Aparece “Validação do fluxo” no terminal
- Há campo obrigatório vazio. Clique no aviso, abra o bloco indicado e preencha o campo marcado.
- Um campo chega vazio na etapa seguinte
- Confira se a referência aponta para um bloco que já executou e para um campo que existe, como <salesforce.success>. O nome antes do ponto é o nome do bloco no seu fluxo, em minúsculas, sem espaços e sem acentos.
- O campo que eu procuro não aparece
- Os campos mudam conforme a operação escolhida. Escolha a operação primeiro; campos menos usados ficam em “Mostrar campos adicionais”.
- Erro de autorização ou permissão (401/403)
- A conta conectada perdeu o acesso ou não tem permissão para esta operação. Reconecte a conta no campo de credencial e confirme as permissões pedidas.
- O serviço recusou a chamada ou devolveu erro
- Leia a mensagem no terminal: ela traz o motivo informado pelo serviço. Confira IDs, limites de uso e permissões, e teste antes com um recurso de homologação.
Blocos relacionados
- Adicionar notaRegistrar uma nota no histórico do negócio ou do contato.
- Buscar dados do CRMTrazer para o fluxo a etapa, o valor, o responsável e campos do negócio e do contato.
- Condição do CRMDividir a conversa pelo que o CRM sabe do contato, como negócio aberto, etapa, campo, temperatura ou responsável.
- Consultar origem do negócioConsultar a origem registrada do negócio e as referências de anúncios recebidas na conversa, sem confundir ganho com pagamento.
- Criar ou atualizar negócioAbrir um negócio no CRM para o contato da conversa ou atualizar o negócio aberto que ele já tem.
- Criar tarefaAgendar uma tarefa, ligação ou reunião no CRM para o responsável do negócio ou outra pessoa.