En esta sección, se describen los problemas comunes que puedes encontrar cuando compilas y pruebas apps de chat.
Un mensaje de tarjeta, un diálogo o una vista previa del vínculo no se renderizan o no funcionan como se espera
Si necesitas ayuda para solucionar errores de tarjetas, consulta Cómo solucionar problemas y corregir tarjetas.
La app no responde
Si envías un mensaje a la app de Chat y responde “La app no responde”, verifica la configuración de la app de Chat:
En la consola de Google Cloud, haz clic en Menú. > Más productos > Google Workspace > Biblioteca de productos > API de Google Chat > Administrar > Configuración.
En Estado de la app, asegúrate de haber seleccionado Publicada: Disponible para los usuarios.
En Funciones interactivas, asegúrate de que la configuración sea adecuada para las funciones de tu app. Si tu app de Chat interactúa con los usuarios, asegúrate de activar Habilitar funciones interactivas de la siguiente manera:
- Si la app responde mensajes, asegúrate de seleccionar Recibir mensajes 1:1.
- En Configuración de la conexión, asegúrate de que la URL del extremo HTTP, el ID de implementación del proyecto de Apps Script, el Nombre del tema de Cloud Pub/Sub o el agente de Dialogflow estén configurados correctamente y de que se haya implementado.
- En Visibilidad, asegúrate de que los usuarios adecuados tengan acceso a la app con una dirección de correo electrónico o un grupo en el dominio de Google Workspace. Si la app se implementa con el SDK de Google Workspace Marketplace, la configuración de visibilidad no es necesaria porque la configuración de Google Workspace Marketplace tiene prioridad.
Si la app se publica con el SDK de Google Workspace Marketplace, revisa la configuración de Google Workspace Marketplace.
Haz clic en Guardar.
Vuelve a enviar un mensaje a la app.
La API de Google Chat solo está disponible para usuarios de Google Workspace
Cuando configures la app de Chat, es posible que recibas el error Google Chat API is only available to Google Workspace users
. Este mensaje significa que la Cuenta de Google que usaste para configurar la API de Chat no forma parte de una organización de Google Workspace. Para compilar una app de Chat o usar la API de Chat, debes usar una cuenta de Google Workspace.
Ten en cuenta que los usuarios de Google Chat pueden usar las apps de Chat sin una cuenta de Google Workspace. Para obtener más información sobre cómo los usuarios descubren e instalan apps de Chat, consulta Cómo publicar apps de Google Chat.
Los usuarios se pueden excluir de los espacios
Si un administrador de Google Workspace no permite que los usuarios activen o desactiven el historial de chat, es posible que, en ocasiones, los usuarios no puedan unirse a un espacio ni permanecer en él debido a un conflicto entre un parámetro de configuración a nivel del usuario que fuerza o desactiva el historial de chat y un espacio que hereda el parámetro de configuración forzada a nivel de la organización.
Por ejemplo, si un usuario tiene un parámetro de configuración del historial de chat que se activa de manera forzosa Si un espacio tiene un parámetro de configuración del historial de Chat que se desactivó de manera forzosa, es posible que ese usuario no pueda unirse al espacio. Además, es posible que se quite a ese usuario del espacio si se unió antes del conflicto y, luego, publica un mensaje en él después de este.
En este caso y en otros en los que haya conflictos entre la configuración del historial, es posible que la API de Chat no pueda crear una membresía o que, si se crea un mensaje con autenticación del usuario, se quite del espacio al usuario autenticado con un parámetro de configuración de historial de Chat en conflicto.
Para obtener más información, consulta Cómo excluir a los usuarios de los espacios en el Centro de ayuda para administradores de Google Workspace.
Soluciona problemas relacionados con el servicio de chat avanzado en Google Apps Script
Consulta la página de Apps Script sobre el servicio de Chat avanzado.
Los usuarios no pueden agregar una app de Chat a un espacio
Si los usuarios ven el mensaje de error
This organization's administrator must allow users to install this Chat app
Cuando intentas agregar una app de Chat a un espacio, este error
puede deberse a alguno de los siguientes motivos:
- La organización inhabilitó las apps de Chat.
- La organización no agregó esta app de chat específica a la lista de entidades permitidas.
Si un usuario encuentra este mensaje de error cuando intenta interactuar con una app de Chat, es posible que la organización le otorgue acceso a una unidad organizativa secundaria sin habilitarlo para la unidad organizativa superior.
Para obtener información sobre cómo resolver este problema, consulta Permite que los usuarios instalen apps de Chat.
El administrador debe otorgar a la app el alcance de autorización de OAuth necesario para esta acción.
Cuando te autentiques como una app de chat, es posible que recibas el siguiente error:
<HttpError 403 when requesting https://chat.googleapis.com/v1/spaces/{space}?alt=json returned "The administrator must grant the app the required OAuth authorization scope for this action.". Details: "The administrator must grant the app the required OAuth authorization scope for this action.">
Este mensaje de error significa que un administrador de Google Workspace aún no otorgó la aprobación única a la app de Chat para usar los permisos de autorización que comienzan con el nombre https://www.googleapis.com/auth/chat.app.*
.
Para solucionar el error, sigue estos pasos:
- Pídele al administrador de Google Workspace que
otorgar aprobación a tu app de Chat.
Cuando manejes este error en la lógica de tu app de Chat,
considera enviar un mensaje para anunciar que
La app de Chat necesita la aprobación del administrador para realizar
la acción solicitada, por ejemplo:
To perform this action, I need approval. <https://support.google.com/a?p=chat-app-auth|Learn more>.
- Si el método de la API de Chat admite
permiso de la autorización
https://www.googleapis.com/auth/chat.bot
, que no requieren la aprobación del administrador, considera su uso en su lugar. Para verificar qué permisos de autorización admite un método, consulta Autentica y autoriza las solicitudes a la API de Google Chat y la app de Chat.
Soluciona problemas de Cloud Function
Si la app de Chat se implementó con Cloud Functions y no funciona, las siguientes secciones te ayudarán a solucionar el problema.
Verifica los registros de Cloud Function
Como primer paso, verifica si hay errores en los registros de Cloud Functions.
En la consola de Google Cloud, ve a la página Cloud Functions.
Para abrir los registros, busca la Cloud Function de tu app de Chat y, luego, haz clic en Mostrar acciones > Ver registros.
El Explorador de registros abre y ejecuta una consulta que muestra los registros de Cloud Function, incluida la errores.
Si la información registrada de forma predeterminada no es suficiente para depurar tu app, puedes agregar registros adicionales desde el código de Cloud Function. Consulta Visualiza y escribe registros de Cloud Function.
Verifica los errores de Cloud Function
Además de los registros, Cloud Function también puede informar errores encontrados en ejecución.
En la consola de Google Cloud, ve a la página Cloud Functions.
Haz clic en la Cloud Function de tu app de chat.
En la página Detalles de la función, los errores se enumeran en Errores.
Para solucionar un error, haz clic en él.
Cómo solucionar errores comunes de Cloud Function
A veces, se producen los siguientes errores cuando se compila una app de chat con Cloud Functions.
La función ChatApp en la región REGION_NAME
en el proyecto PROJECT_NAME
ya existe
Cuando implementes una Cloud Function, es posible que recibas el error Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists
. Este mensaje significa que otra Cloud Function tiene el mismo nombre que la que vas a implementar. Cambia el nombre y
volver a implementar la función. Verifica que la app de Chat use la URL del activador de
tu Cloud Function, no la URL del activador de la Cloud Function preexistente.
Uno o más usuarios que se mencionan en la política no pertenecen a un cliente permitido.
Cuando implementas una Cloud Function, es posible que recibas el error The operation
cannot be completed on the function: "One or more users named in the policy do
not belong to a permitted customer."
. Si recibes este error y, luego, envías un mensaje
Chat, aparece un error que dice que la app no responde porque Google
Chat no puede conectarse con el servidor que aloja la Cloud Function. Este mensaje significa que un usuario llamado "allUsers" no tiene permiso para llamar a la Cloud Function.
Si otorgas a "allUsers" el rol de "Invocador de Cloud Functions", la Cloud
Function que potencia la app estará disponible de forma pública y se podrá acceder a ella sin
autenticación. Para saber cómo asignar un rol, consulta
Otorga un solo rol.
Este error puede significar que el proyecto de Google Cloud tiene restricciones de dominio. Para obtener más información sobre las restricciones de restricción de dominio, consulta Restringe identidades por dominio.
Para resolver este problema, verifica que tu Cloud Function permita invocaciones sin autenticación. Para obtener información sobre cómo permitir invocaciones no autenticadas para una Cloud Function existente, consulta Permite el acceso público (no autenticado).