Integración completa con la bandeja de Gmail vía API
En este tutorial vas a aprender cómo generar las credenciales necesarias en Google Cloud para integrar una bandeja de Gmail con Ventry mediante la API oficial de Google. Al finalizar obtendrás el Client ID y el Client Secret que luego deberás enviar al equipo de soporte para completar la integración.
Crear un proyecto en Google Cloud
Ingresá a Google Cloud Console.
Creá un nuevo proyecto.
Asignale un nombre descriptivo, por ejemplo:
Ventry Gmail Integración
Esperá a que el proyecto se cree.
Seleccioná el nuevo proyecto.
Es importante verificar que el proyecto aparezca seleccionado antes de continuar.
Configurar la pantalla de consentimiento OAuth
Ingresá a APIs y Servicios.
Seleccioná Pantalla de consentimiento OAuth.
Presioná Comenzar.
Completá la información solicitada:
Nombre de la aplicación.
Correo electrónico que se va a integrar con Ventry.
Seleccioná Externo como tipo de usuario.
Agregá nuevamente el mismo correo electrónico como contacto.
Finalizá el asistente.
Agregar el usuario autorizado
Una vez creada la pantalla de consentimiento:
Ingresá nuevamente a la configuración de la pantalla OAuth.
En la sección Usuarios de prueba agregá el correo electrónico que vas a integrar.
Guardá los cambios.
No es necesario publicar la aplicación.
Debe mantenerse como aplicación de uso interno para esta integración.
Habilitar la API de Gmail
Volvé a APIs y Servicios.
Ingresá a Biblioteca o APIs habilitadas.
Buscá Gmail API.
Presioná Habilitar.
La API debe quedar activa antes de crear las credenciales.
Crear las credenciales OAuth
Ingresá nuevamente a APIs y Servicios.
Seleccioná Credenciales.
Creá un nuevo Cliente OAuth.
Elegí el tipo Aplicación web.
Asignale un nombre, por ejemplo:
Ventry Integración Gmail
Configurar la URL de redireccionamiento
Durante la creación del Cliente OAuth:
Buscá la sección URI de redireccionamiento autorizados.
Pegá la Callback URL recibida por correo durante el proceso de integración con Ventry.
Importante:
No colocar la URL en Orígenes autorizados de JavaScript.
Debe agregarse únicamente en URI de redireccionamiento autorizados.
Obtener las credenciales
Una vez creada la aplicación, Google mostrará:
Client ID
Client Secret
Copiá ambos valores.
Estos serán necesarios para completar la integración.
Enviar la información al soporte de Ventry
Una vez obtenidos:
Client ID
Client Secret
Respondé el correo recibido durante el proceso de integración y pegá ambas credenciales.
Luego comunicate con el equipo de soporte de Ventry para que finalicen la configuración.
Recomendaciones y buenas prácticas
Verificá siempre que estés trabajando sobre el proyecto correcto.
Utilizá el mismo correo electrónico durante toda la configuración.
No publiques la aplicación OAuth; mantenela como aplicación de prueba.
Agregá el correo que vas a integrar como usuario de prueba antes de continuar.
Habilitá únicamente la API de Gmail necesaria para esta integración.
Pegá la Callback URL únicamente en los URI de redireccionamiento autorizados.
Guardá el Client ID y el Client Secret en un lugar seguro.
No compartas estas credenciales con terceros; únicamente deben enviarse al equipo de soporte de Ventry para completar la integración.
