BetaUtiliza la CLI de HubSpot Agent

La CLI de HubSpot Agent conecta agentes de programación basados en IA, como Claude Code, Claude Cowork y OpenAI Codex, a tu cuenta de HubSpot. Una vez conectada la CLI de Agent a HubSpot, puedes pedirle a un agente de IA que realice tareas repetitivas de CRM, analice datos, genere resúmenes y te ayude a gestionar los procesos de tu cuenta. Cuando delegas tareas a agentes de IA, estos pueden utilizar la CLI de agente para automatizar el trabajo rutinario en tu nombre, lo que ayuda a tu equipo a dedicar más tiempo a iniciativas estratégicas.

Por ejemplo, en lugar de revisar manualmente los registros cada semana, puedes pedirle a un agente de IA que identifique los registros incompletos, resuma la actividad del pipeline o prepare revisiones de cuentas utilizando la información de HubSpot.

Si eres desarrollador y quieres escribir scripts personalizados o utilizar manualmente la CLI de HubSpot Agent en tu terminal, consulta nuestra documentación para desarrolladores.

Antes de empezar

Antes de empezar a utilizar la CLI de HubSpot Agent, asegúrate de que tienes acceso a un agente de programación de IA. Entre los agentes compatibles se incluyen Claude Code, Claude Cowork, OpenAI Codex y muchos otros agentes de IA compatibles.

Ten en cuenta que, si utilizas Claude Cowork en una cuenta Team o Enterprise, es posible que el administrador de tu organización tenga que añadir api.hubapi.com a la lista de dominios permitidos para que la CLI pueda instalarse o ejecutarse. Más información sobre las listas de permitidos en Claude Cowork.

A qué pueden acceder los agentes de IA con la CLI de HubSpot Agent

La CLI de HubSpot Agent puede realizar acciones utilizando los permisos del usuario de HubSpot conectado. En función de tus permisos de usuario, esto podría incluir la creación, actualización o eliminación de registros en tu cuenta.

Una vez conectada la CLI de HubSpot Agent, los agentes de IA pueden trabajar con la información de toda tu cuenta de HubSpot, incluyendo:

• Contactos, empresas, negocios, tickets, objetos personalizados y otros registros de CRM.
• Workflows.
• Tramos y etapas de las pipelines.
• Propiedades y propiedades personalizadas.
• Relaciones entre registros.
• Historial de actividades.

Nota: revisa siempre las recomendaciones y las acciones propuestas generadas por la IA antes de aplicar cambios a los datos de tu CRM.

Mejores prácticas

Al trabajar con agentes de IA conectados a HubSpot:

• Empieza por las tareas de elaboración de informes, resúmenes y análisis antes de utilizar acciones que modifiquen los datos.
• Revisa las recomendaciones generadas y las actualizaciones de expansión antes de aplicar los cambios.
• Algunas acciones pueden eliminar o sobrescribir datos de HubSpot. Siempre que sea posible, utiliza la opción --dry-runpara obtener una vista previa de los cambios antes de aplicarlos.
• Utiliza prompts claros que describan el resultado deseado.
• Sigue las políticas de gobernanza y seguridad de los datos de tu organización.

Conectar la CLI de HubSpot Agent

Sigue los pasos que se indican a continuación para indicar a tu agente que instale la CLI de HubSpot Agent. Si eres desarrollador, obtén más información sobre cómo instalar manualmente la CLI de HubSpot Agent.

1. Abre tu agente de IA, como Cowork o Codex.
2. Pega el siguiente prompt en el espacio de trabajo de tu agente para instalar la CLI del 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. Cuando se te promueva, inicia sesión en tu cuenta de HubSpot.
4. Revisa los permisos solicitados.
5. Haz clic en Conectar una aplicación.

Una vez completada la autenticación, el agente de IA podrá acceder a los datos de HubSpot en función de tus permisos.

Para empezar, utiliza uno de los prompts de ejemplo que aparecen a continuación.

Casos de uso de ejemplo

Los siguientes ejemplos muestran cómo distintos equipos pueden utilizar agentes de IA conectados a través de la CLI de HubSpot Agent. Este agente resulta especialmente útil para las tareas operativas recurrentes que requieren revisar grandes cantidades de datos del CRM.

Equipos de marketing

Tarea: identificar los contactos que requieren un seguimiento o una limpieza de datos.

Ejemplo de prompt para el agente de IA: Todos los lunes a las 8:00, busca contactos con un alto grado de compatibilidad que no tengan ningún negocio asociado, ninguna actividad de ventas reciente o campos clave de enriquecimiento que falten; a continuación, envía a RevOps una lista de limpieza priorizada con las próximas acciones sugeridas.

Otros ejemplos son:

• Revisar las campañas de correo electrónico para detectar líneas de asunto y llamadas a la acción que no se ajusten a las directrices de voz de marca.
• Identificar los patrones de comunicación presentes en las landing pages de alto rendimiento que guardan relación con unas tasas de conversión más elevadas.
• Crea una lista de reactivación con los contactos que no hayan interactuado con los correos electrónicos de una secuencia de fidelización.
• Realiza un seguimiento del estado actual en la pipeline de negocios de los negocios generados a partir de una campaña de webinarios.
• Identificar los patrones en cuanto al sector, el tamaño de la empresa y la fuente de los leads entre los clientes más adecuados.
• Supervisa las secuencias activas y señala las caídas significativas en las tasas de apertura de los correos electrónicos.

Equipos de ventas y de Revenue Operations

Tarea: supervisar el estado del pipeline de ventas e identificar los negocios que requieren atención.

Ejemplo de prompt para el agente de IA: Cada mañana a las 7:00, revisa mi pipeline de negocios para ver cuáles se cierran esta semana y no han tenido actividad en los últimos 5 días, y envíame un resumen.

Otros ejemplos son:

• Busca negocios inactivos de gran valor que requieran un seguimiento y una revisión.
• Prepárate para una reunión con un cliente resumiendo el historial de negocios, asistencia, correos electrónicos y notas.
• Analiza los negocios que no se han cerrado para identificar las etapas del proceso de ventas en las que las oportunidades se han estancado durante más tiempo.
• Genera un resumen diario de los negocios que se acercan a su fecha de cierre pero en los que no se ha registrado actividad reciente.

Responsables de ventas

Tarea: analizar las transcripciones de llamadas para identificar temas relacionados con el asesoramiento y los comentarios sobre los productos.

Ejemplo de prompt para el agente de IA: Analiza las transcripciones de las llamadas recientes para determinar la duración de las conversaciones, las menciones a la competencia, los comentarios de los clientes y los motivos de indecisión de los prospectos; a continuación, crea un panel de control con consejos de formación y comentarios sobre el producto, que incluya ejemplos de transcripciones y enlaces a las llamadas originales.

Otros ejemplos son:

• Identifica a los comerciales o equipos que presenten patrones de tiempo de conversación inusualmente altos o bajos.
• Identifica las menciones recurrentes de la competencia en las llamadas de ventas recientes.
• Resume los motivos de indecisión de los prospectos por segmento, etapa del negocio o área de producto.
• Selecciona ejemplos de transcripciones que respalden los temas relacionados con el coaching o los comentarios sobre los productos.
• Crea un panel de control que relacione la información sobre las llamadas con los registros y las transcripciones originales.

Administradores de RevOps y CRM

Tarea: limpiar las propiedades del CRM sin afectar a los activos posteriores.

Ejemplo de prompt para el agente de IA: Busca propiedades de CRM duplicadas u obsoletas y muestra dónde se utilizan en los workflows, los informes y las vistas. A continuación, previsualiza un plan de limpieza para sustituir, eliminar o reordenar campos antes de aplicar los cambios.

Otros ejemplos son:

• Identifica las propiedades duplicadas que recogen la misma información en diferentes objetos.
• Busca campos obsoletos que sigan apareciendo en workflows, informes, vistas o diseños de registros.
• Previsualiza el impacto que tendría eliminar o sustituir una propiedad del CRM antes de realizar los cambios.
• Reordena los campos de los registros para que los administradores y los comerciales vean primero la información más importante.
• Genera un resumen de la revisión que muestre qué se ha modificado y qué queda aún por revisar.

Equipos de operaciones

Tarea: agrupar los tickets de asistencia relacionados y conservar el historial de limpieza.

Ejemplo de prompt para el agente de IA: Agrupa los tickets de asistencia duplicados, conserva los datos del ticket original, deriva cada ticket principal a la fase adecuada de la pipeline y envía al equipo un resumen de la limpieza con los registros que aún deban revisarse.

Otros ejemplos son:

• Busca tickets de asistencia duplicados o relacionados con el mismo cliente o tipo de incidencia.
• Incorporar el contexto del ticket a un registro principal conservando los detalles de origen.
• Asigna los tickets consolidados a la fase correcta del pipeline en función de su estado actual.
• Marca los tickets que requieran una revisión manual antes de su consolidación.
• Envía un resumen de la limpieza con los registros fusionados, las cuestiones pendientes y las personas encargadas del seguimiento.

Equipos de asistencia

Tarea: consultar el historial del cliente sin tener que abrir manualmente varios registros.

Ejemplo de prompt para el agente de IA: Recopila los últimos 5 tickets de este contacto, resume la resolución de cada uno de ellos y señala cualquier patrón de problemas recurrentes.

Otros ejemplos son:

• Revisa el historial reciente de tickets e identifica los problemas recurrentes de los clientes antes de abrir un nuevo caso.
• Da prioridad a los tickets que hayan superado los tiempos de respuesta previstos.
• Analizar los tickets relacionados con la facturación para identificar los motivos más habituales por los que los clientes se ponen en contacto con el servicio de asistencia al cliente.
• Prepara las respuestas a los tickets con el historial relevante de negocios, suscripciones y derivaciones.

Equipos de éxito del cliente

Tarea: elaborar informes de revisión de cuentas utilizando información procedente de varias herramientas de HubSpot.

Ejemplo de prompt para el agente de IA: Para la revisión de mi cartera de esta semana, resume los negocios pendientes, la actividad reciente de atención al cliente y la última puntuación NPS de cada cuenta de mi cartera.

Otros ejemplos son:

• Identificar las cuentas de clientes que presenten indicadores de un riesgo elevado de pérdida de clientes.
• Identifica a los clientes con contratos de renovación y bajo nivel de interacción con el producto para realizar una campaña de comunicaciones proactiva.
• Elabora informes de revisión de cuentas resumiendo la actividad reciente en materia de ventas, atención al cliente y comentarios de los clientes.
• Identifica oportunidades de expansión comparando las tendencias de crecimiento de las cuentas con el volumen histórico de los negocios.

Mantén actualizada la biblioteca de habilidades

Las habilidades de la CLI de HubSpot Agent ofrecen instrucciones predefinidas que ayudan a los agentes de IA a trabajar con los datos de HubSpot y a llevar a cabo los procesos habituales de HubSpot. La biblioteca de habilidades incluye instrucciones para búsquedas en el CRM, operaciones masivas, tareas relacionadas con la calidad de los datos, workflows, generación de informes y otras actividades operativas.

Puedes consultar las habilidades que se publicarán en el repositorio público de GitHub.

Para actualizar la biblioteca de habilidades en el espacio de trabajo de tu agente de IA, ejecuta el siguiente prompt:

npx skills update

Obtén más información sobre cómo utilizar las habilidades en Claude y en OpenAI Codex.

Gestionar el acceso a la CLI de HubSpot Agent

Los superadministradores pueden gestionar quién tiene permiso para conectarse a la CLI de HubSpot Agent participando en la versión beta de «App Install Governance ».

Si un usuario no tiene permiso para conectar la CLI de HubSpot Agent, deberá solicitar la autorización de un administrador antes de conectarla.

Obtén más información sobre cómo gestionar qué aplicaciones se pueden instalar en tu cuenta de HubSpot.