Espacios de Chat de Google

  # Integración de Google Chat para Botpress

Esta integración te permite conectar tu chatbot de Botpress con los espacios de Google Chat , permitiendo una comunicación fluida entre tu bot y los usuarios de Google Chat .

## Características

- Envío y recepción de mensajes en espacios de Google Chat 
- Gestión automática de mensajes y respuestas
- Compatibilidad con varios espacios de Google Chat 
- Autenticación segura mediante la cuenta de servicio de Google

## Requisitos previos

1. Una cuenta de Google Cloud Platform (GCP)
2. Un espacio de Google Chat en el que quieras desplegar tu bot
3. Una instancia de Botpress con la integración de Google Chat instalada

## Instrucciones de instalación

### 1. Habilitar Google Chat API

1. Vaya a [Google Cloud Console](https://console.cloud.google.com)
2. 2. Vaya a "APIs & Services" > "Library" (Biblioteca)
3. 3. Busca "Google Chat API".
4. Haga clic en la API de Chat de Google
5. Haga clic en "Habilitar" para activar la API para su proyecto

### 2. Crear una cuenta de servicio de Google

1. Vaya a [Google Cloud Console](https://console.cloud.google.com)
2. Crea un nuevo proyecto o selecciona uno ya existente
3. Navega hasta "IAM & Admin" > "Cuentas de servicio"
4. 4. Haga clic en "Crear cuenta de servicio
5. Rellene los detalles de la cuenta de servicio y haga clic en "Crear"
6. Cree una nueva clave para la cuenta de servicio:
   - Haga clic en la cuenta de servicio
   - Vaya a la pestaña "Claves
   - Haga clic en "Añadir clave" > "Crear nueva clave"
   - Elija el formato JSON
   - Descargue el archivo de clave

### 3. Configurar los ajustes de Google Chat App

1. Vaya a [Google Cloud Console](https://console.cloud.google.com)
2. 2. Vaya a "APIs & Services" > "Google Chat API".
3. Haz clic en "Configuración"
4. Configura tu app con los siguientes ajustes:
   - Nombre de la aplicación Elige un nombre para tu bot
   - **Descripción**: Añade una descripción de la funcionalidad de tu bot
   - URL del avatar**: Añade una URL para la imagen de avatar de tu bot.
   - Funciones**:
     - Habilitar características interactivas
     - Activar la recepción de mensajes 1-1
     - Permitir unirse a espacios y conversaciones de grupo
   - URL de punto final HTTP**: Establezca esta opción con la URLwebhook  Botpress  que se encuentra en la configuración de la integración con Google Chat .

### 4. Configurar la integración en Botpress

1. En su instancia de Botpress , vaya a la sección Integraciones
2. Busca y selecciona la integración de Google Chat 
3. Configura los siguientes ajustes:
   - Cuenta de servicio JSON**: Pega todo el contenido del archivo de claves de tu cuenta de servicio descargado
   - Espacio predeterminado**: Introduzca el ID de su espacio predeterminado de Google Chat (opcional)

### 5. Añade el bot a tu espacio de Chat de Google

1. Abre tu espacio de Google Chat 
2. Haz clic en el nombre del espacio para abrir los detalles del espacio
3. Ve a "Aplicaciones e integraciones".
4. Haga clic en "Añadir apps"
5. Busca tu bot utilizando el correo electrónico de la cuenta de servicio
6. Añade el bot a tu espacio

## Uso

### Envío de mensajes

El bot puede enviar mensajes a cualquier espacio de Google Chat al que se haya añadido. Los mensajes pueden ser enviados
- En respuesta a mensajes de usuarios
- Proactivamente a través del editor de flujo de Botpress 
- A través de llamadas a la API desde tu código personalizado

### Recepción de mensajes

El bot recibe y procesa automáticamente los mensajes enviados en el espacio de Chat Google. Lo hará
- Analizará los mensajes entrantes
- Los procesará a través de sus flujos Botpress 
- Enviar las respuestas adecuadas al espacio

### Formato del mensaje

La integración soporta mensajes de texto en los espacios de Google Chat . Los mensajes pueden incluir:
- Texto sin formato
- Formato básico
- Enlaces
- Menciones

## Consideraciones de seguridad

- Mantenga segura la clave de su cuenta de servicio y nunca la comparta públicamente
- Rote periódicamente las claves de su cuenta de servicio
- Utilice el principio de mínimo privilegio al asignar funciones a su cuenta de servicio.
- Supervise la actividad de su bot y establezca los registros adecuados.

## Solución de problemas

### Problemas comunes

1. **El robot no responde**
   - Compruebe que la cuenta de servicio tiene los permisos correctos
   - Compruebe si el bot está correctamente añadido al espacio
   - Compruebe que la integración está correctamente configurada en Botpress

2. **Errores de autenticación
   - Comprobar que el JSON de la cuenta de servicio está correctamente formateado
   - Compruebe si la clave de la cuenta de servicio es válida y no ha caducado
   - Compruebe que la cuenta de servicio tiene habilitados los ámbitos de API necesarios

3. **Problemas de entrega de mensajes
   - Verificar que el ID del espacio es correcto
   - Compruebe si el bot tiene permiso para publicar en el espacio
   - Asegúrese de que el formato del mensaje es válido

## Referencia API

Para obtener más información sobre la API de Chat Google, consulta la [documentación oficial](https://developers.google.com/chat/api/reference/rest).