Solucionar problemas de la aplicación de Microsoft Teams

Artículo
10/28/2024

Para solucionar problemas de pestañas

Herramientas de desarrollo de Access

Puede abrir Herramientas de desarrollo en el cliente de Teams para obtener una experiencia similar a la de presionar F12 (en Windows) o Command-Option-I (en MacOS) en un explorador.

Pantalla de tabulación en blanco

Si no ve el contenido en la vista de pestaña, podría ser:

el contenido no se puede mostrar en un objeto <iframe>.
el dominio de contenido no está en la lista validDomains del manifiesto.

Nota:

Aparece una pestaña en blanco cuando la dirección URL de la pestaña especificada redirige a la pantalla de inicio de sesión. Las páginas de inicio de sesión no se representan en iFrames como medida de seguridad contra el secuestro de clics. La lógica de autenticación debe usar un método distinto del redireccionamiento.

Los cambios en mi aplicación web no se reflejan en su pestaña Teams

Si experimenta problemas de almacenamiento en caché coherentes o intermitentes en los que las actualizaciones de la aplicación web no aparecen cuando se hospedan en una pestaña de Teams, compruebe la configuración de la caché del servidor y use Cache-Control encabezados para garantizar el comportamiento deseado del almacenamiento en caché del cliente.

El botón Guardar no está habilitado en el cuadro de diálogo de configuración

Asegúrese de llamar microsoftTeams.settings.setValidityState(true) a después de que el usuario haya introducido o seleccionado todos los datos necesarios en la página de configuración para habilitar el botón guardar.

La configuración de la pestaña no se puede guardar al seleccionar Guardar

Al agregar una pestaña, si selecciona Guardar pero recibe un mensaje de error que indica que la configuración no se puede guardar, el problema podría ser una de las dos clases de problemas:

El mensaje de operación correcta de guardado nunca se recibió: si se registró un controlador de guardado mediante microsoftTeams.settings.registerOnSaveHandler(handler), la devolución de llamada debe llamar a saveEvent.notifySuccess().
- Si la devolución de llamada no llama en saveEvent.notifySuccess() 30 segundos o llama saveEvent.notifyFailure(reason) en su lugar, se muestra este error.
- Si no se registró ningún controlador de guardado, la saveEvent.notifySuccess() llamada se realiza automáticamente cuando el usuario selecciona Guardar.
La configuración proporcionada no era válida: la otra razón por la que la configuración no se puede guardar es si la llamada a microsoftTeams.setSettings(settings) proporcionó un objeto de configuración no válido o si la llamada no se realizó en absoluto. Consulte la sección siguiente, Problemas comunes con el objeto settings.

Problemas comunes con el objeto settings

settings.entityId falta. Este campo es necesario.
settings.contentUrl falta. Este campo es necesario.
settings.contentUrl o el opcional settings.removeUrl, o settings.websiteUrl se proporcionan pero no son válidos. Las direcciones URL deben usar HTTPS y también deben ser el mismo dominio que la página de configuración o especificarse en la lista del validDomains manifiesto.

No se puede autenticar al usuario ni mostrar el proveedor de autenticación en la pestaña

A menos que realice la autenticación silenciosa, debe seguir el proceso de autenticación proporcionado por la biblioteca cliente de JavaScript de Microsoft Teams.

Nota:

Se requiere que todo el flujo de autenticación se inicie y finalice en el dominio, que debe aparecer en el validDomains objeto del manifiesto.

Para obtener más información sobre la autenticación, consulte cómo autenticar a un usuario.

Pestañas estáticas que no se muestran

Hay un problema conocido por el que la actualización de una aplicación de bot existente con una pestaña estática nueva o actualizada no mostrará ese cambio de pestaña al acceder a la aplicación desde una conversación de chat personal. Para ver el cambio, debe probar en un nuevo usuario o instancia de prueba, o acceder al bot desde el control flotante Aplicaciones.

Para solucionar problemas de bots

No se puede agregar mi bot

El administrador debe habilitar las aplicaciones para que las carguen los usuarios finales. En algunos casos, el inquilino de Microsoft 365 podría tener varias SKU asociadas y, para que los bots funcionen en cualquiera, deben estar habilitados en todas las SKU. Para obtener más información, consulte preparación del inquilino de Microsoft 365.

No se puede agregar un bot como miembro de un equipo

Los bots deben cargarse primero en un equipo antes de que sea accesible dentro de cualquier canal de ese equipo. Para obtener más información sobre este proceso, consulte cómo cargar la aplicación en un equipo.

Mi bot no recibe mi mensaje en un canal

Los bots de los canales reciben mensajes solo cuando están explícitamente @mentioned, incluso si responde a un mensaje de bot anterior. La única excepción en la que es posible que no vea el nombre del bot en un mensaje es si el bot recibe una imBack acción como resultado de una CardAction que envió originalmente.

Mi bot no entiende mis comandos cuando se encuentra en un canal

Dado que los bots de los canales solo reciben mensajes cuando son @mentioned, todos los mensajes que recibe el bot en un canal lo incluyen @mention en el campo de texto. Se recomienda quitar el nombre del bot de todos los mensajes de texto entrantes antes de pasar a la lógica de análisis. Revise las menciones para obtener sugerencias sobre cómo controlar este caso.

Problemas con el empaquetado y la carga

Error al leer manifest.json

La mayoría de los errores de manifiesto proporcionan una sugerencia sobre qué campo específico falta o no es válido. Sin embargo, si el archivo JSON no se puede leer como JSON en absoluto, se usa este mensaje de error genérico.

Motivos comunes de errores de lectura de manifiestos:

JSON no válido. Use un IDE como Visual Studio Code o Visual Studio que valide automáticamente la sintaxis JSON.
Problemas de codificación. Use UTF-8 para el archivo manifest.json . Es posible que otras codificaciones, específicamente con la lista de materiales, no sean legibles.
Paquete de .zip con formato incorrecto. El archivo manifest.json debe estar en el nivel superior del archivo .zip. Tenga en cuenta que la compresión predeterminada de archivos Mac podría colocar el manifest.json en un subdirectorio, que no se cargará correctamente en Microsoft Teams.

Existe otra extensión con el mismo identificador

Si intenta cargar de nuevo un paquete actualizado con el mismo identificador, elija el icono Reemplazar al final de la fila de tabla de la pestaña en lugar del botón Cargar .

Si no vuelve a cargar un paquete actualizado, asegúrese de que el identificador sea único.

Error al cargar la aplicación en Teams

Si recibe un mensaje de error de análisis de manifiestos al cargar la aplicación en los equipos, use el validador de aplicaciones de Teams para validar el paquete de la aplicación, incluidos el manifiesto de la aplicación y el archivo de especificación de OpenAPI. Revise el manifiesto de la aplicación y los requisitos de La descripción de OpenAPI (OAD) para resolver errores o advertencias e intente cargar la aplicación.
Si encuentra algún problema al ejecutar la aplicación en Teams, siga estos pasos para identificar y resolver el problema:
- Red: seleccione la pestaña Red en Herramientas de desarrollo para inspeccionar la actividad de red.
  1. Abra el cliente web de Teams.
  2. Inicie sesión con sus credenciales de Microsoft 365.
  3. Vaya a un chat y ejecute la aplicación de extensión de mensajes.
  4. En la parte superior derecha, seleccione Configuración y mucho más (...). Vaya a Más herramientas>Herramientas de desarrollo.
  5. Seleccione Red. Seleccione la opción de filtro y escriba invoke en el campo de búsqueda.
  6. Seleccione un error de la lista.
  7. En el panel derecho, seleccione la pestaña Respuesta .
  8. Se muestra un objeto JSON que representa una respuesta de error de un servicio o API. Contiene un standardizedError objeto con errorCode, errorSubCodey errorDescription, que tienen más detalles sobre el error.
  Respuestas de error HTTP comunes:
  - Puede producirse un error de solicitud incorrecta 400 si falta un parámetro de solicitud o tiene un formato incorrecto.
  - Un error 401 No autorizado o 403 Prohibido sugiere problemas con la clave de API, como que falta o no está autorizada.
  - Un error interno del servidor 500 indica que el servicio no sabe cómo responder, debido a un problema del lado servidor.
Solución de problemas con herramientas: si la información del seguimiento de red es insuficiente, puede crear una solicitud siguiendo el documento de descripción de OpenAPI y usar herramientas como Swagger Editor o Postman para probar la solicitud, incluido el encabezado de autorización de la clave de API si es necesario.

Si no puede resolver los errores, se recomienda ponerse en contacto con el soporte técnico del producto de Microsoft Teams para obtener más ayuda.

Compartir a través de