- Haz clic en la pestaña Autenticación para ver tu ID de cliente y tu secreto de cliente, así como los alcances asignados de la aplicación. Necesitarás esta información para iniciar una conexión de OAuth entre tu aplicación y HubSpot.
- En la pestaña Autentificación, haz clic en el menú desplegable Alcances en la parte inferior de la página para agregar nuevos alcances a tu aplicación. Estos alcances obligatorios deben incluirse en el parámetro
scope=de tu URL de autorización o los usuarios recibirán un error al intentar autorizar tu aplicación. Ver los documentos de OAuth para obtener más información sobre cómo crear tu URL de autorización y usar alcances.
- Observa el campo Redireccionar URL. Aquí es donde se enviarán usuarios después de otorgar acceso a tu aplicación a su cuenta de HubSpot. Si no incluyes una URL de redireccionamiento, los usuarios recibirán un error de conexión. Las URL de redireccionamiento deben usar HTTPS, a menos que estén en el localhost.
Con tu aplicación creada, ahora puedes recorrer el proceso de instalación.
Instalar una aplicación puede dividirse en dos pasos: autorización y generación de tokens.
Autorizar tu aplicación con una cuenta de cliente
- Para autorizar tu aplicación con una cuenta de HubSpot, deberás crear una URL de autorización. Haz esto al obtener el ID del cliente para tu aplicación e iniciar el proceso de OAuth.
- Una vez que tu URL esté lista, ábrela en tu navegador para ver una lista de todas tus cuentas de HubSpot. Esto también es lo que verán los usuarios una vez que comienzas a dirigirlos a esta URL.
- Selecciona la cuenta donde deseas instalar tu aplicación.
- Después de elegir una cuenta, recibirás una lista de alcances basados en los parámetros
&scopes=y&optional_scope=que configuraste para la URL de autorización.
- Haz clic en Autorizar acceso para autorizar la conexión.
- Después de otorgar acceso, se te redireccionará según el parámetro
&redirect_uri=en la URL de autorización original y un parámetro?code=se anexará a la URL. Usa ese código en el siguiente paso para generar un token de acceso.
Generar los tokens OAuth iniciales
Para generar tus tokens de acceso inicial y de actualización, necesitaras el código del parámetro ?code= de la URL de autorización, redirect_url, ID de cliente y secreto del cliente. Las instrucciones detalladas están aquí.
Una vez que hayas autorizado tu aplicación y de que hayas generado el token inicial, la instalación estará completa. Se incluirá en la página Aplicaciones conectadas y comenzarás a recibir solicitudes de búsqueda de webhook y Tarjetas de CRM.
Puedes encontrar el ID de una aplicación pública en tu cuenta de desarrollador de aplicaciones utilizando cualquiera de los siguientes métodos:
- En tu cuenta de desarrollador, navega a Aplicaciones en la barra de navegación principal y luego ve el ID de la aplicación que aparece debajo del nombre de tu aplicación.
- En tu cuenta de desarrollador, navega a Aplicaciones en la barra de navegación principal y luego haz clic en el nombre de la aplicación. En la página Información básica, haz clic en la pestaña Autenticación y luego ve el ID de la aplicación.
HubSpot registra todas las solicitudes realizadas desde o hacia una aplicación conectada, incluidas las solicitudes entrantes usando un token de acceso OAuth o las solicitudes salientes de webhooks o tarjetas de CRM.
Para ver este registro de solicitud:
- En tu cuenta de desarrollador, ve a Aplicaciones en la barra de navegación principal.
- Haz clic en el nombre de la aplicación.
- En el menú de la barra lateral izquierda, navega a Monitorización.
- Usa las pestañas para ver los diferentes tipos de solicitudes que se realizan desde o hacia la aplicación. Mientras ves estos registros, puedes hacer clic en una solicitud individual para ver más información sobre ella, que incluye:
- para solicitudes exitosas, el método de solicitud, la ruta y el tiempo de solicitud.
- para solicitudes fallidas, información de error adicional, como los encabezados y el cuerpo de la respuesta.
A continuación, obtén más información sobre cada pestaña de la página Monitorización.
- Llamadas de API: la pestaña Llamadas de API muestra todas las solicitudes realizadas a tu aplicación usando un token de acceso OAuth. Se puede filtrar por método HTTP, código de respuesta, período o URL de solicitud.
- Webhooks: la pestaña Webhooks muestra las solicitudes de HubSpot para cualquiera de las suscripciones a webhook de tu aplicación. Filtrar por respuesta (incluyendo tiempos de espera y fallas de conexión), estado (exitoso, volverá a intentar o falla), tipo de suscripción, período de tiempo, intento, lote, evento o ID de cuenta.
Cuando los usuarios de HubSpot instalan una aplicación, consienten en dar acceso al desarrollador de la aplicación a los datos de su cuenta. La identidad y la reputación del desarrollador juegan un papel importante en la decisión de un usuario de continuar con la instalación. Para garantizar el pleno consentimiento del usuario al instalar una aplicación, HubSpot mostrará un mensaje en la pantalla de instalación de la aplicación para indicar el nivel de verificación de la aplicación y el anuncio en el mercado de aplicaciones:
- Cuando una aplicación no tiene un dominio verificado, HubSpot mostrará un banner en la pantalla de instalación que dice que la aplicación no ha sido verificada.
- Cuando la aplicación tiene un dominio verificado pero no aparece en el Mercado de aplicaciones, HubSpot mostrará el dominio verificado junto con un banner en la pantalla de instalación que dice que la aplicación no ha sido revisada o aprobada por HubSpot.
- Cuando una aplicación se anuncia en el mercado, pasando el proceso de revisión de aplicaciones de HubSpot, HubSpot no mostrará ninguno de los banners anteriores. No es necesario que verifiques el dominio si tu aplicación aparece en el Mercado de aplicaciones.
Agregar un dominio verificado
Para agregar un dominio verificado a la aplicación, primero deberás agregar el dominio a la configuración de la aplicación y luego agregar un registro TXT a la configuración de DNS del dominio:
- En tu cuenta de desarrollador de aplicaciones, navega a Aplicaciones.
- Haz clic en el nombre de la aplicación.
- En la barra lateral izquierda, navega a Contacto y asistencia técnica.
- En el campo Dominio de la empresa, escribe tu dominio y luego haz clic en Guardar. Aparecerá un mensaje debajo del dominio de la empresa indicando que el dominio aún no ha sido verificado.
- Haz clic en Verificar ahora para comenzar el proceso de verificación.
- En el panel derecho, confirma que el dominio se ha introducido correctamente y luego haz clic en Siguiente.
- Copia el valor de registro TXT requerido haciendo clic en Copiar en la columna Valor.
- En tu proveedor de DNS, crea un registro TXT con el valor copiado. A continuación, aparecen instrucciones para algunos proveedores de DNS comunes:
- Después de actualizar la configuración de tu DNS, vuelve a HubSpot y luego haz clic en Siguiente en el panel derecho. Los registros DNS pueden tardar hasta 48 horas en actualizarse, por lo que es posible que HubSpot no reconozca el cambio de inmediato. Puedes volver a esta pantalla en cualquier momento seleccionando Verificar ahora de nuevo en la página de configuración Información de la empresa.
- Una vez verificado, verás un indicador de estado de éxito en el campo Dominio de la empresa.
Notas adicionales
- Para garantizar la propiedad continua del dominio, HubSpot continuará verificando que el registro de TXT esté presente de forma regular. La advertencia de instalación volverá si el registro TXT se elimina o modifica.
- Actualmente, solo puedes tener un dominio verificado por cuenta de desarrollador. Todas las aplicaciones en una cuenta comparten el dominio verificado. El dominio en la página de instalación se enlaza con tu dominio raíz.
- Si eliminas tu dominio verificado, todas las aplicaciones de tu cuenta de desarrollador volverán a recibir la advertencia de instalación. Puedes verificar otro dominio, pero el proceso tardará algunas horas.