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 (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.