Isenção de responsabilidade de tradução: esse conteúdo foi traduzido para sua conveniência com o uso de software e pode não ter sido revisado por uma pessoa.

Usar a CLI do agente do HubSpot

Ultima atualização: 29 de setembro de 2026

Disponível com qualquer uma das seguintes assinaturas, salvo menção ao contrário:

Todos os produtos e planos

A CLI do Agente do HubSpot conecta agentes de codificação de IA, como os do aplicativo ChatGPT, do aplicativo Claude e do Claude Code , à sua conta da HubSpot. Depois de conectar a CLI do agente ao HubSpot, você pode pedir a um agente de IA para concluir tarefas repetitivas do CRM, analisar dados, gerar resumos e ajudar a gerenciar processos em sua conta. Quando você delega tarefas a agentes de IA, eles podem usar a CLI do agente para automatizar o trabalho de rotina em seu nome, ajudando sua equipe a dedicar mais tempo a iniciativas estratégicas.

Por exemplo, em vez de revisar manualmente os registros a cada semana, você pode pedir a um agente de IA para identificar registros incompletos, resumir as atividades do pipeline ou preparar revisões de conta usando informações do HubSpot.

Se você é um desenvolvedor que deseja escrever scripts personalizados ou usar a CLI do agente do HubSpot manualmente no seu terminal, consulte a documentação para desenvolvedores da HubSpot.

Antes de começar

Antes de começar a usar a CLI do agente da HubSpot, verifique se você tem acesso a um agente de codificação de IA. Os agentes suportados incluem aqueles no aplicativo ChatGPT, aplicativo Claude, Claude Code e muitos outros agentes de codificação de IA compatíveis.

Observação: se você estiver usando o Claude Cowork em uma conta do Team ou Enterprise, o administrador da sua organização pode precisar colocar api.hubapi.com na lista de permissões para que a CLI possa ser instalada ou executada. Saiba mais sobre a lista de permissões no Claude Cowork.

Quando usar a CLI do agente da HubSpot

A CLI do agente é útil para trabalhos operacionais repetitivos ou recorrentes que exigem a revisão de grandes quantidades de dados do CRM. Isso inclui tarefas como executar uma revisão semanal do pipeline, atualizar registros em massa ou enviar resumos programados para sua equipe após um agendador de reuniões mensal recorrente. Veja mais exemplos de casos de uso.

Se você quiser fazer perguntas pontuais ou redigir conteúdo usando seus dados do HubSpot, o conector HubSpot para Claude ou o conector HubSpot para ChatGPT são opções que não exigem instalação CLI.

O que os agentes de IA podem acessar com a CLI do agente da HubSpot

A CLI do Agente do HubSpot pode executar ações usando as permissões do usuário conectado do HubSpot. Dependendo das suas permissões de usuário, isso pode incluir criar, atualizar ou excluir registros na sua conta.

Depois de conectar a CLI do agente da HubSpot, os agentes de IA podem trabalhar com informações em sua conta da HubSpot, incluindo:

Contatos, empresas, negócios, tickets, objetos personalizados e outros registros do CRM.
Fluxos de trabalho.
Pipelines e fases de pipeline.
Propriedades e propriedades personalizadas.
Registros de receita (somente leitura): contratos, faturas, pedidos, pagamentos, orçamentos, modelos de orçamento e assinaturas (BETA).
Associações entre registros.
Histórico de atividades.

Observação: sempre revise as recomendações e ações propostas geradas pela IA antes de aplicar as alterações nos dados do CRM.

Práticas recomendadas

Ao trabalhar com agentes de IA conectados ao HubSpot:

Comece com relatórios, resumos e tarefas de análise antes de usar ações que modificam dados.
Ao configurar tarefas programadas ou recorrentes, comece com um único caso de uso restrito antes de expandir para uma automação mais ampla.
Revise as recomendações geradas e as atualizações em grande escala antes de aplicar as alterações.
Algumas ações podem excluir ou substituir dados do HubSpot. Quando disponível, use a opção --dry-run para visualizar as alterações antes de aplicá-las.
Use instruções claras e específicas que descrevam o resultado desejado.
Siga as políticas de governança e segurança de dados da sua organização.

Conectar a CLI do agente do HubSpot

Siga as etapas abaixo para instruir seu agente a instalar a CLI do HubSpot Agent. Se você for um desenvolvedor, saiba mais sobre como instalar o HubSpot Agent CLI manualmente.

Abra seu agente de IA.
Cole o prompt a seguir no espaço de trabalho do agente para instalar a CLI do agente.

Install the HubSpot Agent CLI in this agent workspace. If this workspace uses a POSIX shell (macOS, Linux, WSL, or Bash), run `curl -fsSL https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.sh | sh`. If it uses Windows PowerShell, run `irm https://api.hubapi.com/hub/cli/backend/hub-cli/latest/install.ps1 | iex`. Then authenticate with `hubspot auth login`, install HubSpot Agent CLI Skills with `npx skills add hubspot/agent-cli-skills`, and use `hubspot --help` to explore what's available.

Quando solicitado, faça login na sua conta da HubSpot.
Revise as permissões solicitadas.
Clique Conectar aplicativo.

Após a conclusão da autenticação, o agente de IA poderá acessar os dados do HubSpot com base nas suas permissões.

Exemplo de casos de uso

Os exemplos a seguir mostram como diferentes equipes podem usar agentes de IA conectados por meio da CLI do Agente da HubSpot.

Equipes de marketing

Tarefa	Exemplo de prompt para o agente de IA
Identifique os contatos que precisam de acompanhamento ou limpeza de dados.	Todas as segundas-feiras, às 8h, encontre contatos de alta adequação sem nenhum negócio associado, sem atividade de vendas recente ou com campos de enriquecimento importantes ausentes e envie ao RevOps uma lista de limpeza priorizada com as próximas ações sugeridas.
Revise as campanhas de e-mail quanto a linhas de assunto e CTAs que não se alinham com as diretrizes de tom de voz.	Revisar minhas últimas 10 campanhas de e-mail e sinalizar linhas de assunto ou CTAs que não seguem nossas diretrizes de tom de voz. Liste cada problema com o nome da campanha, a cópia sinalizada e uma revisão sugerida.
Identifique padrões de mensagens em landing pages de alto desempenho que se correlacionam com taxas de conversão mais fortes.	Analisar minhas landing pages com melhor desempenho por taxa de conversão. Identifique padrões comuns de mensagens, como estrutura do título, frase da CTA ou tipo de oferta, e resuma o que eles têm em comum.
Crie uma lista de novos envolvimentos de contatos que não abriram e-mails em uma sequência de criação.	Encontre todos os contatos atualmente inscritos em uma sequência de nutrição que não abriram nenhum e-mail nos últimos 30 dias. Crie um segmento com seu nome, empresa, fase do ciclo de vida e data da última atividade.
Acompanhe o status atual do pipeline dos negócios provenientes de um webinar campanha.	Encontre todos os negócios com uma origem de lead de webinar e mostre a fase atual do pipeline, o proprietário, o valor e a data da última atividade. Resuma quantos estão ativos, parados ou fechados.
Identifique o setor, o tamanho da empresa e os padrões de fonte de leads entre os clientes mais adequados.	Veja meus negócios fechados e ganhos dos últimos 12 meses e resuma as combinações mais comuns de setor, tamanho da empresa e fonte de leads. Destaque quaisquer padrões que possam ajudar a refinar nosso perfil de cliente ideal.
Monitore sequências ativas e sinalize quedas significativas nas taxas de abertura de e-mail.	Verifique todas as sequências ativas e compare as taxas de abertura das últimas duas semanas com as duas semanas anteriores. Sinalize todas as sequências em que as taxas de abertura tenham caído mais de 20% e inclua o nome da sequência, a taxa atual e a taxa anterior.

Equipes de operações de vendas e receita

Tarefa	Exemplo de prompt para o agente de IA
Monitore a integridade do pipeline e identifique os negócios que precisam de atenção.	Todas as manhãs às 7h, verifique meu pipeline para ver se há negócios fechando essa semana sem atividade nos últimos 5 dias e me envie um resumo.
Encontre negócios inativos de alto valor que exigem acompanhamento e revisão.	Encontre todos os negócios abertos acima de $[valor] sem atividade nos últimos 14 dias. Classifique por valor do negócio e inclua o nome do negócio, o proprietário, a data de fechamento e a última atividade.
Prepare-se para uma agendador de reuniões com um cliente resumindo o histórico de negócios, suporte, e-mail e notas.	Tenho um agendador de reuniões com a [Empresa] amanhã. Resuma os negócios abertos e recentes fechados, os últimos 5 tickets de suporte, a atividade recente de e-mail e as observações registradas nos últimos 60 dias.
Analise negócios adiados para identificar os estágios do pipeline em que as Oportunidade ficaram paradas por mais tempo.	Veja os negócios que perderam a data de fechamento no último trimestre. Para cada um, mostre em qual fase do pipeline eles passaram mais tempo e identifique as duas ou três fases em que os negócios geralmente param.
Gere um resumo diário dos negócios que se aproximam das datas de fechamento, mas não têm atividade recente.	Todos os dias, às 8h, encontre negócios fechando nos próximos 7 dias sem nenhuma atividade nos últimos 3 dias. Envie-me um resumo com o nome do negócio, o proprietário, o valor, a data de fechamento e o último tipo de atividade.

Líderes de vendas

Tarefa	Exemplo de prompt para o agente de IA
Analise as transcrições das chamadas para temas de coaching e feedback do produto.	Analise transcrições de chamadas recentes para tempo de conversa, menções de concorrentes, feedback de clientes e temas de hesitação de prospects e, em seguida, crie um painel de treinamento e feedback do produto com exemplos de transcrições e links para as chamadas de origem.
Identifique representantes ou equipes com padrões de tempo de conversação excepcionalmente altos ou baixos.	Analise as transcrições das chamadas dos últimos 30 dias e calcule a relação média de tempo de conversação por representante. Sinalize qualquer pessoa com uma proporção acima de 70% ou abaixo de 30% e inclua um trecho de amostra da transcrição para cada um.
Encontre menções recorrentes de concorrentes em chamadas de vendas recentes.	Revise as transcrições das chamadas dos últimos 60 dias e identifique os concorrentes mencionados com mais frequência. Para cada uma, mostre quantas chamadas incluíram uma menção, em quais fases do negócio elas surgiram e um exemplo de orçamento.
Resuma os temas de hesitação do prospect por segmento, fase do negócio ou área do produto.	Verifique transcrições de chamadas recentes em busca de texto que indique hesitação ou objeções do prospect. Agrupe os temas por fase do negócio e segmento de prospect e resuma os 5 principais padrões de hesitação com exemplos de orçamentos.
Obtenha exemplos de transcrições que apoiem temas de coaching ou feedback do produto.	Nas transcrições das chamadas nos últimos 30 dias, encontre de três a cinco exemplos de perguntas de descoberta fortes e de três a cinco exemplos de momentos perdidos de tratamento de objeções. Inclua o nome do representante, a data de atendimento e um orçamento direto de cada um.
Crie um painel que vincule os insights da chamada aos registros e transcrições de origem.	Crie um painel de coaching resumindo as proporções de tempo de conversa, menções de concorrentes e temas de objeção de chamadas nos últimos 30 dias. Para cada insight, inclua um link para a chamada de origem e o registro de negócio associado.

Administradores de RevOps e CRM

Tarefa	Exemplo de prompt para o agente de IA
Limpe as propriedades do CRM sem quebrar os ativos downstream.	Encontre propriedades de CRM duplicadas ou obsoletas, mostre onde elas são usadas em fluxos de trabalho, relatórios e exibições. Em seguida, visualize um plano de limpeza para substituir, remover ou reordenar os campos antes de aplicar as alterações.
Identifique propriedades duplicadas que coletam as mesmas informações em objetos diferentes.	Analise todas as propriedades de contato, empresa e negócio e sinalize aquelas que pareçam coletar as mesmas informações com nomes diferentes. Liste os nomes dos propriedade, seus objetos e uma ação sugerida para cada par duplicado.
Encontre campos obsoletos que ainda aparecem em fluxos de trabalho, relatórios, exibições ou layouts de registros.	Encontre todas as propriedades do CRM que não foram atualizadas nos últimos 12 meses, mas ainda aparecem em fluxos de trabalho ativos, relatórios salvos, exibições de lista ou layouts de cartão de registro. Mostre onde cada um é usado antes de qualquer alteração ser feita.
Visualize o impacto de remover ou substituir um CRM propriedade antes de fazer alterações.	Quero remover a propriedade [Nome da Propriedade]. Antes de fazer alterações, mostre-me todos os layouts de fluxo de trabalho, relatório, lista e registro que os utilizam e visualize o que estaria quebrado ou precisaria ser atualizado.
Reordene os campos de registro para que administradores e representantes vejam primeiro as informações mais importantes.	Para o layout de registro de registro do contato, mova esses campos para a parte superior da barra lateral de propriedades: [Campo 1], [Campo 2], [Campo 3]. Visualize antes de aplicar as alterações.
Gere um resumo de limpeza que mostre o que mudou e o que ainda precisa ser revisado.	Depois de concluir a limpeza CRM propriedade, gere um resumo de cada propriedade que foi removido, substituído ou renomeado, quais ativos foram atualizados e uma lista de todos os campos que ainda precisam de revisão manual.

Equipes de operações

Tarefa	Exemplo de prompt para o agente de IA
Consolide tickets de suporte relacionados e preserve o histórico de limpeza.	Consolide tickets de suporte duplicados, preserve os detalhes do ticket de origem, encaminhe cada ticket principal para a fase correta do pipeline e envie à equipe um resumo de limpeza com todos os registros que ainda precisam de revisão.
Encontre tickets de suporte duplicados ou relacionados no mesmo cliente ou tipo de problema.	Encontre todos os tickets de suporte abertos da mesma empresa que foram criados com 30 dias de diferença. Agrupe-os por empresa e tipo de problema e marque aqueles que pareçam ser duplicados.
Mescle o contexto do ticket em um registro principal, preservando os detalhes da fonte.	Para os tickets duplicados identificados acima, mescle a descrição, o histórico de contatos e as observações de cada ticket de origem nas notas do registro principal antes de fechar os duplicados.
Encaminhe tickets consolidados para a fase correta do pipeline com base no status atual.	Para cada ticket principal consolidado, verifique seu status atual e mova-o para a fase correta do pipeline: problemas abertos para Em andamento, tickets aguardando uma resposta para Aguardando o cliente e problemas resolvidos para Fechados.
Sinalize os tíquetes que precisam de revisão humana antes da consolidação.	Antes de consolidar qualquer ticket, sinalize os registros que têm uma disputa de pagamento aberta, um relógio de SLA ativo ou uma observação marcada como encaminhamento. Não os mescle. Liste-os para revisão manual.
Envie um resumo de limpeza com registros mesclados, perguntas em aberto e proprietários de acompanhamento.	Após ticket consolidação for concluída, envie à equipe de suporte lead um resumo listando todos os ticket principais criados, quais tickets de origem foram mesclados neles, todas as perguntas em aberto que precisam de acompanhamento e quem é o responsável por cada próxima etapa.

Equipes de suporte

Tarefa	Exemplo de prompt para o agente de IA
Revise o histórico do cliente sem abrir manualmente vários registros.	Extraia os últimos 5 tíquetes deste contato, resuma cada resolução e sinalize todos os padrões de problemas recorrentes.
Revise o histórico recente de tickets e identifique problemas recorrentes do cliente antes de abrir um novo caso.	Antes de criar um novo ticket para [Contato], extraia seus últimos 10 tickets, resuma cada resolução e sinalize todos os problemas que aparecem mais de uma vez. Inclua o assunto, o status e a data de resolução do ticket.
Priorize os tickets que excederam as expectativas de tempo de resposta.	Encontre todos os tickets abertos que não receberam uma resposta dentro da janela de SLA esperada. Classifique-os por atraso e inclua o ticket proprietário, nome do contato e data da última atividade.
Analise os tickets relacionados a cobrança para identificar os motivos mais comuns para os clientes entrarem em contato com o suporte.	Revise todos os tickets marcados com uma categoria relacionada a cobrança nos últimos 90 dias. Resuma os 5 principais motivos pelos quais os clientes entraram em contato com o suporte, classificados por volume, e inclua o tempo médio de resolução de cada um.
Prepare respostas de ticket com histórico relevante de negócios, assinaturas e escalonamentos.	Para o ticket [Ticket ID], extraia o histórico de negócios associado do contato, os detalhes da assinatura atual e todas as observações de escalonamento anteriores. Resuma o contexto e esboce uma resposta que aborde o problema do cliente.

Equipes de sucesso do cliente

Tarefa	Exemplo de prompt para o agente de IA
Prepare revisões de conta usando informações de várias ferramentas da HubSpot.	Para a revisão da minha conta esta semana, resuma os negócios abertos, as atividades de suporte recentes e a última pontuação de NPS de cada conta em minha carteira de negócios.
Identifique contas de clientes com indicadores de elevado risco de taxa de cancelamento de clientes.	Revise contas em meu livro de negócios e sinalize qualquer uma com dois ou mais destes sinais: declínio na frequência de login do produto, abertura de tickets de suporte com mais de 14 dias, pontuação de NPS abaixo de 7 ou ausência de atividade do Gerente de sucesso do cliente nos últimos 30 dias. Classifique-os por nível de risco.
Encontre contatos de renovação com baixo engajamento do produto para alcance proativo.	Encontre todos os contatos nas contas com renovação nos próximos 60 dias que não fizeram login no produto nos últimos 21 dias. Crie uma lista de divulgação priorizada com o nome do contato, conta, data de renovação e data do último login.
Prepare as revisões da conta resumindo as atividades recentes de vendas, suporte e feedback do cliente.	Para [Nome da conta], resuma todas as atividades de negócio dos últimos 6 meses, tickets de suporte abertos e fechados recentemente e todas as respostas de NPS ou CSAT. Formate isso como um resumo pré-QBR que posso compartilhar com a equipe da conta.
Identifique Oportunidades de expansão comparando as tendências de crescimento da conta com o tamanho histórico do negócio.	Veja as contas do meu catálogo de negócios que cresceram em número de funcionários ou receita no ano passado. Compare o tamanho atual do negócio com o que contas semelhantes expandiram e marque as 10 principais como possíveis Oportunidades de expansão.

Mantenha a biblioteca de habilidades atualizada

As competências da CLI do HubSpot Agent fornecem orientações predefinidas que ajudam os agentes de IA a trabalhar com os dados do HubSpot e com os processos habituais do HubSpot. A biblioteca de competências inclui orientações para pesquisas no CRM, operações em massa, tarefas relacionadas com a qualidade dos dados, fluxos de trabalho, elaboração de relatórios e outras atividades operacionais.

Você pode revisar as habilidades que serão instaladas no repositório público do GitHub.

Para atualizar a biblioteca de habilidades no espaço de trabalho do agente de IA, execute o seguinte prompt:

npx skills update

Saiba mais sobre como usar as habilidades no Claude e no ChatGPT.

Gerenciar o acesso à CLI do agente do HubSpot

Os Superadministradores podem gerenciar quem tem permissão para conectar a CLI do agente da HubSpot. Se um usuário não tiver permissão para conectar a CLI do Agente da HubSpot, ele deverá solicitar a aprovação de um Superadministrador antes de conectá-la.

Saiba mais sobre como gerenciar quais aplicativos podem ser instalados na sua conta da HubSpot.

Esse artigo foi útil?

Este formulário deve ser usado apenas para fazer comentários sobre esses artigos. Saiba como obter ajuda para usar a HubSpot.