API de HubSpot: qué puedes hacer y cómo usarla con agentes de IA
La API de HubSpot da acceso a los objetos del CRM, como contactos, empresas, negocios y tickets, y también a marketing, conversaciones y propiedades personalizadas. La usan equipos de ventas, RevOps e integradores. El acceso es abierto, mediante una app privada con token o una app pública con OAuth, y la disponibilidad de los recursos depende del plan.
Qué ofrece la API de HubSpot
Objetos del CRM
Contactos, empresas, negocios, tickets, productos y objetos personalizados.
Asociaciones
Vínculos entre objetos, como contacto con empresa y negocio.
Interacciones
Notas, tareas, correos, llamadas y reuniones registrados en la línea de tiempo.
Pipelines
Etapas de negocios y tickets, y movimiento entre ellas.
Propiedades
Campos estándar y personalizados de cada objeto.
Búsqueda
Consultas con filtros sobre los objetos del CRM.
Webhooks
Avisos de creación y modificación de registros para las apps.
Cómo acceder a la API de HubSpot
- API públicaApp privada con token de acceso y alcances elegidos en la cuenta, o app pública con OAuth 2.0. Las antiguas claves de API se dejaron de admitir.
- Los límites de solicitudes varían según el plan; usa búsquedas y lotes en lugar de llamadas individuales.
- Elige los alcances mínimos en la app privada.
- Los contactos tienen una base legal y un consentimiento: respeta las preferencias de comunicación según la ley de protección de datos que te aplique, como el RGPD.
Documentación oficial: developers.hubspot.com
Qué hace un agente de iTeam con la API de HubSpot
Negocio detenido en una etapa
El agente encuentra negocios sin actividad desde hace dos semanas y envía al vendedor un resumen del último contacto con una sugerencia de siguiente paso.
Registro de reuniones sin esfuerzo
Después de la llamada, el agente crea la nota en el negocio, actualiza propiedades como presupuesto y plazo y programa la tarea de seguimiento.
Ticket con contexto
Al abrirse un ticket, el agente asocia la empresa y el contrato y resume las últimas interacciones para soporte.
Base limpia
El agente identifica contactos duplicados y empresas sin dominio y propone las correcciones en lote para su aprobación.
De la credencial al agente trabajando, con aprobación
Crea una app privada en HubSpot
Un super administrador define los alcances mínimos, por ejemplo lectura y escritura de negocios y contactos.
Registra el token en la bóveda de iTeam
El token queda en la bóveda y cada agente tiene permisos propios; el SDR no modifica pipelines.
Prueba con aprobación
Las notas y las tareas pueden ser automáticas; los cambios de etapa, las fusiones y los borrados pasan por aprobación.
Equipos de IA listos que usan HubSpot
Atención por WhatsApp
Jaca contesta en WhatsApp Business con tus precios, horarios y políticas, y cuando algo pide criterio humano se lo pasa a tu equipo con el contexto co…
Recepcionista con IA
Jaca atiende el teléfono con voz, entiende qué necesita quien llama y deja la cita agendada o el recado en manos de la persona correcta.
Postventa y customer success
Nina vigila cómo usa cada cliente lo que compró, Jaca lo contacta en el momento justo y Romeo detecta quién está listo para ampliar.
Prospección comercial B2B
Romeo arma la lista y la investiga, Dai escribe un primer mensaje pensado para esa empresa y tu vendedor decide qué sale.
Calificación de leads
Jaca contesta al lead mientras todavía está pensando en ti, Romeo lo califica con tus criterios y la reunión cae en la agenda del vendedor.
Ventas por WhatsApp
Jaca contesta al cliente aunque el vendedor esté ocupado, Romeo arma el presupuesto y Darwin prepara el enlace de pago.
Preguntas sobre la API de HubSpot
¿La API de HubSpot es gratuita?
En general, la API está disponible incluso en el plan gratuito, pero algunos objetos y límites dependen de los planes de pago.
¿Necesito programar para usar la API de HubSpot con iTeam?
No necesariamente. HubSpot tiene un conector listo en el catálogo y el equipo de implantación configura los flujos.
¿Se pueden usar propiedades personalizadas?
Sí, la API lee y escribe las propiedades personalizadas igual que las estándar.
