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