Como configurar a IA da HubSpot? Tutorial com dicas e passo a passo

Se você já ficou olhando para o botão de ligar a IA da HubSpot sem saber se aperta ou não, a dúvida é mais comum do que parece.

O time se anima com a ideia de ter quem prepare reuniões, priorize leads e escreva o primeiro rascunho dos e-mails, e logo alguém pergunta o que essa IA vai ler exatamente, porque um agente é rápido e incansável e lê tudo o que encontra, inclusive o que está errado.

Segurança e risco são a principal barreira para escalar IA agêntica nas empresas (McKinsey), e só 23% dos líderes de TI se dizem muito confiantes na própria capacidade de gerenciar segurança e governança ao implantar IA generativa (Gartner).

A boa notícia é que o receio não pede que a empresa espere indefinidamente, pede que ela coloque o trabalho na ordem certa, e é isso que as próximas seções mostram.

Por que ligar IA em um CRM com dado sujo amplifica o problema?

Porque a IA trabalha sobre o que lê, e lê tudo com a mesma confiança. A própria HubSpot avisa que a IA usa os dados do CRM e que dados incompletos podem gerar respostas imprecisas.

Um erro de dado costuma ficar contido, porque alguém percebe, desconfia e corrige. Com a IA, o mesmo erro vira insumo de decisão, e a decisão se repete para cada registro, cada sequência e cada resposta.

Não é má-fé do agente, é uma base que nunca foi pensada para ser lida por uma máquina.

A Gartner mostra o outro lado dessa conta. As organizações com iniciativas de IA bem-sucedidas investem até quatro vezes mais, em proporção da receita, em fundações como qualidade de dados, governança e gestão de mudança do que as que têm resultados ruins.

Ou seja, quem se sai bem com IA investe mais nas fundações que a sustentam, e é essa preparação que as próximas seções organizam.

Leia mais: Como evitar falhas na implementação de CRM

Quais são os pré-requisitos antes de ligar a IA da HubSpot?

Os pré-requisitos se organizam em cinco grupos de verificação: as propriedades, as permissões, a higienização da base, o contexto do negócio e o ambiente de teste.

A lista abaixo cobre o que checar em cada um na sua conta.

Propriedades

• Os campos que a IA mais usa, como estágio do ciclo de vida, status do lead, porte, setor e origem, estão preenchidos e com valores padronizados, sem variações do mesmo termo.
• Os campos importantes são obrigatórios na criação manual de registros, e os que sofrem com digitação livre têm regra de validação.
• As propriedades com baixa taxa de preenchimento foram arquivadas, e as criadas por integrações que ninguém usa foram revisadas.

A própria HubSpot recomenda padronizar propriedades, usar regras de validação e arquivar as de baixo preenchimento antes de adotar os recursos de IA.

Permissões e acessos

• A lista atual de Superadministradores e Administradores parceiros, que são os únicos perfis que alteram as configurações de IA da conta, foi revisada, e todos os nomes nela ainda deveriam estar ali.
• Nenhum usuário inativo ou acesso antigo continua ativo, nem na conta do HubSpot nem nas integrações conectadas a ela.
• Cada chave de acesso a dados da IA foi revisada, já que os dados do CRM e as conversas com clientes vêm ligados por padrão e os arquivos vêm desligados, e cada uma tem um motivo claro para ficar como está.
• O acesso ao Breeze Assistant, que já vem liberado por padrão, foi confirmado, e os agentes, que podem consumir créditos, ficam restritos a quem vai usá-los.

Fazendo o diagnóstico do portal HubSpot de clientes, a Aconcaia já encontrou o marketing sem acesso à própria conta de anúncios, enquanto uma pessoa que já tinha saído ainda estava logada.

O mesmo cuidado vale para a conta onde mora o CRM, antes de qualquer IA ler o que está nela.

Higienização da base

• Contatos e empresas duplicados foram mesclados, para que o histórico de engajamento fique em um único registro.
• E-mails e gravações de chamadas ficam registrados no HubSpot, com títulos de atividade e assuntos claros, porque é desse material que a IA tira contexto.
• Registros que pertencem a usuários inativos foram reatribuídos.
• As listas antigas importadas que ainda influenciam segmentações e fluxos foram revisadas.
• Os fluxos de trabalho ativos foram mapeados, com atenção aos que mudam estágio, dono ou status de assinatura.

Contexto do negócio

Antes de ligar um agente, ele precisa saber o que a empresa vende, para quem e com que voz. Na HubSpot, esse material vive no Context Home, que reúne o kit de marca, o perfil da empresa, os perfis de cliente ideal e as ofertas.

Inclusive, a Gartner chega à mesma conclusão pelo lado da tecnologia, ao dizer que agentes não funcionam de forma autônoma sem contexto de alta qualidade e confiança.

Sem esse contexto, cada agente preenche as lacunas por conta própria, e a empresa acaba com vários bots soltos dando respostas diferentes.

Leia mais: Context Home no HubSpot: o que é e como funciona

Ambiente de testes

Dá para testar sem tocar em nenhum dado real. A HubSpot recomenda começar por uma conta de teste de desenvolvedor, que é gratuita e totalmente separada da produção.

Você pode usar o ambiente sandbox das contas Enterprise quando for preciso copiar a estrutura de funis de vendas, propriedades e fluxos, sem os dados.

Na conta de teste, a regra é usar dados fictícios, de preferência três contatos, três empresas e um negócio, e nunca copiar registros reais.

Os fluxos de trabalho nascem inativos, e o botão de ativação é o ponto de aprovação humana, então vale criar o rascunho com o Breeze Assistant e inscrever um único contato de teste antes de muitos.

A mesma fonte sugere classificar as ações por risco, de modo que só o que a IA apenas sugere e você aprova vá direto para produção, enquanto o que automatiza ou altera muitos registros é ensaiado antes.

Qual é o passo a passo para configurar a IA no HubSpot?

O passo a passo segue a ordem que a própria HubSpot recomenda, com duas paradas a mais, uma para organizar a base e outra para testar antes de ligar qualquer agente.

1. Confirme quem pode configurar

O caminho é o ícone de configurações > Usuários e equipes, e as configurações de conta e de recursos de IA exigem a permissão de Superadministrador ou Administrador parceiro. Comece revisando essa lista.

Promova só quem precisa

Passe o mouse sobre o usuário na tabela e use Ações > Tornar superadministrador, lembrando que só um superadministrador define outro.

Tire o acesso de quem já saiu

Use a permissão Adicionar e editar usuários, na seção Conta, que permite desativar ou remover usuários.

2. Ative a IA e revise o que ela pode ler

O caminho é ⚙️ > Gerenciamento de conta > IA > Acesso, com permissão de superadministrador. Quase tudo já vem ligado, então o trabalho é revisar cada chave e decidir o que manter.

Ofereça aos usuários acesso a ferramentas e recursos de IA generativa

Vem ligada e precisa estar ligada para qualquer recurso generativo, inclusive o Breeze Assistant.

Dados do CRM

Vem ligada e dá à IA acesso a contatos, empresas, negócios, tickets, observações e feedback, então confirme antes que a base está organizada, o que o passo 5 detalha.

Dados de conversa do cliente

Vem ligada e cobre transcrições e gravações de chamadas, e-mails e chats, e vale revisar se há conteúdo sensível nesses registros.

Dados de arquivos

Vem desligada, e a chave só faz sentido quando arquivos públicos ou da ferramenta de arquivos devem servir de contexto.

Dê aos usuários acesso ao Breeze Assistant

Vem ligada, e para restringir pessoas específicas o ajuste é individual, nas permissões do usuário.

Treinamento do modelo de IA

Vem ligada e define se a HubSpot pode usar os dados da conta para treinar os modelos dela, e com a chave desligada os recursos de IA continuam funcionando, enquanto as mudanças ficam registradas nos registros de auditoria.

3. Controle o acesso por pessoa, agente e crédito

A HubSpot recomenda manter o Breeze Assistant liberado, porque ele ajuda nas tarefas do dia a dia sem consumir créditos, e limitar agentes e assistentes a pessoas específicas, para evitar mudanças não intencionais no processo e gasto de créditos.

Breeze Assistant

Para tirar o acesso de alguém, atualize a permissão do Breeze Assistant do usuário ou da equipe. Nos recursos embutidos em outras ferramentas, a pessoa também precisa da permissão da ferramenta, como a de editar posts de blog para gerar conteúdo em um post.

Permissões de IA

No editor de permissões, digite Recursos de IA na busca para ver todas. Entre elas estão Construtor de agentes, Editor do Customer agent, Atribuição do Breeze Prospecting agent, Breeze prospecting agent admin, Estúdio de dados, Acesso ao enriquecimento de dados e Acesso do Agente de dados, e todas usam créditos, exceto o Administrador do Breeze Assistant e a visualização e a edição do Estúdio de dados.

Acesso a cada agente

Para projetos e agentes sem permissão própria, a configuração de acesso permite escolher entre só proprietários e superadministradores editarem e executarem, só eles editarem e todos executarem, todos editarem e executarem, ou acesso personalizado por equipes e usuários.

Assinaturas

O Customer Agent exige Professional ou Enterprise, o criador de agentes e o Breeze Prospecting Agent exigem Starter, Professional ou Enterprise, e o Data Studio exige Data Hub Professional ou Enterprise.

4. Preencha o contexto do negócio

O caminho no menu é Agentes > Agent Hub > Contexto. A maior parte das atualizações exige Superadministrador ou Administrador parceiro, e quem tem a permissão de administrador do agente de vendas também atualiza Produtos e serviços.

Negócio

Em Kit de marca, clique em Gerenciar kits de marca para definir voz, tom e diretrizes. Em Identidade e classificação, Localização e escala, Perfil de negócios, Contexto de mercado e ecossistema e Pilha de tecnologia, clique em Editar ao lado do título, e em Produtos e serviços use Adicionar produto ou serviço.

Clientes

Em Perfis de clientes ideais, clique em Adicionar PCI, e em Personas, clique em Adicionar persona, preenchendo os detalhes no painel da direita.

Equipe e processos

Em Perfil do usuário, clique em Gerenciar perfil do usuário, e em Personalidade do e-mail, clique em Adicionar tipo de e-mail para definir tom, estilo e voz, lembrando que qualquer pessoa cria personalidades de e-mail e atualiza o próprio perfil.

Personalizar

Em Contexto personalizado, clique em Adicionar contexto personalizado e escolha Escrever texto de formato livre ou Carregar arquivos, definindo a visibilidade.

Repositórios de conhecimento

Reúne o contexto adicional de projetos e agentes específicos.

Kit de marca e perfil da empresa

A HubSpot sugere configurar o contexto de identidade, que rastreia o domínio do site para estabelecer voz, tom, perfil de cliente ideal, produtos e concorrentes, e o assistente de marca, que verifica se o conteúdo gerado segue a identidade da marca. O perfil da empresa, com nome, domínio e setor, completa o básico e evita que a IA invente fatos fundamentais sobre o negócio.

5. Organize os dados antes de ligar qualquer agente

As ferramentas de qualidade de dados exigem assinatura Starter, Professional ou Enterprise. Para ver a saúde geral da base, abra Gerenciamento de dados > Qualidade de Dados, que reúne as abas Visão geral, Gerenciar Duplicatas e Problemas de formatação, e depois resolva os três pontos a seguir.

Propriedades

Em Configurações > Propriedades, escolha o objeto, clique na propriedade e abra a guia Regras para criar regras de validação, e arquive as propriedades com baixa taxa de preenchimento.

Para tornar campos obrigatórios na criação manual de registros, vá em Configurações > Gerenciamento de dados > Objetos, escolha o objeto e, em Criando [objetos], clique em Personalizar o formulário Criar [objeto]. Alterar o tipo de campo pode invalidar valores existentes, então exporte os dados antes.

Duplicatas

Em CRM > Contatos ou Empresas, clique em Ações > Gerenciar dados duplicados, revise os pares e mescle. A revisão de pares exige Professional ou Enterprise, a mesclagem em massa exige Data Hub Professional ou Enterprise, e registros mesclados não podem ser revertidos, então confira cada par antes.

Dados não estruturados

Confirme que as equipes registram e-mails e gravam chamadas no HubSpot, com assuntos de e-mail e títulos de atividade claros e descritivos, porque a IA lê esse material.

6. Conecte materiais e fontes externas

Para agentes voltados ao cliente, como o Customer Agent, o contexto sobre produtos, serviços e políticas ajuda a dar respostas precisas, e para assistentes internos o contexto sobre processos e regras de negócio melhora as recomendações.

Arquivos e conteúdo escrito

Conecte arquivos, artigos da Central de Conhecimento, posts de blog e landing pages como fontes dos assistentes e agentes.

Aplicativos e conectores de IA

Conecte aplicativos do HubSpot Marketplace, como Google Agenda, Zoom e Asana, e use conectores de IA, como o conector Gemini da HubSpot, quando outros modelos precisarem acessar os dados do HubSpot.

Cada conexão é uma decisão de acesso

Trate cada conexão como uma nova decisão de acesso, porque ela amplia o que a IA enxerga.

7. Teste antes de ligar o primeiro agente

Na conta de desenvolvedor da HubSpot, abra Testes > Contas de teste > Criar conta de teste de desenvolvedor e preencha a conta de teste com dados fictícios, como três contatos, três empresas e um negócio.

Crie o fluxo como rascunho

Em Automação > Fluxos de trabalho, crie o fluxo como rascunho, porque fluxos nascem inativos, e use Revisar e publicar e depois Ativar fluxo de trabalho como ponto de aprovação humana.

Inscreva um contato por vez

Inscreva um único contato de teste antes de muitos e observe o resultado passo a passo.

Use o ambiente sandbox

Nas contas Enterprise, o ambiente sandbox para testes copia a estrutura de funis de vendas, propriedades e fluxos, sem os dados.

Faça uma pergunta de controle

Pergunte ao Breeze Assistant algo cuja resposta você já conhece, como preço ou perfil de cliente ideal, e compare com o que o seu melhor profissional responderia.

8. Ative um recurso por vez e acompanhe

Depois de configurar dados e contexto, escolha um recurso ligado a um objetivo concreto, como o Breeze Assistant para esboçar um post, o Breeze Prospecting Agent para escalar e-mails de prospecção ou o Customer Agent para desviar tickets, lembrando que cada um tem requisitos de assinatura próprios.

Acompanhe o resultado, como o tempo gasto na preparação de chamadas e a confiança do time nas respostas, e, se as respostas vierem genéricas, registre mais chamadas no HubSpot para dar contexto à IA.

Leia mais: Agent Hub: a central de controle da IA da HubSpot

Quais erros de configuração mais se repetem?

Quase todos têm a mesma raiz, que é a ordem. Quem liga primeiro e organiza depois descobre os problemas em produção, com clientes e dados reais, e os seis a seguir são os que mais aparecem.

Deixar os padrões da conta sem revisar

Os dados do CRM e as conversas com clientes já vêm ligados para a IA, então quem nunca abriu a tela de IA da conta nunca decidiu o que ela pode ler. Revise cada chave e registre o motivo de mantê-la ou desligá-la antes de ativar qualquer agente.

Abrir agentes para todo mundo

Agentes consomem créditos e atuam sobre registros, então o acesso deveria seguir quem vai usá-los, e quem edita a lógica de um agente não precisa ser quem apenas o utiliza, porque a HubSpot permite separar os dois papéis.

Achar que o acesso ao Breeze basta

Para usar o Breeze dentro de uma ferramenta específica, a pessoa também precisa da permissão daquela ferramenta, como a de editar posts de blog para gerar conteúdo em um post, e sem isso a equipe conclui que a IA não funciona.

Testar direto em produção

Prefira conta de teste, dados fictícios e um registro antes de muitos, e trate chaves de acesso como chaves-mestras, que não devem ficar em arquivos compartilhados nem em telas abertas durante uma apresentação.

Somar a IA a fluxos de trabalho e integrações que ninguém revisou

Fluxos antigos não desaparecem quando a IA chega, e integrações mal mapeadas enchem o CRM de propriedades sem uso, então vale mapear os dois antes de ligar qualquer agente.

Escalar o uso de IA da HubSpot sem métrica

O volume de atividade cresce com qualquer automação e não prova impacto, então defina antes o que vai medir, como tempo de resposta e conversão, e só expanda depois de um piloto com resultado.

Para a leitura estratégica do preparo, com casos de uso e métricas de sucesso, o post sobre agentes de IA e RevOps aprofunda o tema.

Leia mais: Agente de IA e RevOps: como estruturar uma operação AI First

Como a Aconcaia estrutura a ativação da IA com segurança?

A ativação segue três movimentos, e cada um só começa quando o anterior termina. O primeiro prepara a base, o segundo define acesso e limites e o terceiro liga a IA em um piloto, medindo antes de ampliar.

Base

Diagnóstico da conta, higienização de propriedades e duplicatas e alinhamento, entre marketing, vendas e atendimento, do que cada etapa da jornada significa, porque uma automação que parece quebrada muitas vezes só está seguindo uma regra que cada time entende de um jeito.

Acessos e limites

Quem pode ligar, o que a IA pode ler e o que ela pode fazer sozinha ou apenas com aprovação humana, com as decisões de maior impacto, como mudar o estágio de um negócio, sempre passando por uma pessoa.

Piloto

Um único fluxo, com critério de sucesso mensurável, ponto de revisão humana e plano de reversão definidos antes de ligar, e expansão apenas depois de o piloto provar resultado, o que reinicia o ciclo para a próxima área.

A ordem faz diferença porque maturidade em governança ainda é exceção. Só cerca de 30% das organizações chegam a um nível de maturidade três ou superior em estratégia, governança e controles de IA agêntica (McKinsey).

Aconcaia ativa IA pelo que ela vai ler, e não pelo que ela promete

Na Aconcaia, a primeira pergunta de um projeto de IA não é qual agente ligar, e sim o que esse agente vai ler e quem responde por isso.

A resposta decide se a IA da HubSpot vai amplificar uma operação organizada ou uma operação confusa, porque a tecnologia não corrige a base, ela multiplica o que encontra nela.

É por isso que o medo de ativar IA, quando bem ouvido, é um bom sinal, já que indica uma equipe que sabe que existe algo a organizar antes de ligar. O trabalho é transformar esse receio em uma lista de verificação, e não em um motivo para adiar.

O playbook Primeiros passos com a IA da HubSpot reúne o método completo da Aconcaia, em seis etapas, com os casos de uso e a sequência de ativação por área. Se preferir conversar sobre a sua conta, conheça a atuação da Aconcaia como agência parceira HubSpot.

Perguntas frequentes sobre como configurar a IA da HubSpot

Como configurar a IA da HubSpot?

A configuração começa nas configurações de IA da conta, com um Superadministrador ou Administrador parceiro, e segue quatro decisões em ordem, que são quem pode ligar os recursos, quais dados a IA pode ler, se a base está em condição de ser lida e onde testar antes da produção. Só depois disso faz sentido ativar o primeiro agente.

Quem pode configurar os recursos de IA na HubSpot?

Apenas usuários com a permissão de Superadministrador ou Administrador parceiro alteram as configurações de conta e de IA.

A IA da HubSpot acessa todos os dados da minha conta?

Depende de três chaves da conta, e por padrão os dados do CRM e as conversas com clientes já vêm ligados e os arquivos vêm desligados, mas um Superadministrador pode alterar cada uma na tela de IA, em Gerenciamento de conta.

A HubSpot usa os dados da minha conta para treinar modelos de IA?

Por padrão, a configuração de treinamento do modelo de IA vem ligada, e um Superadministrador pode desligá-la na tela de IA, em Gerenciamento de conta. Com ela desligada, os dados não treinam os modelos da HubSpot nem são compartilhados com outros clientes, e os recursos de IA continuam funcionando, enquanto contas com Dados confidenciais ativados já ficam de fora por padrão.

Ativar a IA da HubSpot consome créditos?

As configurações de conta e o Breeze Assistant não consomem créditos, mas agentes e projetos específicos, como o Prospecting Agent e o Customer Agent, podem consumir. Por isso o acesso a eles deveria ficar restrito a quem vai usá-los.

Dá para testar a IA da HubSpot sem usar dados reais?

Dá, e a HubSpot recomenda uma conta de teste de desenvolvedor, gratuita e separada da produção, e o ambiente sandbox das contas Enterprise, que copia a estrutura sem os dados.

Preciso limpar o CRM antes de ligar a IA?

Sim, pelo menos nos campos que a IA mais usa e nas duplicatas, porque dados incompletos geram respostas imprecisas. Na prática, uma limpeza completa não precisa vir antes, mas as propriedades críticas e a base de contatos e empresas precisam estar confiáveis.

Por onde começar com a IA na HubSpot?

Por um gargalo concreto do trabalho, e não por um recurso. A própria HubSpot orienta escolher um problema específico e doloroso, encontrar o caso de uso que o resolve, medir o resultado e só então expandir.