Google

2 min de lectura

Google conecta Gmail, Calendar y Drive a tus agentes. Antes de añadir cuentas, configura una aplicación de Google Cloud para la organización. Esta aplicación se reutiliza para todas las cuentas que conectes después.

Configurar la aplicación

Abre Ajustes > Google en Kujira. Allí encontrarás la URL de redirección y los permisos que debes configurar en Google Cloud.

Abrir ajustes de Google en Kujira

Crea el proyecto

En Google Cloud, crea un proyecto y configura su pantalla de consentimiento.

Define la audiencia y los permisos

Elige audiencia interna para un Google Workspace propio o externa si conectarás cuentas personales o de terceros. En la pantalla de consentimiento, añade los cinco permisos que muestra Kujira.

Crea el cliente OAuth

Crea un cliente de tipo aplicación web y añade la URL de redirección que muestra Kujira.

Abrir credenciales OAuth en Google Cloud

Guarda las credenciales

Copia el ID de cliente y el secreto en Ajustes > Google.

Permisos que necesita Kujira

La sección Permisos de Ajustes > Google permite copiar la lista completa. Añádelos tal cual en la pantalla de consentimiento de Google Cloud:

Identificación

openid y email identifican la cuenta que autoriza la conexión.

Gmail Restringido

https://mail.google.com/ permite leer, enviar y gestionar correo con la cuenta autorizada.

Calendario

https://www.googleapis.com/auth/calendar permite consultar y modificar calendarios y eventos.

Drive Restringido

https://www.googleapis.com/auth/drive permite acceder a los archivos de Drive según los permisos de la cuenta conectada.

Aplicaciones externas en pruebas

Si la aplicación está en modo de pruebas, añade como usuarios de prueba las cuentas que vayas a conectar. Google puede exigir una nueva autorización periódica mientras la aplicación no esté publicada.

Permisos restringidos

Los permisos de Gmail y Drive son restringidos. Si publicas una aplicación externa, Google puede exigir su validación antes de que usuarios ajenos a tu organización puedan autorizarla.

Conectar cuentas y asignarlas

Conecta cada cuenta desde Conectores o al configurar el canal del agente. Después asígnala únicamente a los agentes que deban utilizarla y selecciona los calendarios, etiquetas o carpetas que deben vigilar.

Servicio	Eventos que puede recibir	Acciones de la cuenta autorizada
Gmail	Correos filtrados por remitente o etiqueta.	Leer, enviar y gestionar correo.
Calendar	Eventos creados, modificados, cancelados y recordatorios.	Consultar y modificar calendarios y eventos.
Drive	Cambios en la carpeta seleccionada.	Leer, subir, editar y compartir archivos según los permisos de la cuenta.

Los filtros controlan los eventos que llegan al agente; no restringen el alcance que Google ha concedido a la cuenta.

Mantener la conexión

Si sustituyes la aplicación de Google, las cuentas deberán volver a autorizarse. Cuando un canal pierda conexión, comprueba que la cuenta sigue autorizada, que el canal está activo y que la aplicación tiene los permisos necesarios.