Integración · Canales
Conectar Google Chat a Igniten
Conecte Google Chat para que su equipo le pregunte a Igniten en un mensaje directo o dentro de un espacio de Chat, sin salir de donde ya trabaja. Google Chat no se conecta por separado: usa la misma autorización que Google Workspace, hecha una sola vez a nivel del dominio.
Si Google Workspace ya está conectado, el registro es el mismo: lo propio de Google Chat son los permisos de abajo. La ficha de Google Workspace tiene el resto.
Qué lee Igniten, y qué no
Lee
- Mensajes de los espacios de Google Chat
No lee
- Los mensajes de Chat que se editaron o borraron después de leerlos: la API de Google no avisa de ediciones ni de borrados
Cómo se conecta
5 pasos · ≈ 15 min
-
Elegir el proyecto en Google Cloud
Un proyecto es el cajón donde Google guarda lo de Igniten. Puede ser uno nuevo o uno que ya tengan.
- Puede usar un proyecto que ya tengan o crear uno nuevo; si tiene dudas, cree uno nuevo y llámelo «Igniten».
- Tiene que ser un proyecto de la organización de su empresa, no uno personal.
- Anote el nombre: los pasos siguientes ocurren adentro de ese proyecto.
Salió bien si El nombre del proyecto aparece arriba, en la barra de Google Cloud.
-
Encender lo que Igniten va a leer
Drive, Gmail, Calendar, Meet, Chat, el directorio de personas y, si las va a usar, Sheets, Tasks, Contactos y Forms.
- Google Drive API
- Gmail API
- Google Calendar API
- Google Meet API
- Google Chat API
- Admin SDK API
- Google Sheets API
- Google Tasks API
- People API
- Google Forms API
- Se encienden desde «APIs y servicios → Biblioteca», buscando cada una por nombre.
- Encienda solamente las de las fuentes que vaya a usar: cada una corresponde a una.
- Las cuatro últimas son para leer planillas (Sheets), tareas (Tasks), contactos («People API» es el nombre que Google le da a Contactos) y respuestas de formularios (Forms). Si no las va a usar, saltéelas.
- Encender una API no le da acceso a nadie todavía; eso es el paso 4.
Salió bien si Cada API de la lista figura como habilitada en «APIs y servicios».
-
Crear la identidad de Igniten
Una cuenta de servicio con su clave. La clave se carga acá y no vuelve a salir.
- Es una cuenta de servicio: una identidad de la aplicación, no de una persona.
- Al crear la clave, Google descarga un archivo JSON. Ese archivo es el secreto.
- Anote el identificador de cliente («Client ID») de la cuenta: hace falta en el paso 4.
Salió bien si El panel acepta el archivo y muestra sólo los últimos cuatro caracteres.
-
Autorizarla en su Workspace
Es el único paso que se hace en el panel de administración, no en Cloud. Necesita ser administrador del dominio.
admin.google.com → Security → Access and data control → API controls → Manage Domain-Wide Delegation → Add new- Este paso se hace en admin.google.com, no en Google Cloud: son dos consolas distintas y hace falta ser superadministrador.
- Se pega el identificador de cliente de la cuenta de servicio y la lista de permisos separados por comas. Igniten arma esa lista por usted: sólo trae los permisos de escritura (agregar filas, crear tareas) si su empresa contrató las acciones.
- El correo que se carga acá tiene que ser de un administrador activo del dominio.
Salió bien si La delegación figura en la tabla con el identificador de cliente correcto.
-
Probar que anda
Leemos un archivo, un correo y un evento de prueba. No guardamos nada.
- Leemos un archivo, un correo y un evento de prueba para comprobar que la delegación quedó bien.
- Si falta un permiso, le decimos cuál y qué fuente deja de andar sin él.
- No se guarda nada de lo que devuelva la prueba.
Salió bien si La prueba dice «anduvo» y no nombra ningún permiso faltante.
Qué permisos pide
| Permiso | Para qué | Cuándo hace falta |
|---|---|---|
https://www.googleapis.com/auth/chat.spaces.readonly | Responder sobre las conversaciones de Chat | Si Google Chat se autoriza a nivel del dominio |
https://www.googleapis.com/auth/chat.messages.readonly | Responder sobre las conversaciones de Chat | Si Google Chat se autoriza a nivel del dominio |
https://www.googleapis.com/auth/chat.memberships.readonly | Saber quién está en cada conversación de Chat | Si Google Chat se autoriza a nivel del dominio |
https://www.googleapis.com/auth/chat.messages.create | Escribir un mensaje de Chat en su nombre | Siempre |
https://www.googleapis.com/auth/chat.spaces.create | Abrir una conversación de Chat en su nombre | Siempre |
https://www.googleapis.com/auth/chat.bot | Contestar en Google Chat | Siempre |
Los dos niveles de permiso que recomendamos, y qué habilita cada uno, están en Permisos recomendados.
Los límites, dichos
- Las ediciones y los borrados de Google Chat no se detectan.