Pesquisar Contato no HubSpot

O Que É o Componente Pesquisar Contato no HubSpot

O componente Pesquisar Contato no HubSpot permite encontrar e filtrar contatos com base em qualquer propriedade possível do HubSpot, incluindo propriedades personalizadas. Com as opções de operadores, possibilita dezenas de casos de uso exclusivos.

Principais Benefícios Deste Componente

• Pesquisa Flexível de Propriedades: Filtre contatos usando qualquer propriedade do HubSpot, inclusive campos personalizados. Isso oferece controle total sobre como você segmenta ou recupera dados.
• Suporte a Operadores Avançados: Utilize condições como igual, maior que, menor que, entre, contém, entre outros. Permite consultas precisas e personalizáveis.
• Compatibilidade com Fluxos de Trabalho: Use em combinação com outros componentes para criar fluxos completos. Ideal para rastreamento de leads, lembretes ou sincronização de dados entre ferramentas.
• Melhoria na Higiene de Dados: Identifique facilmente registros de contato incompletos ou desatualizados. Ajuda a manter seu CRM limpo e atualizado.
• Filtragem Baseada em Tempo: Pesquise por datas de criação ou modificação. Perfeito para criar ofertas de aniversário, campanhas de reengajamento ou detecção de leads inativos.
• Opções de Saída Personalizadas: Envie resultados para onde precisar—chat, Slack, Google Sheets, e-mail, entre outros. Facilita a automação de relatórios e alertas.

Configurações do Componente

Operador

Operadores são funções matemáticas que descrevem a relação entre sua consulta e o que está sendo buscado. Por exemplo, é possível buscar por uma correspondência exata de e-mails, mas também por contatos criados após determinada data, contatos sem propriedades específicas e muito mais.

Nome da propriedade

Você pode pesquisar por propriedades do HubSpot ou objetos personalizados. Combinando com as opções de operador, isso permite dezenas de casos de uso únicos. Além de informações como nomes, e-mails ou empresas, é possível filtrar por data de criação ou modificação, estágio do ciclo de vida e mais.

Outras Configurações

• Limitações: Defina o número de contatos a serem recuperados. O padrão é 1 para casos de correspondência exata, mas você pode aumentar para ações em massa. Lembre-se de que o tempo de processamento e o preço aumentam conforme o número de resultados.
• Descrição da Ferramenta: Forneça informações adicionais para ajudar o agente a entender como usar a ferramenta.
• Nome da Ferramenta: Adicione um nome que o agente deve usar para se referir a este componente na saída detalhada. Este nome é utilizado para sua conveniência.
• Verbose: Escolha se o agente deve mostrar seu raciocínio na interface do chat do FlowHunt. Isso é especialmente útil para depuração.

Handles

• Tool: Conecte o componente a um Agente de IA como ferramenta. Esta é a principal saída, permitindo ao agente usar este componente para criar novos registros de contato.
• After Add Contact: Conecte componentes para especificar ações que devem ocorrer após a criação do contato. Por exemplo, é possível configurar notificações no Slack, atualizar automaticamente o Google Sheets ou processar mais os dados.

Como Usar o Componente Pesquisar Contato no HubSpot

Agora que cobrimos o que o componente faz, vamos ver como utilizá-lo. Antes de vê-lo em ação, veja alguns casos de uso populares para ilustrar os tipos de problemas que este componente pode resolver:

• Conformidade e higiene de dados: Usando os operadores “não está em”, “não possui propriedade” ou “contém token” para encontrar leads de teste, campos de contato ausentes ou registros incompletos para suprimir ou corrigir.
• Detecção de leads inativos: Notificações automáticas para contatos com ciclo de vida=lead que não foram modificados em determinado período.
• Campanhas baseadas em localização: Pesquisando contatos de países, cidades ou CEPs específicos para gerar e enviar campanhas locais, convites para eventos e mais.
• Campanhas baseadas em tempo: Buscando contatos com uma data de criação específica para gerar e enviar ofertas de aniversário.
• Lembretes de renovação automática: Usando o operador “menor ou igual” na data de última modificação para encontrar clientes em vias de renovação e acionar um follow-up ou ofertas especiais.
• Novo contato de contas chave: Detectando contatos recém-criados de empresas alvo para acionar instantaneamente alertas internos ou encaminhar ao representante de vendas correto.
• Roteamento de vendas por CEP: Utilizando o operador “em” para corresponder contatos a uma lista pré-definida de CEPs e designá-los a um representante regional ou campanha local.
• Roteamento inteligente por interesse: Utilizando propriedades personalizadas como “Interesse = Produto A” para encaminhar contatos instantaneamente para follow-ups de vendas ou jornadas de conteúdo relevantes.

Construindo Um Fluxo de Detecção de Leads Inativos

Vamos testar o componente. Vamos criar um Fluxo muito simples de detecção de leads inativos. Em outras palavras, buscaremos contatos com estágio do ciclo de vida = lead E data da última modificação há X dias.

Para este propósito, testaremos como um chatflow. No entanto, este processo pode ser totalmente automatizado como um cron job e enviar a saída para onde você precisar, seja notificações no Slack ou Gmail para fácil acesso, ou uma planilha para gerar relatórios automáticos.

Passos:

1. Como este é um chatflow, adicione Entrada de Chat, Saída e Histórico.
2. Adicione um Agente de IA que usará o componente HubSpot como ferramenta.
3. Como estamos fornecendo duas condições de busca, precisamos de dois componentes Pesquisar Contato no HubSpot.
4. Conecte os componentes conforme ilustrado abaixo:

5. Em seguida, configure o Operador e o Nome da propriedade da busca.
6. O primeiro componente de Pesquisa busca pela lastmodifieddate que seja Maior ou igual a X dias. Ou seja, busca por registros inativos:

7. O segundo componente de Pesquisa busca por lifecyclestage que seja igual a lead. Essa busca garante que clientes existentes ou outros tipos de registros não entrem no resultado:

8. Isso é tudo que você precisa para um chatflow que permite dar instruções no chat e obter resultados no chat. Você pode expandir esse Fluxo, tornando-o automático para enviar resultados para apps de terceiros em vez do chat.

Vamos testar. Enviaremos as seguintes instruções no chat:

Retornar contatos onde o estágio do ciclo de vida é lead E data da última modificação maior ou igual a 5 dias.

Em um fluxo totalmente automatizado, você inseriria permanentemente as instruções nos Agentes de IA e nas configurações do componente Pesquisar Contato. Como estamos fazendo um chatflow, podemos simplesmente enviar as instruções no chat.

Após algum processamento, o Fluxo retornou um único contato:

Vamos ver se o resultado está correto. Olhando para nossa lista de contatos do HubSpot, vemos 4 registros. No entanto, um deles é cliente. E os outros dois foram modificados hoje (10 de abril). Ou seja, o contato retornado pelo Fluxo é de fato o único que se encaixa nos critérios dados:

No nosso exemplo, acionamos o Fluxo manualmente, e os resultados são retornados no chat. No entanto, é possível transformá-lo facilmente em uma solução totalmente automatizada executando como um cron job e trocando a saída do chat por qualquer fonte de saída necessária, como o componente Criar Google Sheet para relatórios automáticos ou ferramenta de Envio de mensagem Slack ou notificação por e-mail para notificações.