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

Aprenda a configurar o Bloco de Ação "Pesquisar registros do HubSpot" 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 HubSpot, é necessário que sua empresa tenha pelo menos uma integração com o HubSpot conectada. Consulte este artigo da Central de Ajuda para saber mais sobre as integrações com o HubSpot.

 

 

O Bloco de Ação "Pesquisar registros do HubSpot" permite pesquisar e recuperar um registro específico do HubSpot 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 HubSpot, é necessário fornecer o respectivo ID do registro. O Bloco de Ação "Pesquisar registros do HubSpot" permite localizar o registro correto pesquisando no HubSpot 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 HubSpot", garantindo atualizações de dados precisas e integradas entre as plataformas.

 

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

Para configurar o bloco, siga estas etapas:

  1. Clique no Bloco de Ação "Pesquisar registros do HubSpot" 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. Empresa: Selecione a empresa conectada do HubSpot. Caso ainda não tenha configurado a integração com o HubSpot, consulte este artigo da Central de Ajuda para saber mais sobre as integrações com o HubSpot.
    2. Tipo de objeto: Escolha entre Contato, Empresa, Negócio, Ticket ou Objeto personalizado.
    3. Definir condições de pesquisa
      1. Propriedade: Selecione a propriedade do HubSpot 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. Por exemplo:
        1. Localizar um contato por e-mail
          1. Propriedade: e-mail
          2. Operador: é igual a
          3. Valor: {Contato: e-mail} 


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