En esta sección, se describen los problemas comunes que puedes encontrar mientras compilas y pruebas apps de Chat.
Una tarjeta, un diálogo o una vista previa de un vínculo no se renderizan ni funcionan como se espera
Si necesitas ayuda para solucionar problemas con las tarjetas, consulta Soluciona problemas y corrige tarjetas.
La app no responde
Si le 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 APIs de Google, haz clic en Menú > APIs y servicios > APIs y servicios habilitados > API de Google Chat > Configuración.
En Estado de la app, asegúrate de haber seleccionado En vivo: disponible para los usuarios.
En Funciones interactivas, asegúrate de que la configuración sea adecuada para la funcionalidad de tu app. Si tu app de Chat interactúa con los usuarios, asegúrate de activar Habilitar funciones interactivas:
- De forma predeterminada, las apps pueden responder a los mensajes directos de los usuarios.
- Si tu app responde a mensajes en espacios y chats grupales, selecciona Unirse a espacios y conversaciones grupales.
- En Connection settings, 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 que se hayan 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, no es necesario configurar la visibilidad, ya que 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.
Intenta enviar un mensaje a la app nuevamente.
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 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 Compila apps interactivas de Google Chat.
Los usuarios pueden quedar excluidos 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 o permanecer en él debido a un conflicto entre una configuración a nivel del usuario que obliga a activar o desactivar el historial de chat y un espacio que hereda la configuración forzada a nivel de la organización.
Por ejemplo, si un usuario tiene una configuración del historial de Chat forzada como "activada" y un espacio tiene una configuración del historial de Chat forzada como "desactivada", es posible que ese usuario no pueda unirse al espacio. Además, es posible que se quite al usuario del espacio si se unió antes del conflicto y, luego, publica un mensaje en el espacio después del conflicto.
En esta situación y en otras en las que hay conflictos entre la configuración del historial, es posible que la API de Chat no pueda crear una membresía, o bien que la creación de un mensaje con la autenticación del usuario quite del espacio al usuario autenticado con una configuración del historial de Chat en conflicto.
Para obtener más información, consulta Los usuarios pueden quedar excluidos de los espacios en el Centro de ayuda para administradores de Google Workspace.
Soluciona problemas del 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 encuentran el mensaje de error
This organization's administrator must allow users to install this Chat app
cuando intentan agregar una app de Chat a un espacio, este error
puede deberse a uno 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 de la organización.
Si un usuario encuentra este mensaje de error cuando intenta interactuar con una app de Chat, es posible que se deba a que la organización otorgó acceso a una unidad organizativa secundaria sin habilitarla para la unidad organizativa superior.
Si necesitas información para 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 requerido 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 alcances de autorización que comienzan con el nombre https://www.googleapis.com/auth/chat.app.*.
Para resolver el error, haz lo siguiente:
- Pídele al administrador de Google Workspace que
apruebe tu app de Chat.
Cuando manejes este error en la lógica de tu app de Chat,
considera enviar un mensaje en el que se anuncie 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 el alcance de autorización
https://www.googleapis.com/auth/chat.bot, que no requiere la aprobación del administrador, considera usarlo en su lugar. Para verificar qué alcances de autorización admite un método, consulta las solicitudes a la API de Google Chat y la app de Chat.
Soluciona problemas de errores de Cloud Functions
Si la app de Chat se implementa con Cloud Functions y no funciona, las siguientes secciones te ayudarán a solucionar el problema.
Verifica los registros de Cloud Functions
Como primer paso, verifica los registros de Cloud Functions para detectar errores.
En la Consola de APIs de Google, ve a la página Cloud Functions.
Para abrir los registros, busca la función de Cloud Functions de tu app de Chat y, luego, haz clic en Mostrar acciones > Ver registros.
Se abrirá el Explorador de registros y se ejecutará una consulta que muestra los registros de Cloud Functions, incluidos los errores.
Si la información predeterminada registrada no es suficiente para depurar tu app, puedes agregar registros adicionales desde el código de Cloud Functions. Consulta Visualiza y escribe registros de Cloud Functions.
Verifica los errores de Cloud Functions
Además de los registros, Cloud Functions también puede informar errores que se producen durante la ejecución.
En la Consola de APIs de Google, ve a la página Cloud Functions.
Haz clic en la función de Cloud Functions de tu app de Chat.
En la página de detalles de la función, los errores se enumeran en Errores.
Para solucionar un error, haz clic en él.
Corrige errores comunes de Cloud Functions
A veces, se producen los siguientes errores cuando se compila una app de Chat con Cloud Functions.
Ya existe la función ChatApp en la región REGION_NAME del proyecto PROJECT_NAME
Cuando implementes una función de Cloud Functions, es posible que recibas el error Function
ChatApp in region REGION_NAME in project PROJECT_NAME already
exists. Este mensaje significa que otra función de Cloud Functions tiene el mismo nombre que la que estás implementando. Cambia el nombre y vuelve a implementar la función. Verifica que la app de Chat use la URL del activador de tu función de Cloud Functions, no la URL del activador de la función de Cloud Functions preexistente.
Uno o más usuarios mencionados en la política no pertenecen a un cliente permitido
Cuando implementes una función de Cloud Functions, 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, le envías un mensaje a la
app de Chat, obtendrás un error que indica que la app no responde porque Google
Chat no puede comunicarse con el servidor que aloja la función de Cloud Functions. Este mensaje significa que un usuario llamado "allUsers" no tiene permiso para llamar a la función de Cloud Functions.
Si le otorgas a "allUsers" el rol de "Invocador de Cloud Functions", significa que la función de Cloud Functions que impulsa la app está disponible públicamente y se puede acceder a ella sin autenticación. Para obtener información sobre 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 dominio, consulta Restringe identidades por dominio.
Para resolver este problema, verifica que tu función de Cloud Functions permita invocaciones no autenticadas. Para obtener información sobre cómo permitir invocaciones no autenticadas para una función de Cloud Functions existente, consulta Permite el acceso público (no autenticado).