- Base de conocimientos
- Cuenta y configuración
- Integraciones
- Utiliza la CLI de HubSpot Agent
Utiliza la CLI de HubSpot Agent
Última actualización: 29 de septiembre de 2026
Disponible con cualquiera de las siguientes suscripciones, a no ser que se indique de otro modo:
La CLI de HubSpot Agent conecta los agentes de programación basados en IA, como los de las aplicaciones ChatGPT, Claude y Claude Code , 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 la documentación para desarrolladores de HubSpot.
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 los de la aplicación ChatGPT, la aplicación Claude,Claude Code 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.
Cuándo utilizar la CLI de HubSpot Agent
La interfaz de línea de comandos (CLI) de Agent resulta útil para tareas operativas repetitivas o recurrentes que requieren revisar grandes cantidades de datos del CRM. Esto incluye tareas como realizar una revisión semanal del pipeline, actualizar registros de forma masiva o enviar resúmenes programados a tu equipo tras una reunión mensual periódica. Consulta más ejemplos de casos prácticos.
Si lo que quieres es hacer preguntas puntuales o redactar contenido utilizando tus datos de HubSpot, el conector de HubSpot para Claude o el conector de HubSpot para ChatGPT son opciones que no requieren la instalación de una interfaz de línea de comandos (CLI).
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.
- Registros de ingresos (solo lectura): contratos, facturas, pedidos, pagos, cotizaciones, plantillas de cotización y suscripciones (BETA).
- 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.
- A la hora de configurar tareas programadas o recurrentes, empieza por un caso práctico concreto y específico antes de ampliar la automatización a ámbitos más amplios.
- 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 y concretos 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.
- Abre tu agente de IA.
- 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.
- Cuando se te promueva, inicia sesión en tu cuenta de HubSpot.
- Revisa los permisos solicitados.
- 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.
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.
Equipos de marketing
| Tarea | Ejemplo de prompt para el agente de IA |
| Identifica los contactos que requieren un seguimiento o una limpieza de datos. | Todos los lunes a las 8:00, identifica los contactos con un alto nivel de idoneidad que no tengan ningún negocio asociado, ninguna actividad de ventas reciente o a los que les falten campos clave de enriquecimiento, y envía a RevOps una lista priorizada de limpieza con las próximas acciones sugeridas. |
| 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. | Revisa mis últimas 10 campañas de correo electrónico y señala los asuntos o las llamadas a la acción que no sigan nuestras directrices de voz de marca. Enumera cada problema indicando el nombre de la campaña, el texto señalado y una propuesta de modificación. |
| 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. | Analiza mis landing pages con mejor rendimiento según la tasa de conversión. Identifica los patrones habituales en los mensajes, como la estructura de los titulares, la redacción de las CTA o el tipo de oferta, y resume qué tienen en común. |
| Crea una lista de reactivación con los contactos que no hayan interactuado con los correos electrónicos de una secuencia de fidelización. | Busca todos los contactos que estén actualmente inscritos en una secuencia de fidelización y que no hayan abierto ningún correo electrónico en los últimos 30 días. Crea un segmento con su nombre, empresa, etapa del ciclo de vida y fecha de la última actividad. |
| Realiza un seguimiento del estado actual en la pipeline de negocios de los negocios generados a partir de una campaña de webinarios. | Busca todos los negocios en los que la fuente del lead sea un webinario y muestra su fase actual en el pipeline de negocios, el responsable, la cantidad y la fecha de la última actividad. Resume cuántos están activos, en suspenso o cerrados. |
| 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. | Analiza mis negocios de cierre ganado de los últimos 12 meses y resume las combinaciones más habituales de sector, tamaño de la empresa y fuente de leads. Destaca cualquier patrón que pueda ayudarnos a perfeccionar nuestro perfil de cliente ideal. |
| Supervisa las secuencias activas y señala las caídas significativas en las tasas de apertura de los correos electrónicos. | Comprueba todas las secuencias activas y compara las tasas de apertura de las dos últimas semanas con las de las dos semanas anteriores. Marca todas las secuencias en las que las tasas de apertura hayan descendido más de un 20 % e incluye el nombre de la secuencia, la tasa actual y la tasa anterior. |
Equipos de ventas y de Revenue Operations
| Tarea | Ejemplo de prompt para el agente de IA |
| Supervisa el estado del pipeline de ventas e identifica los negocios que requieren atención. | Cada mañana a las 7:00, revisa mi pipeline de negocios para ver qué negocios se cierran esta semana y en los que no haya habido actividad en los últimos 5 días, y envíame un resumen. |
| Busca negocios inactivos de gran valor que requieran un seguimiento y una revisión. | Busca todos los negocios abiertos superiores a $[cantidad] que no hayan registrado actividad en los últimos 14 días. Ordena por valor del negocio e incluye el nombre del negocio, el titular, la fecha de cierre y la última actividad. |
| Prepárate para una reunión con un cliente resumiendo el historial de negocios, asistencia, correos electrónicos y notas. | Mañana tengo una reunión con [Empresa]. Resume los negocios abiertos y los cerrados recientemente, los últimos 5 tickets de asistencia, la actividad reciente por correo electrónico y cualquier nota registrada en los últimos 60 días. |
| 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. | Echa un vistazo a los negocios que no tuvieron su fecha de cierre en el último trimestre. Para cada una de ellas, indica en qué fase del pipeline de ventas se ha dedicado más tiempo e identifica las dos o tres fases en las que los negocios suelen estancarse con mayor frecuencia. |
| 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. | Cada día, a las 8 de la mañana, descubre negocios que se cerrarán en los próximos 7 días y que no han tenido actividad en los últimos 3 días. Envíame un resumen con el nombre del negocio, el titular, la cantidad, la fecha de cierre y el tipo de última actividad. |
Responsables de ventas
| Tarea | Ejemplo de prompt para el agente de IA |
| Analizar las transcripciones de llamadas para identificar temas relacionados con el asesoramiento y las opiniones sobre los productos. | 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 de formación y comentarios sobre el producto con ejemplos de transcripciones y enlaces a las llamadas originales. |
| Identifica a los comerciales o equipos que presenten patrones de tiempo de conversación inusualmente altos o bajos. | Analiza las transcripciones de las llamadas de los últimos 30 días y calcula la proporción media de tiempo de conversación por agente. Marca a todos aquellos que tengan un porcentaje superior al 70 % o inferior al 30 %, e incluye un fragmento de expediente académico de cada uno. |
| Identifica las menciones recurrentes de la competencia en las llamadas de ventas recientes. | Revisa las transcripciones de las llamadas de los últimos 60 días e identifica a los competidores que se mencionan con más frecuencia. Para cada una, indica cuántas llamadas incluían una mención, en qué etapas del negocio se produjeron y una cotización de ejemplo. |
| Resume los motivos de indecisión de los prospectos por segmento, etapa del negocio o área de producto. | Revisa las transcripciones de las llamadas recientes en busca de expresiones que indiquen dudas u objeciones por parte del prospecto. Agrupa los temas por etapa del negocio y segmento de prospectos, y resume los cinco principales patrones de indecisión con citas a modo de ejemplo. |
| Selecciona ejemplos de transcripciones que respalden los temas relacionados con el coaching o los comentarios sobre los productos. | A partir de las transcripciones de las llamadas de los últimos 30 días, busca entre tres y cinco ejemplos de preguntas de exploración eficaces y entre tres y cinco ejemplos de ocasiones en las que no se han sabido gestionar las objeciones. Incluye el nombre del comercial, la fecha de la llamada y una cotización textual de cada uno de ellos. |
| Crea un panel de control que relacione la información sobre las llamadas con los registros y las transcripciones originales. | Crea un panel de control de coaching que resuma los índices de tiempo de conversación, las menciones a la competencia y los temas de objeción extraídos de las llamadas de los últimos 30 días. Para cada dato, incluye un enlace a la llamada de origen y al registro del negocio correspondiente. |
Administradores de RevOps y CRM
| Tarea | Ejemplo de prompt para el agente de IA |
| Limpia las propiedades del CRM sin afectar a los activos posteriores. | Detecta 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. |
| Identifica las propiedades duplicadas que recogen la misma información en diferentes objetos. | Analiza todas las propiedades de contacto, de empresa y de negocio, y marca aquellas que parezcan recopilar la misma información con nombres diferentes. Enumera los nombres de las propiedades, sus objetos y una acción recomendada para cada par duplicado. |
| Busca campos obsoletos que sigan apareciendo en workflows, informes, vistas o diseños de registros. | Busca todas las propiedades de CRM que no se hayan actualizado en los últimos 12 meses, pero que sigan apareciendo en workflows activos, informes guardados, vistas de lista o diseños de ficha de registro. Muestra dónde se utiliza cada uno antes de realizar ningún cambio. |
| Previsualiza el impacto que tendría eliminar o sustituir una propiedad del CRM antes de realizar los cambios. | Quiero eliminar la propiedad [Nombre de la propiedad]. Antes de realizar ningún cambio, muéstrame todos los workflows, informes, fichas y diseños de registros que lo utilicen, y ofréceme una vista previa de lo que dejaría de funcionar o habría que actualizar. |
| Reordena los campos de los registros para que los administradores y los comerciales vean primero la información más importante. | En el diseño del registro de contacto, desplaza estos campos a la parte superior de la barra lateral de propiedades: [Campo 1], [Campo 2], [Campo 3]. Previsualiza antes de aplicar los cambios. |
| Genera un resumen de la revisión que muestre qué se ha modificado y qué queda aún por revisar. | Una vez finalizada la limpieza de las propiedades del CRM, genera un resumen de todas las propiedades que se han eliminado, sustituido o renombrado, de los activos que se han actualizado y una lista de los campos que aún requieren una revisión manual. |
Equipos de operaciones
| Tarea | Ejemplo de prompt para el agente de IA |
| Agrupar los tickets de asistencia relacionados y conservar el historial de limpieza. | 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 deben revisarse. |
| Busca tickets de asistencia duplicados o relacionados con el mismo cliente o tipo de incidencia. | Busca todos los tickets de asistencia abiertos de la misma empresa que se hayan creado con una diferencia de 30 días entre sí. Agrúpalos por empresa y tipo de incidencia, y señala aquellos que parezcan ser duplicados. |
| Incorporar el contexto del ticket a un registro principal conservando los detalles de origen. | En el caso de los tickets duplicados identificados anteriormente, integra la descripción, el historial de contacto y las notas de cada ticket de origen en las notas del registro principal antes de cerrar los duplicados. |
| Asigna los tickets consolidados a la fase correcta del pipeline en función de su estado actual. | Para cada ticket principal consolidado, comprueba su estado actual y trasládalo a la fase correcta del pipeline: las incidencias abiertas a «En curso», los tickets que esperan una respuesta a «A la espera del cliente» y las incidencias resueltas a «Cerrado». |
| Marca los tickets que requieran una revisión manual antes de su consolidación. | Antes de consolidar cualquier ticket, marca los registros que tengan una disputa de pago pendiente, un plazo de ANS activo o una nota marcada como «derivación». No las fusiones. En su lugar, crea una ficha para cada una de ellas y úsalas para su revisión manual. |
| Envía un resumen de la limpieza con los registros fusionados, las cuestiones pendientes y las personas encargadas del seguimiento. | Una vez finalizada la consolidación de los tickets, envía al responsable del equipo de asistencia una ficha en la que se indiquen todos los tickets principales creados, los tickets originales que se han fusionado en ellos, las cuestiones pendientes que requieran seguimiento y quién se encarga de cada paso siguiente. |
Equipos de asistencia
| Tarea | Ejemplo de prompt para el agente de IA |
| Consulta el historial de los clientes sin tener que abrir manualmente varios registros. | Selecciona los últimos 5 tickets de este contacto, resume la resolución de cada uno de ellos y señala cualquier patrón recurrente en los problemas. |
| Revisa el historial reciente de tickets e identifica los problemas recurrentes de los clientes antes de abrir un nuevo caso. | Antes de crear un nuevo ticket para [Contacto], voy a recuperar sus últimos 10 tickets, resumiré cada resolución y señalaré cualquier problema que se repita más de una vez. Indica el asunto del ticket, su estado y la fecha de resolución. |
| Da prioridad a los tickets que hayan superado los tiempos de respuesta previstos. | Busca todos los tickets abiertos que no hayan recibido respuesta dentro del plazo previsto en el ANS. Órdalos según el tiempo que lleven pendientes e incluye el titular del ticket, el nombre de la persona de contacto y la fecha de la última actividad. |
| 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. | Revisa todos los tickets etiquetados con una categoría relacionada con la facturación de los últimos 90 días. Resume las cinco razones principales por las que los clientes se pusieron en contacto con el servicio de asistencia al cliente, ordenadas por volumen, e incluye el tiempo medio de resolución para cada una de ellas. |
| Prepara las respuestas a los tickets con el historial relevante de negocios, suscripciones y derivaciones. | Para el ticket [ID del ticket], recupera el historial de negocios asociado al contacto, los datos de la suscripción actual y cualquier nota de derivación anterior. Resume el contexto y redacta una respuesta que aborde el problema del cliente. |
Equipos de éxito del cliente
| Tarea | Ejemplo de prompt para el agente de IA |
| Elabora informes de clientes utilizando información procedente de varias herramientas de HubSpot. | Para la revisión de negocios de esta semana, resume los negocios pendientes, la actividad reciente del servicio de atención al cliente y la última puntuación NPS de cada negocio de mi cartera. |
| Identificar las cuentas de clientes que presenten indicadores de un riesgo elevado de pérdida de clientes. | Revisar las cuentas de mi cartera de clientes y señalar aquellas que presenten dos o más de estas señales: disminución de la frecuencia de inicio de sesión en el producto, tickets de asistencia abiertos con más de 14 días de antigüedad, una puntuación NPS inferior a 7 o ausencia de actividad del CSM en los últimos 30 días. Clasifícalos según su nivel de riesgo. |
| 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. | Busca todos los contactos de las cuentas cuya renovación esté prevista en los próximos 60 días y que no hayan iniciado sesión en el producto en los últimos 21 días. Elabora una lista de contactos prioritaria que incluya el nombre del contacto, la cuenta, la fecha de renovación y la fecha del último inicio de sesión. |
| Elabora informes de revisión de cuentas resumiendo la actividad reciente en materia de ventas, atención al cliente y comentarios de los clientes. | Para [Nombre de la cuenta], resume toda la actividad relacionada con los negocios de los últimos 6 meses, los tickets de asistencia abiertos y cerrados recientemente, así como cualquier respuesta relacionada con el NPS o el CSAT. Redacta esto como un informe previo a la reunión trimestral de resultados (QBR) que pueda compartir con el equipo de cuentas. |
| Identifica oportunidades de expansión comparando las tendencias de crecimiento de las cuentas con el volumen histórico de los negocios. | Analiza las cuentas de mi cartera de clientes que hayan aumentado su plantilla o sus ingresos durante el último año. Compara el volumen actual de sus negocios con el que han alcanzado negocios similares y señala las 10 principales como posibles oportunidades de expansión. |
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 ChatGPT.
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. Si un usuario no tiene permiso para conectar la CLI de HubSpot Agent, deberá solicitar la autorización de un superadministrador antes de conectarla.
Obtén más información sobre cómo gestionar qué aplicaciones se pueden instalar en tu cuenta de HubSpot.
Contenido relacionado
