Pular para o conteúdo principal
O step HubSpot permite que seus agentes interajam diretamente com o CRM, criando negócios, consultando oportunidades e buscando contatos. Com isso, a Tess deixa de apenas analisar dados e passa a operar dentro do funil de vendas, automatizando processos comerciais.

​
O que é

Essa integração conecta seu agente ao HubSpot, permitindo quatro ações principais:
  1. Create Deal (Criar Negócio): Abre uma nova oportunidade no funil de vendas.
  2. Get Deal (Buscar Negócio): Consulta as informações detalhadas de uma oportunidade específica.
  3. Search Contacts (Buscar Contatos): Filtra e localiza leads/clientes no seu banco de dados.
  4. Search Deals (Buscar Negócios): Varre seu funil em busca de oportunidades com base em estágios, datas ou propriedades.
Image

​
Como usar (Quickstart por ação)

Create Deal (Criando uma Oportunidade)

Ideal para qualificação automática. A IA insere o lead direto no pipeline correto.
  • *Deal Name : O título do negócio (ex: Novo Lead - {{Nome_Empresa}}).
  • *Deal Stage ID : O código exato da coluna/estágio do funil onde ele deve cair (ex: 1234567).
  • *Pipeline ID : O ID do seu funil comercial (ex: default ou o ID numérico).
  • HubSpot Owner ID: O ID do vendedor/atendente dono da oportunidade.
  • Close Date: Data prevista de fechamento no formato YYYY-MM-DD.
  • *Deal Value : O valor monetário da negociação (ex: 5000.00).
Image

Get Deal (Consultando Oportunidade Específica)

Baixa todo o contexto do negócio e injeta na memória do agente.
  • *Deal ID : O código único da oportunidade. Geralmente vem repassado por uma integração prévia.
    Image

Search Contacts (Procurando Clientes)

Útil para enriquecimento de atendimento (ex: o cliente chama no WhatsApp e a Tess já verifica no HubSpot quem ele é).
  • Start Date / End Date: Estabelece um período de criação ou modificação do lead (YYYY-MM-DD ou YYYY-MM-DDT00:00:00Z).
  • Email Contains: Filtra leads por domínio corporativo ou e-mail exato (ex: @empresa.com).
  • Lead Status: O ciclo de vida do contato (ex: New, In Progress, Qualified).
Image

Search Deals (Auditoria de Funil)

Busca negócios em lote baseando-se em critérios específicos, excelente para análises gerenciais.
  • Start Date: Data a partir da qual buscar.
  • Deal Stage ID: Para buscar todos os deals travados em uma coluna específica, por exemplo.
  • Pipeline ID: Em qual funil realizar a busca.
  • Deal Properties: Informa à Tess quais dados ela deve “puxar” do HubSpot (separados por vírgula). Ex: dealname,amount,closedate. Assim você não sobrecarrega a IA com dados inúteis.
    Image
Para que a conexão funcione, o HubSpot não usa “Nomes” (como “Funil de Vendas”), mas sim IDs (valores numéricos e textuais exatos).
  • Como achar Pipeline ID e Stage ID? No seu HubSpot, clique no ícone de engrenagem (Configurações) > Data Management > Deals > Aba Pipelines. Lá você consegue visualizar ou via exportação de dados para obter as tags de identificação internas.

​
Exemplos práticos

Caso de Uso 1: Agente para Qualificação Automática de Leads
  1. O lead entra no seu site ou WhatsApp e responde a 3 perguntas de um formulário pré-chat (User Inputs).
  2. O step Create Deal pega as variáveis desse formulário e abre o negócio imediatamente no HubSpot com o status de “MQL” e o valor estimado inserido pelo lead.
  3. O agente assume a conversa já com o lead garantido no CRM, focado apenas em conduzir a venda.
Caso de Uso 2: Avaliação de Renovações de Contratos (Previsão de Churn)
  1. Um fluxo Make/Zapier aciona o agente da Tess uma vez por mês.
  2. O step Search Deals puxa todos os negócios na coluna “Clientes Ativos”, usando a Deal Property closedate.
  3. O prompt do agente analisa as datas e formula relatórios ou redige e-mails automáticos focados naqueles próximos da data de vencimento.
Boas práticas
  • Atenção aos campos com asterisco ():* Eles são pré-requisitos lógicos do HubSpot. Sem eles, a inserção irá falhar.
  • Cuidado com as Datas: Respeite rigorosamente o formato exigido nos campos (escreva sempre no padrão YYYY-MM-DD, ou seja, 2024-12-31).
  • Otimize com “Deal Properties”: No step Search Deals, se você deixar vazio, a IA pode puxar excesso de dados em branco das oportunidades. Sempre especifique campos relevantes como valor, nome e status.

​
Observações importantes

  • Autenticação Obrigatória: Seu Workspace da Tess AI precisa estar logado na sua conta HubSpot via OAuth (nas configurações de Integrações no próprio agente).
  • Consumo de Créditos: Além dos tokens de conversação, realizar ações constantes de busca múltipla (Search Deals) consome créditos proporcionais do seu plano.
  • Permissões de Usuário: A credencial logada na Tess precisa ter perfil de acesso para gravar e ler negócios no CRM original.
Mais do que apenas uma assistente de comunicação, a integração entre Tess e HubSpot transforma sua IA em um operador ativo de Revenue. Elimine trabalhos braçais, garanta que todo atendimento vire um card no CRM e mantenha seu time focado exclusivamente no fechamento.