Cómo configurar Google Chat en Skyone Studio

Visión General

Esta documentación detalla el proceso de configuración de Google Chat como canal de publicación en Skyone Studio. La integración permite que agentes de IA interactúen directamente en la plataforma de Google, utilizando credenciales de cuenta de servicio y la activación de APIs específicas en Google Cloud.

El proceso de configuración se divide entre la consola de Google Cloud y el entorno de Skyone Studio.

Paso a paso

[Paso 01]: Creación y configuración de cuenta de servicio en Google Cloud

[Paso 02]: Generación de la clave JSON

[Paso 03]: Crear cuenta de Google Chat en Skyone Studio

[Paso 04]: Configurar publicación en Google Chat

[Paso 05]: Activación de la Google Chat API

[Paso 06]: Definición de la App y Endpoint

---

Paso 1: Creación y configuración de cuenta de servicio en Google Cloud

1. Acceda a la consola de Google Cloud y seleccione el proyecto deseado.

2. En el menú lateral, navegue hasta API y servicios y haga clic en Credenciales.

3. Haga clic en Crear credenciales y seleccione la opción Cuenta de servicio.

4. En el campo Nombre de la cuenta de servicio, ingrese un nombre adecuado y haga clic en Crear y continuar.

5. En la siguiente etapa, en Permisos, defina los roles. Para ello, en el cuadro de selección busque "Google Chat" y seleccione la opción Propietario de aplicaciones de Chat.

6. Haga clic en la opción Agregar otro rol y agregue Visualizador de aplicaciones de Chat.

7. Haga clic en Continuar.

8. Para finalizar, haga clic en Listo.

Paso 2: Generación de la clave JSON

1. En la lista de cuentas de servicio, haga clic sobre la cuenta recién creada.

2. Acceda a la pestaña Claves.

3. Haga clic en Agregar clave > Crear clave nueva.

4. Seleccione el formato JSON y haga clic en Crear.

Importante: El archivo se descargará automáticamente en su computadora. Guárdelo en un lugar seguro, ya que es esencial para la autenticación en Skyone Studio.

Paso 3: Crear cuenta de Google Chat en Skyone Studio

1. Acceda a Skyone Studio y navegue hasta el menú de Publicar.

2. Seleccione la opción Google Chat y haga clic en Gestionar cuentas.

3. Haga clic en Crear cuenta.

4. En el campo de Clave de la cuenta de servicio, realice la carga del archivo JSON descargado anteriormente.

5. Haga clic en Crear.

Paso 4: Configurar publicación en Google Chat

1. Aún en el área Publicar, seleccione el flujo del agente deseado.

2. En Usuarios y Grupos, seleccione un usuario existente o cree uno nuevo.

3. Haga clic en Guardar publicación.

4. Copie la URL de Webhook que se muestra en la pantalla. Necesitará este dato para los próximos pasos de la integración.

5. Haga clic en Finalizar para terminar el proceso

Paso 5: Activación de la Google Chat API

1. Regrese a la consola de Google Cloud y seleccione el menú APIs y servicios.

2. Verifique si la Google Chat API figura en la lista de servicios activados.

3. Si la API no está visible, haga clic en Habilitar APIs y servicios.

4. Busque "Google Chat API" en el campo de búsqueda y seleccione el resultado correspondiente.

5. Haga clic en Habilitar para activar el recurso.

6. Confirme que la Google Chat API ahora se muestra en su lista de servicios activos para continuar con la integración.

Paso 6: Definición de la App y Endpoint

1. Tras la activación anterior, haga clic en la pestaña Configuración.

2. En Estado de la app, seleccione la opción Activa: disponible para los usuarios.

3. En Información de la aplicación, complete la información básica:

   • Nombre de la app: Defina el nombre que aparecerá en el chat.

   • URL del avatar: Enlace a la imagen de perfil de la aplicación.

   • Descripción: Breve resumen de la funcionalidad del bot.

4. En el campo URL del endpoint de HTTP, pegue la URL generada por Skyone Studio (copiada de la pantalla de publicación del canal).

5. Deje activa la opción Habilitar funciones interactivas.

6. En Configuración de la conexión, seleccione la opción URL del endpoint de HTTP.

7. En Activadores, seleccione la opción Usar una URL del endpoint de HTTP para todos los activadores.

8. En el campo URL del endpoint de HTTP, pegue la URL del paso 4.

9. En Visibilidad, active la opción Permitir que personas y grupos específicos de Skyone instalen esta aplicación de chat.

10. Ingrese los correos electrónicos en el cuadro específico.

11. En Registro, active la opción Registrar errores en Logging (opcional).

12. Haga clic en Guardar.

Alerta: La URL de endpoint es exclusiva para cada publicación. Si cambia esta URL en Google Cloud para un chat que ya está en uso, la conexión actual se interrumpirá de inmediato.