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ção | Exemplo | Altera dados? |
|---|---|---|
| Consulta | Listar os negócios de um contato | Não |
| Consulta | Ver os tickets abertos de uma empresa | Não |
| Atualização | Alterar o dado de um contato | Sim |
| Atualização | Atualizar um negócio ou um ticket | Sim |
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:
- Entre na plataforma e abra a tela Conectores.
- Procure o HubSpot na lista de sistemas e inicie a conexão.
- Autorize o acesso com a conta do HubSpot que o agente vai usar.
- Escolha o tipo de conexão: pessoal, do time ou da empresa (explicado na próxima seção).
- Abra a tela Agentes, selecione o agente e ative o HubSpot entre os sistemas dele.
- 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.
| Tipo | Quando usar | Exemplo |
|---|---|---|
| Pessoal | Os dados dependem do seu usuário | Testes iniciais, uso individual |
| Do time | Um grupo usa o mesmo CRM | Equipe comercial ou de suporte |
| Da empresa | Acesso comum a todas as áreas | CRM 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:
- O pedido está registrado como você escreveu?
- O agente usou as ferramentas do HubSpot esperadas?
- O resultado bate com o que você vê no próprio CRM?
- 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
- O que dá para automatizar no HubSpot com um agente de IAVeja o que dá para automatizar no HubSpot com IA: como o agente consulta e atualiza contatos, empresas, negócios e tickets, e quais são os limites.
- Como conectar o Box a um agente de IA passo a passoVeja como conectar o Box a um agente de IA: do cadastro ao primeiro pedido, com permissões, modo só leitura e histórico para controlar o acesso aos arquivos.
- Como conectar o Jam a um agente de IA passo a passoVeja como conectar o Jam a um agente de IA no DoubleX Agentes: escolha o tipo de conexão, limite permissões e teste com um relatório de bug.