CRM e vendas
Conectar o HubSpot a um agente de IA autônomo
Um agente Atako conectado ao HubSpot pode ler e atualizar contatos, empresas, negócios e tickets, mas apenas os objetos e ações cobertos pelo seu grant.
Fluxos de trabalho possíveis
Enriquecimento e qualificação de leads recebidos
Assim que um contato chega ao CRM, o agente o recupera com get_contact, cruza a informação disponível, atualiza suas propriedades (update_contact), registra uma nota de qualificação (create_note) e cria uma tarefa de retomada para o vendedor responsável (create_task). O vendedor mantém o controle da ligação ou do e-mail, o agente só poupa a digitação e a pesquisa prévia que normalmente antecedem um primeiro contato útil, muitas vezes adiado por falta de tempo disponível no dia.
Retomada dos negócios parados no funil
O agente busca os negócios sem movimento há um certo número de dias (search_deals, list_pipelines para conhecer as etapas), cria uma tarefa de retomada para o responsável pelo negócio identificado via list_owners, e pode atualizar o status se uma regra clara justificar (update_deal). Nada é movido sem deixar um rastro consultável no CRM, o que evita funis inflados por negócios fantasmas que ninguém realmente retoma.
Criação de tickets de suporte vinculados a uma conta
A partir de um sinal recebido por e-mail ou Slack, o agente cria um ticket (create_ticket), associa-o ao contato e à empresa certos (create_association), e então acompanha seu andamento e o atualiza ao longo da conversa (update_ticket). O ticket continua visível e editável pela equipe de suporte como qualquer outro, com o histórico completo da conta já vinculado desde sua criação.
Ações do conector
get_contact (leitura)
Recupera um contato do CRM pelo identificador.
search_contacts (leitura)
Busca contatos por texto ou filtros de propriedades.
get_deal (leitura)
Recupera um negócio do CRM pelo identificador.
list_deals (leitura)
Lista os negócios do CRM, paginado.
list_pipelines (leitura)
Lista os funis e suas etapas (negócios ou tickets).
list_owners (leitura)
Lista os responsáveis do CRM, filtrável por e-mail.
create_contact (escrita)
Cria um contato no CRM.
update_contact (escrita)
Atualiza as propriedades de um contato.
create_deal (escrita)
Cria um negócio no CRM.
update_deal (escrita)
Atualiza um negócio (etapa, valor).
create_ticket (escrita)
Cria um ticket de suporte.
create_task (escrita)
Cria uma tarefa no CRM (retomada, ligação).
create_note (escrita)
Registra uma nota, a ser associada a um registro.
create_association (escrita)
Associa dois registros do CRM entre si.
Pré-requisitos
- Conta HubSpot com direito de super admin para criar uma private app.
- Criar uma private app em Settings, depois Integrations, depois Private Apps.
- Selecionar os escopos necessários (contacts, companies, deals, tickets, owners em leitura/escrita).
- Copiar o token de acesso exibido após a criação (prefixo pat-).
- No Atako, um direito de administração das integrações para conceder o grant ao agente.
Como conectar
- 1
Criar a private app do HubSpot
Em Settings, depois Integrations, depois Private Apps, criar uma app, nomeá-la, e então escolher seus escopos na aba dedicada.
- 2
Gerar e copiar o token
Depois que a app for criada, exibir e copiar o token de acesso (pat-...), exibido apenas uma vez.
- 3
Conectar o HubSpot no Atako
Em Configurações, depois Integrações, colar o token de acesso.
- 4
Conceder o grant ao agente
Na página do agente ou na conexão, selecionar as ações precisas autorizadas e seu escopo (somente leitura ou leitura e escrita).
Por que conectar um agente autônomo ao HubSpot
O HubSpot centraliza os contatos, os negócios e os tickets de uma equipe comercial ou de suporte. O trabalho repetitivo que vem junto, enriquecer um cadastro, retomar um negócio parado, criar uma tarefa de acompanhamento, geralmente acontece de forma esporádica, quando alguém se lembra. Um agente Atako conectado ao HubSpot via tool calling faz esse trabalho continuamente, em seu próprio ambiente, sem esperar que um vendedor abra sua lista de tarefas da manhã.
A diferença em relação a um cenário de automação clássico: o agente roda permanentemente e toma uma decisão, não apenas uma ação isolada. Ele pode receber um sinal por e-mail ou Slack, buscar o contato ou negócio correspondente no HubSpot, decidir se é preciso criar uma tarefa ou atualizar uma propriedade, e então fazer isso, dentro exatamente das ações que lhe foram concedidas.
O conector do HubSpot cobre 37 ações segundo a documentação do Atako (17 de leitura, 20 de escrita), da busca de contatos à criação de propriedades personalizadas. O caso de uso de produto mais direto: um agente de automação de RevOps que monitora o funil, enriquece os leads e sinaliza anomalias de dados sem intervenção manual constante.
Limites e boas práticas
A API do HubSpot impõe limites de taxa que variam conforme a assinatura HubSpot da empresa (número de requisições por intervalo de dez segundos, e por dia), com limites ainda mais estritos nos endpoints de busca. Um agente que processa um grande volume de contatos deve, portanto, distribuir suas chamadas em vez de fazer tudo de uma vez.
Algumas ações de escrita, como delete_contact ou delete_deal, são irreversíveis do lado do HubSpot uma vez executadas. Elas só ficam disponíveis se o grant do agente as autorizar explicitamente, o que continua raro na prática para esse tipo de ação.
Como em qualquer integração Atako, a conexão sozinha não dá nenhum acesso: é preciso um grant preciso (agente, ação, escopo). Veja o modelo de permissões e os planos para definir esse escopo antes de conectar o agente ao seu CRM.
Casos de uso relacionados
Integrações relacionadas
Perguntas frequentes
O agente pode enviar e-mails de marketing pelo HubSpot?
Ele pode criar um rascunho de e-mail de marketing (create_marketing_email) se esse escopo for concedido, mas nada sai sem uma ação de envio validada pela sua equipe: o conector não conta com nenhuma ação de envio direto de e-mail de marketing.
É preciso um plano HubSpot pago para conectar a API?
A API e as private apps estão disponíveis já no plano gratuito do HubSpot para os objetos padrão. Alguns escopos avançados, como a criação de propriedades personalizadas, podem depender do nível de plano contratado.
Como revogar o acesso do agente ao HubSpot?
Exclua ou desative a private app do lado do HubSpot, ou revogue a conexão no Atako. O acesso é cortado imediata e definitivamente para todos os agentes que a usavam.
O agente pode excluir contatos do CRM?
Sim, a ação delete_contact existe, mas só se o grant do agente autorizar explicitamente com o escopo de escrita. Por padrão, nenhuma ação é concedida: é você quem decide se a exclusão faz parte do escopo do agente.
O que ler a seguir
Fontes
- HubSpot Developer Docs, Private apps · acessado em 4 de setembro de 2026
- HubSpot Developer Docs, API usage guidelines and limits · acessado em 4 de setembro de 2026
CTO da Atako
Este conteúdo foi redigido pelos agentes de IA da Atako, depois revisado, corrigido e validado por Romain Laodicina, CTO da Atako.