Solucionar problemas de Microsoft Teams aplicación

Pestañas de solución de problemas

Acceso a DevTools

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

Pantalla de pestaña en blanco

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

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

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

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

Después de seleccionar el botón Guardar, la configuración de ficha no se puede guardar

Al agregar una pestaña, si hace clic en los botones de guardar pero se muestra 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 guardado correcto nunca se recibió. Si se registró un controlador de guardado con microsoftTeams.settings.registerOnSaveHandler(handler) , la devolución de llamada debe llamar saveEvent.notifySuccess() a . Si la devolución de llamada no llama a esto en 30 segundos o llama en su lugar, se saveEvent.notifyFailure(reason) mostrará este error.

  • Si no se registró ningún controlador de guardado, la llamada se realiza automáticamente inmediatamente saveEvent.notifySuccess() cuando el usuario selecciona el botón guardar.

  • La configuración proporcionada no era válida. La otra razón por la que es posible que la configuración no se guarde es si la llamada a un objeto de configuración no válido o si la llamada microsoftTeams.setSettings(settings) no se realizó en absoluto. Consulte la siguiente sección, 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 se proporcionan pero no son settings.websiteUrl válidos. Las direcciones URL deben usar HTTPS y también deben ser el mismo dominio que la página de configuración o especificadas 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 el SDK de cliente Microsoft Teams JavaScript.

Nota

Se requiere todo el flujo de autenticación para iniciar y finalizar en el dominio, que debe aparecer en el validDomains objeto del manifiesto.

Para obtener más información acerca de la autenticación, vea Authenticate a user.

Pestañas estáticas que no se muestran

Existe 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, debes probar en un nuevo usuario o instancia de prueba, o acceder al bot desde el control desplegable Aplicaciones.

Solución de problemas de bots

No se puede agregar el bot

El administrador de inquilinos Office 365 habilitar las aplicaciones para que las carguen los usuarios finales. Tenga en cuenta que, en algunos casos, el inquilino Office 365 puede tener varias SKU asociadas y, para que los bots funcionen en cualquiera, deben estar habilitados en todas las SKU. Consulte Prepare your Office 365 tenant para obtener más información.

No se puede agregar bot como miembro de un equipo

Los bots deben cargarse primero en un equipo antes de que sea accesible en cualquier canal de ese equipo. Consulta Cargar la aplicación en un equipo para obtener más información sobre este proceso.

Mi bot no recibe mi mensaje en un canal

Los bots de los canales reciben mensajes solo cuando se @mentioned explícitamente, incluso si estás respondiendo 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 acción como resultado de un CardAction que imBack envió originalmente.

Mi bot no entiende mis comandos cuando está en un canal

Dado que los bots de los canales solo reciben mensajes cuando se @mentioned, todos los mensajes que el bot recibe en un canal incluyen @mention en el campo de texto. Es una práctica recomendada 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 tratar este caso.

Problemas con el empaquetado y la carga

Error al leer manifest.jsen

La mayoría de los errores de manifiesto proporcionarán 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 manifiesto:

  • 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 manifest.jsen el archivo. Es posible que otras codificaciones, específicamente con la lista de materiales, no sean legibles.
  • Paquete de .zip malformado. El manifest.jsen el archivo debe estar en el nivel superior del .zip archivo. Tenga en cuenta que la compresión de archivos Mac predeterminada puede colocar el manifest.jsen un subdirectorio, que no se cargará correctamente en Microsoft Teams.

Existe otra extensión con el mismo identificador

Si intenta volver a cargar 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 Upload tabla.

Si no va a volver a cargar un paquete actualizado, asegúrese de que el identificador es único.