Crear aplicaciones
Descripción general de la creación de aplicaciones
Descubre las herramientas y las cuentas de desarrollador de HubSpot. Úsalas para crear una integración, publicar una aplicación en el mercado o crear una cuenta de prueba.
Última modificación: 28 de agosto de 2025
Las aplicaciones te permiten autenticar llamadas a la API a tu cuenta de HubSpot, suscribirte a eventos con webhooks y extender la interfaz de usuario de HubSpot, como con las tarjetas personalizadas. HubSpot ofrece varios tipos de aplicaciones y extensiones según las necesidades de tu integración. A continuación, obtén más información sobre los tipos de aplicaciones y extensiones que puedes crear con HubSpot, cómo comenzar a crearlas y cómo administrarlas en HubSpot.
Tipos de aplicaciones
Dependiendo del tipo de integración que desees construir, deberás elegir el tipo correcto de aplicación. A continuación, encuentra más información sobre los tipos de aplicaciones que puedes crear y las funcionalidades que admiten. Para crear extensiones, ve la tabla de referencia a continuación para obtener una descripción rápida de qué extensiones se pueden crear con qué tipos de aplicaciones.Aplicaciones privadas
Las aplicaciones privadas se pueden crear para una sola cuenta de HubSpot y son más adecuadas para scripts únicos o extensiones de un solo propósito. En general, las aplicaciones privadas son más fáciles de implementar que las aplicaciones públicas. Las aplicaciones privadas se autentican con tokens de acceso y no se pueden incluir en el mercado de aplicaciones de HubSpot. Por ejemplo, puedes crear una aplicación privada para tu cuenta de HubSpot para:- Crear un nuevo objeto personalizado a través de la API.
- Importar registros del CRM desde un archivo CSV.
- Autenticar solicitudes de API en acciones de automatización personalizadas y bots de chat.
- Crear y editar suscripciones a webhook.
Aplicaciones privadas en proyectos (versión beta)
Las aplicaciones privadas creadas mediante el marco de proyectos para desarrolladores permiten crear extensiones de interfaz de usuario para registros del CRM y paneles de vista previa del centro de ayuda. Necesitarás una suscripción Sales Hub o Service Hub Enterprise para crear una extensión de la interfaz de usuario para una aplicación privada en una cuenta estándar de HubSpot. Sin embargo, puedes probar estas herramientas de forma gratuita en una cuenta de prueba de desarrollador. Para comenzar, inscribe tu cuenta en la versión beta y luego sigue la guía de inicio rápido.Aplicaciones públicas
Las aplicaciones públicas se pueden instalar en varias cuentas. Además de los tipos de extensiones que puedes crear con una aplicación privada, las aplicaciones públicas admiten funciones avanzadas, como:- Suscribirse a eventos de toda la cuenta usando la API de webhooks.
- Crear eventos de cronología personalizados en registros del CRM usando la API de eventos de cronología.
- Crear páginas de configuración de aplicaciones personalizadas en HubSpot.
Aplicaciones públicas en proyectos (BETA)
Las aplicaciones públicas creadas mediante el marco de proyectos para desarrolladores permiten crear extensiones de interfaz de usuario para registros del CRM y paneles de vista previa del centro de ayuda. También puedes incluir otras extensiones en una aplicación pública creada de esta manera, pero tendrás que administrar esas extensiones en HubSpot y a través de la API como antes. Si estás inscrito en la versión beta, comienza siguiendo la guía de inicio rápido u obtén información sobre cómo migrar una aplicación pública existente al marco de proyectos.Extensiones compatibles por tipo de aplicación
| Tipo de aplicación | Extensiones admitidas |
|---|---|
| Aplicación privada | Las extensiones de interfaz de usuario que son compatibles con aplicaciones privadas creadas con proyectos (BETA). |
| Aplicación pública | Extensiones de interfaz de usuario son compatibles con las aplicaciones públicas creadas con proyectos (BETA). |
* Las tarjetas clásicas del CRM son diferentes de las tarjetas de aplicación que puedes crear como extensiones de la interfaz de usuario con proyectos (BETA). Las extensiones de interfaz de usuario ofrecen una funcionalidad más avanzada y componentes personalizables
Tipos de cuentas para el desarrollo de aplicaciones
Aunque el desarrollador de aplicaciones y las cuentas de prueba funcionen juntos, cada uno de ellos tiene un propósito diferente.- Las cuentas de desarrollador de aplicaciones están destinadas a crear y anunciar aplicaciones en el mercado de aplicaciones.
- Las cuentas de prueba de desarrollador, que se pueden crear en las cuentas de desarrollador, están diseñadas para probar las API y las aplicaciones que estás creando sin afectar los datos en una cuenta real de HubSpot.
- Si tienes una suscripción Sales Hub o Service Hub Enterprise, puedes usar entornos de pruebas de desarrollo en una cuenta de HubSpot estándar para iterar rápidamente sin afectar los datos o los activos de la cuenta.
Autenticación
Si quieres crear una integración personalizada con una sola cuenta de HubSpot, puedes crear una aplicación privada y usar el token de acceso para autenticar llamadas a la API o usar OAuth con una aplicación pública. Cualquier aplicación diseñada para ser instalada por varias cuentas de HubSpot o que se anuncie en el mercado de aplicaciones debe usar OAuth. Si quieres suscribirte a webhooks o configurar OAuth para tu aplicación, debes crear una cuenta de desarrollador. Con las cuentas de desarrollador, también puedes anunciar tus aplicaciones en el mercado de aplicaciones o crear una cuenta de prueba.Claves de API de desarrollador
Para administrar la configuración de tu aplicación a través de la API, puedes usar una clave de API de desarrollador. Esta clave de API está separada de las claves de API estándar que han quedado obsoletas. Las claves de API de desarrollador se pueden usar para administrar suscripciones para la API de Webhooks y crear o actualizar tipos de eventos para la característica de eventos de cronología. Todas las demás llamadas a la API deben realizarse usando un token de acceso a la aplicación privada u OAuth. Para acceder a la clave de API de tu cuenta de desarrollador de aplicaciones:- En tu cuenta de desarrollador de aplicaciones, ve a Claves > Clave de API para desarrolladores en la barra de navegación izquierda.
- Haz clic en Crear clave.
- Una vez creada la clave, puedes hacer clic en Mostrar clave. La clave se revelará y luego puedes hacer clic en Copiar junto a la clave.
- Para revisar una lista de las acciones de seguridad recientes asociadas a la clave, haz clic en Ver registros de auditoría.
- También puedes cambiar la clave de API actual haciendo clic en el menú desplegable Acciones, pasando el cursor por encima de Cambiar clave, y luego haciendo clic en Desactivar y cambiar esta clave.
- Para desactivar la clave sin regenerar una nueva, haz clic en el menú desplegable Acciones, pasa el cursor por encima de Desactivar clave y luego haz clic en Desactivar esta clave.
Eliminar cuenta de desarrollador
Puedes eliminar las cuentas de desarrollador de aplicaciones si no contienen aplicaciones con instalaciones o fichas de mercado activos. Si tu cuenta tiene aplicaciones con instalaciones o fichas de mercado activos y te gustaría eliminar tu cuenta, ponte en contacto con asistencia técnica para obtener ayuda. Una vez que eliminas tu cuenta, ya no podrás acceder a esa cuenta. Si puedes alternar entre varias cuentas de HubSpot, la cuenta eliminada ya no aparecerá. En tu cuenta de desarrollador de la API de HubSpot, haz clic en el nombre de tu cuenta en la esquina superior derecha y luego haz clic en Cuenta.
