Descripción general de la creación de aplicaciones

Las aplicaciones te permiten autenticar llamadas de API a tu cuenta de HubSpot, suscribirte a eventos con webhooks y extender la interfaz de usuario de HubSpot, como con 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.

Dependiendo del tipo de integración que desees construir, deberás elegir el tipo correcto de aplicación. A continuación, descubre más información sobre los tipos de aplicaciones que puedes crear y las funcionalidades que admiten.

Para las extensiones de creación, ve la tabla de referencia a continuación para obtener una descripción rápida de qué extensiones se pueden construir con qué tipos de aplicaciones.

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. 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.
• Importa registros del CRM desde un archivo CSV.
• Autenticar solicitudes de API en acciones de automatización personalizadas y bots de chat.
• Crea y edita suscripciones a webhook.

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. Más información sobre cuándo crear aplicaciones privadas.

Si este tipo de aplicación se adapta a tus necesidades, empieza a crear una aplicación privada en tu cuenta de HubSpot.

Las aplicaciones privadas creadas con proyectos permiten crear extensiones de interfaz de usuario para registros del CRM. La diferencia al crear una aplicación privada a través de este método es que los proyectos solo admiten la creación de extensiones de interfaz de usuario, las cuales no pueden crear las aplicaciones privadas fuera de los proyectos.

Si este tipo de aplicación se ajusta a tus necesidades, echa un vistazo a la guía de inicio rápido de proyectos para comenzar a crear una aplicación privada y un proyecto utilizando la CLI.

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 línea de tiempo personalizados en registros del CRM usando la API de eventos de línea de tiempo. 
• Crear páginas de configuración de aplicaciones personalizadas en HubSpot. 

Las aplicaciones públicas se autentican con OAuth y se pueden anunciar en el Mercado de aplicaciones de HubSpot. Más información sobre cuándo crear aplicaciones públicas.

Si este tipo de aplicación se ajusta a tus necesidades, comienza a crear una aplicación pública en tu cuenta de desarrollador 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 listar aplicaciones en el mercado de aplicaciones.
• Prueba las cuentas destinadas a probar las API y las aplicaciones que estás creando sin afectar los datos en una cuenta real de HubSpot. Esto es independiente de una cuenta de entorno de pruebas que puedes crear dentro de las cuentas estándar de HubSpot.

Más información sobre los tipos de cuenta de HubSpot.

Si quieres crear una integración personalizada con una sola cuenta de HubSpot, puedes crear una aplicación privada y usar su token de acceso para autenticar llamadas de 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 la cuenta 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 API de desarrollador se pueden usar para administrar suscripciones para la API de Webhooks, crear o actualizar tipos de eventos para la característica eventos de la línea de tiempo. 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, navega a Aplicaciones en la barra de navegación superior.
• En la parte superior derecha, haz clic en Obtén la clave de API de HubSpot.
• En el cuadro de diálogo, haz clic en Mostrar clave. La clave se revelará y luego puedes hacer clic en Copiar junto a la clave.
• También puedes desactivar la clave de API anterior y generar una nueva haciendo clic en Volver a generar clave.

Puedes eliminar las cuentas de desarrollador de aplicaciones si no contienen aplicaciones con instalaciones o anuncios de mercado activos. Si tu cuenta tiene aplicaciones con instalaciones o anuncios 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.

Haz clic en Eliminar cuenta. Si tu cuenta tiene aplicaciones con instalaciones o anuncios activos en el mercado, este botón estará desactivado.

En el cuadro de diálogo, escribe el ID de tu cuenta y luego haz clic en Eliminar cuenta de desarrollador