BetaUsar a CLI do agente do HubSpot

A CLI do Agente do HubSpot conecta agentes de codificação de IA, como Claude Code, Claude Cowork e OpenAI Codex, à 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 nossa documentação para desenvolvedores.

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 Claude Code, Claude Cowork, OpenAI Codex 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.

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.
• 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.
• 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 prompts claros 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.

1. Abra seu agente de IA, como Cowork ou Codex.
2. 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.

3. Quando solicitado, faça login na sua conta da HubSpot.
4. Revise as permissões solicitadas.
5. 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.

Para começar, use um dos exemplos de prompts abaixo.

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. O agente é especialmente útil para trabalhos operacionais recorrentes que exigem a revisão de grandes quantidades de dados do CRM.

Equipes de marketing

Tarefa: identifique contatos que precisam de acompanhamento ou limpeza de dados.

Exemplo de prompt para o agente de IA: 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.

Exemplos adicionais incluem:

• 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.
• Identifique padrões de mensagens em landing pages de alto desempenho que se correlacionam com taxas de conversão mais fortes.
• Crie uma lista de novos envolvimentos de contatos que não abriram e-mails em uma sequência de criação.
• Acompanhe o status atual do pipeline dos negócios provenientes de um webinar campanha.
• Identifique o setor, o tamanho da empresa e os padrões de fonte de leads entre os clientes mais adequados.
• Monitore sequências ativas e sinalize quedas significativas nas taxas de abertura de e-mail.

Equipes de operações de vendas e receita

Tarefa: monitore a integridade do pipeline e identifique os negócios que precisam de atenção.

Exemplo de prompt para o agente de IA: Todas as manhãs, às 7h, verifique meu pipeline quanto a negócios fechados esta semana sem atividade nos últimos 5 dias e envie-me um resumo.

Exemplos adicionais incluem:

• Encontre negócios inativos de alto valor que exigem acompanhamento e revisão.
• Prepare-se para uma agendador de reuniões com um cliente resumindo o histórico de negócios, suporte, e-mail e notas.
• Analise negócios adiados para identificar os estágios do pipeline em que as Oportunidade ficaram paradas por mais tempo.
• Gere um resumo diário dos negócios que se aproximam das datas de fechamento, mas não têm atividade recente.

Líderes de vendas

Tarefa: analise transcrições de chamadas para temas de coaching e feedback do produto.

Exemplo de prompt para o agente de IA: 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.

Exemplos adicionais incluem:

• Identifique representantes ou equipes com padrões de tempo de conversação excepcionalmente altos ou baixos.
• Encontre menções recorrentes de concorrentes em chamadas de vendas recentes.
• Resuma os temas de hesitação do prospect por segmento, fase do negócio ou área do produto.
• Obtenha exemplos de transcrições que apoiem temas de coaching ou feedback do produto.
• Crie um painel que vincule os insights da chamada aos registros e transcrições de origem.

Administradores de RevOps e CRM

Tarefa: limpar as propriedades do CRM sem quebrar os ativos downstream.

Exemplo de prompt para o agente de IA: Encontre propriedades duplicadas ou obsoletas do CRM, 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.

Exemplos adicionais incluem:

• Identifique propriedades duplicadas que coletam as mesmas informações em objetos diferentes.
• Encontre campos obsoletos que ainda aparecem em fluxos de trabalho, relatórios, exibições ou layouts de registros.
• Visualize o impacto de remover ou substituir um CRM propriedade antes de fazer alterações.
• Reordene os campos de registro para que administradores e representantes vejam primeiro as informações mais importantes.
• Gere um resumo de limpeza que mostre o que mudou e o que ainda precisa ser revisado.

Equipes de operações

Tarefa: consolidar tickets de suporte relacionados e preservar o histórico de limpeza.

Exemplo de prompt para o agente de IA: 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.

Exemplos adicionais incluem:

• Encontre tickets de suporte duplicados ou relacionados no mesmo cliente ou tipo de problema.
• Mescle o contexto do ticket em um registro principal, preservando os detalhes da fonte.
• Encaminhe tickets consolidados para a fase correta do pipeline com base no status atual.
• Sinalize os tíquetes que precisam de revisão humana antes da consolidação.
• Envie um resumo de limpeza com registros mesclados, perguntas em aberto e proprietários de acompanhamento.

Equipes de suporte

Tarefa: revise o histórico do cliente sem abrir manualmente vários registros.

Exemplo de prompt para o agente de IA: Extraia os últimos 5 tíquetes deste contato, resuma cada resolução e sinalize todos os padrões de problemas recorrentes.

Exemplos adicionais incluem:

• Revise o histórico recente de tickets e identifique problemas recorrentes do cliente antes de abrir um novo caso.
• Priorize os tickets que excederam as expectativas de tempo de resposta.
• Analise os tickets relacionados a cobrança para identificar os motivos mais comuns para os clientes entrarem em contato com o suporte.
• Prepare respostas de ticket com histórico relevante de negócios, assinaturas e escalonamentos.

Equipes de sucesso do cliente

Tarefa: prepare revisões de conta usando informações de várias ferramentas da HubSpot.

Exemplo de prompt para o agente de IA: 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 meu catálogo de negócios.

Exemplos adicionais incluem:

• Identifique contas de clientes com indicadores de elevado risco de taxa de cancelamento de clientes.
• Encontre contatos de renovação com baixo engajamento do produto para alcance proativo.
• Prepare as revisões da conta resumindo as atividades recentes de vendas, suporte e feedback do cliente.
• Identifique Oportunidades de expansão comparando as tendências de crescimento da conta com o tamanho histórico do negócio.

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 habilidades no Claude e no OpenAI Codex.

Gerenciar o acesso à CLI do agente do HubSpot

Os Superadministradores podem gerenciar quem tem permissão para conectar a CLI do HubSpot Agent optando pela versão beta da Governança de instalação de aplicativos .

Se um usuário não tiver permissão para conectar a CLI do Agente da HubSpot, ele deverá solicitar aprovação de um administrador antes de conectá-la.

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