Bloco de Ação "Pesquisar registros do Salesforce"

Aprenda a configurar o Bloco de Ação "Pesquisar registros do Salesforce" no Flow Builder avançado.

Written By Ray Tang (Super Administrator)

Updated at July 22nd, 2026

Antes de configurar os Blocos de Ação do Salesforce, é necessário que sua organização tenha pelo menos uma integração com o Salesforce conectada. Consulte este artigo da Central de Ajuda para saber mais sobre as integrações com o Salesforce.

 

 

O Bloco de Ação "Pesquisar registros do Salesforce" permite pesquisar e recuperar um registro específico do Salesforce com base em critérios definidos. Esse bloco é essencial para fluxos que dependem de dados existentes dos clientes para determinar a próxima ação.

Para atualizar corretamente um registro específico no Salesforce, é necessário fornecer o respectivo ID do registro. O Bloco de Ação "Pesquisar registros do Salesforce" permite localizar o registro correto pesquisando no Salesforce com base nos critérios definidos. Depois que o registro correspondente for encontrado, seu ID poderá ser utilizado no Bloco de Ação "Atualizar registro do Salesforce", garantindo atualizações de dados precisas e integradas entre as plataformas.

 

Configurando o Bloco de Ação "Pesquisar registros do Salesforce"

Para configurar o bloco, siga estas etapas:

  1. Clique no Bloco de Ação "Pesquisar registros do Salesforce" para abrir o formulário do bloco, que será exibido no lado direito da tela.



     
  2. O formulário do bloco contém os seguintes campos para configurar a ação:
    1. Organização: Selecione a organização do Salesforce conectada. Caso ainda não tenha configurado a integração com o Salesforce, consulte este artigo da Central de Ajuda para saber mais sobre as integrações com o Salesforce.
    2. Tipo de objeto: Escolha entre Contato, Organização, Negócio, Ticket ou Objeto personalizado.
    3. Definir condições de pesquisa
      1. Propriedade: Selecione a propriedade do Salesforce que será utilizada na pesquisa (por exemplo, e-mail, telefone, hs_object_id, domínio, dealname ou campos personalizados).
      2. Operador: Escolha a condição de comparação (por exemplo, é igual a, contém, começa com, maior que ou menor que).
      3. Valor: Insira um valor fixo ou adicione uma variável (de gatilho, de contato ou do fluxo) usando o seletor de variáveis.
        1. Por exemplo: 
          1. Propriedade: e-mail
          2. Operador: é igual a
          3. Valor: {Contato: e-mail}


             
      4. Tratar erro: Ative essa opção para configurar um caminho alternativo sempre que uma solicitação de pesquisa falhar. Quando habilitada:
        1. Um ramo adicional será criado no fluxo especificamente para solicitações com falha.
        2. Você poderá configurar esse ramo para definir o que deve acontecer quando a solicitação não puder ser concluída, como, por exemplo, criar um novo contato.