Como conectar o HubSpot a um agente de IA passo a passo

· DoubleX

Resposta rápida

Para conectar o HubSpot a um agente de IA, ligue o conector HubSpot na tela Conectores, escolha se a conexão é pessoal, do time ou da empresa, libere só as ações necessárias para cada agente e faça um pedido de teste. No DoubleX Agentes, o histórico da tarefa mostra o que foi feito.

Conectar o CRM a um agente de IA é um trabalho de duas partes: ligar a conta e decidir o que o agente pode fazer nela. Este guia cobre só essa parte técnica e de permissões, do acesso ao primeiro teste. Para ideias de uso em vendas, veja o guia sobre o que dá para automatizar no HubSpot com um agente de IA.

O que o agente de IA consegue fazer no HubSpot?#

Com o conector do HubSpot, o agente consulta e atualiza contatos, empresas, negócios e tickets do CRM. Ele trabalha dentro do HubSpot que sua empresa já usa, sem substituí-lo.

Na prática, isso se divide em dois tipos de ação:

Tipo de açãoExemploAltera dados?
ConsultaListar os negócios de um contatoNão
ConsultaVer os tickets abertos de uma empresaNão
AtualizaçãoAlterar o dado de um contatoSim
AtualizaçãoAtualizar um negócio ou um ticketSim

Essa separação importa, porque é ela que você controla na etapa de permissões.

O que preciso ter antes de conectar?#

Você precisa de uma conta no DoubleX Agentes, de acesso à sua conta do HubSpot e de pelo menos um agente criado. Criar a conta é grátis e não exige cartão.

Antes de começar, confira:

  • Acesso ao HubSpot: a conta usada na conexão deve enxergar os contatos, empresas, negócios e tickets que o agente vai consultar. Se o seu usuário não vê um dado, o agente também não deveria ver.
  • Um agente: pode ser criado do zero na tela Agentes ou vir do diagnóstico, uma conversa de 5 a 10 minutos que monta uma equipe de agentes com as instruções da empresa.
  • Uma decisão sobre o escopo: quem vai usar a conexão e se o agente só lê ou também altera.

Como conectar o HubSpot na tela Conectores?#

Você conecta o HubSpot na tela Conectores, escolhendo o HubSpot na lista e autorizando o acesso à sua conta. Depois disso, o agente passa a poder usar as ferramentas dele.

Passo a passo no DoubleX Agentes:

  1. Entre na plataforma e abra a tela Conectores.
  2. Procure o HubSpot na lista de sistemas e inicie a conexão.
  3. Autorize o acesso com a conta do HubSpot que o agente vai usar.
  4. Escolha o tipo de conexão: pessoal, do time ou da empresa (explicado na próxima seção).
  5. Abra a tela Agentes, selecione o agente e ative o HubSpot entre os sistemas dele.
  6. Defina as ações permitidas e faça o primeiro teste.

As credenciais da conexão ficam criptografadas com AES-256-GCM. Quem desenvolve também pode gerenciar conectores pela API de Conectores.

A conexão deve ser pessoal, do time ou da empresa?#

Use conexão pessoal quando o acesso vale só para você, do time quando um grupo compartilha o mesmo HubSpot e da empresa quando todos precisam do mesmo acesso. A escolha define quem se beneficia da conexão.

TipoQuando usarExemplo
PessoalOs dados dependem do seu usuárioTestes iniciais, uso individual
Do timeUm grupo usa o mesmo CRMEquipe comercial ou de suporte
Da empresaAcesso comum a todas as áreasCRM usado por toda a empresa

Lembre também que uma rotina agendada roda com as permissões de quem a criou. Por isso, quem cria a rotina deve ter só o acesso de que ela precisa.

Como limitar o agente a somente leitura ou liberar alterações?#

Para cada agente, você escolhe quais sistemas ele usa e, dentro do HubSpot, quais ações ele pode executar. Para deixar o agente só em consulta, mantenha desligadas as ações que alteram dados.

Uma sequência segura é:

  • Fase 1, somente leitura: o agente consulta contatos, negócios e tickets, e você valida se as respostas estão corretas.
  • Fase 2, alterações pontuais: libere só a ação de que o agente precisa, como atualizar um campo de negócio.
  • Fase 3, uso rotineiro: mantenha as permissões mínimas e revise de tempos em tempos.

Mesmo com alterações liberadas, antes de enviar, apagar ou alterar algo nos sistemas o agente pede confirmação e mostra o passo a passo do que fez.

Como testar com um primeiro pedido e conferir o histórico da tarefa?#

Faça um pedido simples de consulta e depois abra a tarefa na tela Tarefas. Ali você vê o pedido, cada ferramenta do HubSpot que o agente usou e o resultado.

Exemplos de pedidos para o primeiro teste:

  • "Liste os 5 negócios mais recentes do HubSpot e mostre a etapa de cada um."
  • "Busque o contato com este e-mail e me diga a empresa associada."
  • "Mostre os tickets abertos da empresa Exemplo Ltda."
  • "Quais negócios estão sem atualização há mais tempo? Só consulte, não altere nada."

Depois do pedido, confira no histórico:

  1. O pedido está registrado como você escreveu?
  2. O agente usou as ferramentas do HubSpot esperadas?
  3. O resultado bate com o que você vê no próprio CRM?
  4. Alguma ação de alteração foi pedida e exigiu confirmação?

Se tudo estiver certo, siga para os exemplos de pedidos para o agente de IA no HubSpot ou monte rotinas com agente de IA no HubSpot e outros sistemas. Para o básico da plataforma, veja o início rápido.

Perguntas frequentes#

Preciso programar para conectar o HubSpot?#

Não. A conexão é feita pela tela Conectores e o agente é configurado descrevendo o que você precisa com as próprias palavras. A API, a CLI e o servidor MCP existem para quem quiser ir além.

O agente pode alterar dados do HubSpot sem eu saber?#

Só se você liberar ações de alteração, e mesmo assim o agente pede confirmação antes de alterar algo e mostra o que fez. Tudo fica registrado no histórico da tarefa.

Posso ter agentes diferentes com permissões diferentes no HubSpot?#

Sim. Para cada agente você escolhe os sistemas e as ações permitidas. Um agente pode só consultar, enquanto outro pode atualizar negócios.

Meus dados do CRM treinam modelos de IA?#

Não. O conteúdo da empresa não é usado para treinar modelos, e os pedidos só vão para provedores que não usam o que recebem para treinamento. Há ainda a opção de retenção zero na tela Modelos.

Quanto custa conectar o HubSpot?#

Criar a conta e fazer o primeiro diagnóstico é grátis, sem cartão. O uso da IA consome créditos, e os planos começam em US$ 19 por mês com 300 créditos.

Guias relacionados

Mais guias de HubSpot