CRM y ventas
Conectar HubSpot a un agente de IA autónomo
Un agente de Atako conectado a HubSpot puede leer y actualizar contactos, empresas, deals y tickets, pero solo los objetos y acciones cubiertos por su grant.
Flujos de trabajo posibles
Enriquecimiento y calificación de los leads entrantes
En cuanto un contacto llega al CRM, el agente lo obtiene con get_contact, contrasta la información disponible, actualiza sus propiedades (update_contact), registra una nota de calificación (create_note) y crea una tarea de seguimiento para la persona comercial correspondiente (create_task). El comercial mantiene el control de la llamada o del correo, el agente solo le evita la introducción de datos y la búsqueda previa que normalmente preceden a un primer contacto útil, y que a menudo se aplaza por falta de tiempo disponible en el día.
Seguimiento de los deals que se estancan en el pipeline
El agente busca los deals sin movimiento desde hace un número determinado de días (search_deals, list_pipelines para conocer las etapas), crea una tarea de seguimiento para la persona propietaria del deal identificada mediante list_owners, y puede actualizar el estado si una regla clara lo justifica (update_deal). Nada se mueve sin dejar un rastro consultable en el CRM, lo que evita pipelines inflados con deals fantasma que nadie retoma de verdad.
Creación de tickets de soporte vinculados a una cuenta
A partir de una señal recibida por correo o Slack, el agente crea un ticket (create_ticket), lo asocia al contacto y a la empresa correctos (create_association), y luego sigue su avance y lo actualiza a lo largo de la conversación (update_ticket). El ticket sigue siendo visible y modificable por el equipo de soporte como cualquier otro, con el historial completo de la cuenta ya vinculado desde su creación.
Acciones del conector
get_contact (lectura)
Obtiene un contacto del CRM por identificador.
search_contacts (lectura)
Busca contactos por texto o filtros de propiedades.
get_deal (lectura)
Obtiene un deal del CRM por identificador.
list_deals (lectura)
Lista los deals del CRM, paginado.
list_pipelines (lectura)
Lista los pipelines y sus etapas (deals o tickets).
list_owners (lectura)
Lista los propietarios del CRM, filtrable por correo.
create_contact (escritura)
Crea un contacto en el CRM.
update_contact (escritura)
Actualiza las propiedades de un contacto.
create_deal (escritura)
Crea un deal en el CRM.
update_deal (escritura)
Actualiza un deal (etapa, importe).
create_ticket (escritura)
Crea un ticket de soporte.
create_task (escritura)
Crea una tarea del CRM (seguimiento, llamada).
create_note (escritura)
Registra una nota, para asociarla a un registro.
create_association (escritura)
Asocia dos registros del CRM entre sí.
Requisitos previos
- Cuenta de HubSpot con derecho de super administrador para crear una private app.
- Crear una private app en Settings, luego Integrations, luego Private Apps.
- Seleccionar los scopes necesarios (contacts, companies, deals, tickets, owners en lectura/escritura).
- Copiar el token de acceso mostrado tras la creación (prefijo pat-).
- En Atako, un derecho de administración de integraciones para conceder el grant al agente.
Cómo conectar
- 1
Crear la private app de HubSpot
En Settings, luego Integrations, luego Private Apps, crear una app, nombrarla y elegir sus scopes en la pestaña correspondiente.
- 2
Generar y copiar el token
Una vez creada la app, mostrar y copiar el token de acceso (pat-...), que se muestra una sola vez.
- 3
Conectar HubSpot en Atako
En Ajustes, luego Integraciones, pegar el token de acceso.
- 4
Conceder el grant al agente
Desde la página del agente o desde la conexión, seleccionar las acciones precisas autorizadas y su alcance (solo lectura o lectura y escritura).
Por qué conectar un agente autónomo a HubSpot
HubSpot centraliza los contactos, los deals y los tickets de un equipo comercial o de soporte. El trabajo repetitivo que va con ello, enriquecer una ficha, retomar un deal que se estanca, crear una tarea de seguimiento, suele hacerse de forma esporádica, cuando alguien se acuerda. Un agente de Atako conectado a HubSpot mediante tool calling hace ese trabajo de forma continua, en su propio entorno, sin esperar a que un comercial abra su lista de tareas por la mañana.
La diferencia con un escenario de automatización clásico: el agente funciona de forma permanente y toma una decisión, no solo una acción aislada. Puede recibir una señal por correo o Slack, buscar el contacto o el deal correspondiente en HubSpot, decidir si hay que crear una tarea o actualizar una propiedad, y luego hacerlo, dentro del marco exacto de las acciones que se le han concedido.
El conector de HubSpot cubre 37 acciones según la documentación de Atako (17 de lectura, 20 de escritura), desde la búsqueda de contactos hasta la creación de propiedades personalizadas. El caso de uso más directo: un agente de automatización de RevOps que vigila el pipeline, enriquece los leads y señala las anomalías de datos sin intervención manual constante.
Límites y buenas prácticas
La API de HubSpot impone límites de tasa que varían según la suscripción de HubSpot de la empresa (número de solicitudes por intervalo de diez segundos, y por día), con umbrales aún más estrictos en los endpoints de búsqueda. Un agente que procesa un gran volumen de contactos debe por tanto repartir sus llamadas en lugar de hacerlo todo de golpe.
Algunas acciones de escritura, como delete_contact o delete_deal, son irreversibles del lado de HubSpot una vez ejecutadas. Solo pueden usarse si el grant del agente las autoriza explícitamente, algo que en la práctica sigue siendo poco frecuente para este tipo de acción.
Como con cualquier integración de Atako, la conexión por sí sola no da ningún acceso: hace falta un grant preciso (agente, acción, alcance). Consulte el modelo de permisos y los planes para acotar ese alcance antes de conectar el agente a su CRM.
Casos de uso relacionados
Integraciones complementarias
Preguntas frecuentes
¿Puede el agente enviar correos de marketing desde HubSpot?
Puede crear un borrador de correo de marketing (create_marketing_email) si se concede ese scope, pero nada sale sin una acción de envío validada por su equipo: el conector no incluye ninguna acción de envío directo de correo de marketing.
¿Hace falta un plan de HubSpot de pago para conectar la API?
La API y las private apps están disponibles desde el plan gratuito de HubSpot para los objetos estándar. Algunos scopes avanzados, como la creación de propiedades personalizadas, pueden depender del nivel tarifario contratado.
¿Cómo se revoca el acceso del agente a HubSpot?
Elimine o desactive la private app del lado de HubSpot, o revoque la conexión del lado de Atako. El acceso se corta de inmediato y de forma definitiva para todos los agentes que lo usaban.
¿Puede el agente eliminar contactos del CRM?
Sí, la acción delete_contact existe, pero solo si el grant del agente la autoriza explícitamente con alcance de escritura. Por defecto, no se concede ninguna acción: es usted quien decide si la eliminación forma parte del alcance del agente.
Qué leer a continuación
Fuentes
- HubSpot Developer Docs, Private apps · consultado el 4 de septiembre de 2026
- HubSpot Developer Docs, API usage guidelines and limits · consultado el 4 de septiembre de 2026
CTO de Atako
Este contenido fue redactado por los agentes de IA de Atako, y luego revisado, corregido y validado por Romain Laodicina, CTO de Atako.