En esta sección, se describen algunos problemas habituales que puedes encontrar durante la compilación y prueba de apps de Chat.
Un mensaje de tarjeta, un diálogo o una vista previa de vínculo no se renderiza o no funciona como se espera
Si necesitas ayuda para solucionar problemas relacionados con las tarjetas, consulta Cómo solucionar problemas y corregir tarjetas.
La app no responde
Si envías un mensaje a la app de Chat y esta 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 En vivo: Disponible para los usuarios.
En Funciones interactivas, asegúrate de que la configuración sea adecuada para la funcionalidad de la app. Si tu app de Chat interactúa con los usuarios, asegúrate de activar Habilitar funciones interactivas:
- Si tu app responde a mensajes, asegúrate de seleccionar Recibir mensajes 1:1.
- En Configuración de la conexión, asegúrate de que la URL de la app, 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, la configuración de visibilidad no es necesaria porque la configuración de Google Workspace Marketplace tiene prioridad.
Si la app está publicada 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 las apps de Chat sin una cuenta de Google Workspace. Si quieres obtener más información sobre cómo los usuarios descubren e instalan apps de Chat, consulta Cómo publicar apps de Google Chat.
Se puede excluir a los usuarios 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, no puedan unirse a un espacio o 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 forzado a nivel de la organización.
Por ejemplo, si el parámetro de configuración del historial de Chat de un usuario está "activado" de manera forzosa y el de un espacio tiene el parámetro de configuración del historial de Chat, este se encuentra desactivado, es posible que ese usuario no pueda unirse al espacio. Además, ese usuario podría quitarse del espacio si se unió antes del conflicto y, luego, publicar un mensaje en el espacio después del conflicto.
En este caso y en otros casos en los que hay conflictos entre la configuración del historial, es posible que la API de Chat no pueda crear una membresía o que la creación de un mensaje con autenticación de usuario 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 Se puede excluir a los usuarios 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 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 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 su lista de entidades permitidas.
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 otorga acceso a una unidad organizativa secundaria, sin habilitarla para la unidad organizativa superior.
Si quieres obtener información para resolver este problema, consulta Permite que los usuarios instalen apps de Chat.
Soluciona errores de Cloud Function
Si la app de Chat se implementa con Cloud Functions y no funciona, puedes usar las siguientes secciones para solucionar el problema.
Verifica los registros de Cloud Function
Como primer paso, revisa los registros de Cloud Functions en busca de errores.
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 haz clic en Mostrar acciones > Ver registros.
El Explorador de registros abre y ejecuta una consulta que muestra los registros de la Cloud Function, incluidos los errores.
Si la información predeterminada que se registra no es suficiente para depurar la app, puedes agregar registros adicionales desde el código de la Cloud Function. Consulta Visualiza y escribe registros de Cloud Functions.
Verifica los errores de Cloud Function
Además de los registros, la Cloud Function también puede informar errores detectados durante la 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 muestran en Errores.
Para solucionar otro error, haz clic en él.
Corrige errores comunes de Cloud Function
Los siguientes errores a veces se encuentran 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 implementas 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 hay otra función de Cloud Functions con 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
la Cloud Function, no la URL del activador de la Cloud Function preexistente.
Uno o más usuarios que se indican 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 a la app de Chat, verás un error que indica que la app no responde porque Google Chat no puede acceder al servidor que aloja la Cloud Function. Este mensaje significa que un usuario llamado “allUsers” no tiene permiso para llamar a la función de Cloud Functions.
Dar a “allUsers” la función “Invocador de Cloud Functions” significa que la función de Cloud Functions que impulsa la app está disponible de forma pública y accesible sin autenticación. Para obtener más información sobre cómo asignar un rol, consulta
Cómo otorgar un solo rol.
Este error puede significar que el proyecto de Google Cloud tiene una restricción 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 no autenticadas. Si quieres aprender a permitir invocaciones no autenticadas para una Cloud Function existente, consulta Permite el acceso público (sin autenticar).