Tu bot de Teams deja de responder después de cambiar al nuevo cliente de Teams. El bot aparece en línea pero nunca contesta a mensajes ni comandos. Esto suele ocurrir porque el nuevo cliente de Teams usa un entorno de ejecución y un modelo de permisos diferentes. Este artículo explica por qué fallan los bots en el nuevo cliente y ofrece soluciones paso a paso para las causas más comunes.
Puntos clave: Solucionar un bot de Teams que no responde en el nuevo cliente
- Centro de administración de Teams > Aplicaciones > Administrar aplicaciones: Comprueba si la aplicación del bot está bloqueada o tiene una actualización pendiente que impide que se ejecute.
- Centro de administración de Teams > Configuración de toda la organización > Aplicaciones de Teams > Directivas de permisos: Verifica que la directiva permita que tus usuarios instalen y usen el bot.
- Ctrl+Shift+K en el nuevo cliente de Teams: Abre el diagnóstico de reuniones y llamadas para probar si se puede acceder al bot.
Por qué un bot de Teams deja de responder en el nuevo cliente de Teams
El nuevo cliente de Teams, lanzado en 2023, está construido sobre una pila tecnológica web diferente a la del cliente clásico. Se ejecuta en un shell basado en Chromium y usa una versión más reciente del SDK de JavaScript de Teams. Los bots creados para el cliente clásico pueden no funcionar correctamente en el nuevo cliente debido a estos cambios.
La razón técnica más común es una discrepancia en el punto de conexión de mensajería del bot. El nuevo cliente envía solicitudes usando un agente de usuario diferente y puede requerir que el bot admita HTTPS y la versión más reciente del protocolo Bot Framework. Si el punto de conexión del bot no está actualizado, el nuevo cliente no puede autenticar la solicitud y el bot nunca recibe el mensaje.
Otra causa frecuente es un problema de directiva o de permisos de la aplicación. El nuevo cliente de Teams aplica las directivas de permisos de aplicaciones con más rigor. Si tu organización no permite el bot mediante la directiva de permisos, aparecerá en la lista de aplicaciones pero no responderá cuando chatees con él.
Por último, es posible que el bot esté bloqueado por una regla de gobernanza de aplicaciones. En el nuevo centro de administración de Teams, puedes configurar aplicaciones para que se bloqueen por motivos de seguridad. Un bot bloqueado no procesará ningún mensaje.
Pasos para diagnosticar y solucionar un bot que no responde en el nuevo cliente de Teams
Sigue estos pasos en orden. Cada paso aborda una causa específica. Prueba el bot después de cada paso para ver si se ha resuelto el problema.
- Comprobar el estado de la aplicación del bot en el centro de administración
Ve al centro de administración de Teams en admin.teams.microsoft.com. Selecciona Aplicaciones de Teams > Administrar aplicaciones. Busca el nombre del bot. Comprueba la columna Estado. Si el estado es Bloqueado, haz clic en el nombre de la aplicación y luego en Publicar o Permitir para desbloquearla. Si el estado es Actualización pendiente, aprueba la actualización para asegurarte de que el bot use el código más reciente. - Verificar la directiva de permisos de la aplicación
En el centro de administración de Teams, ve a Aplicaciones de Teams > Directivas de permisos. Selecciona la directiva que se aplica a tus usuarios. En Aplicaciones de Microsoft, asegúrate de que el bot esté configurado como Permitido. Si está configurado como Bloqueado, cámbialo a Permitido y guarda. Espera 30 minutos para que la directiva se propague. - Probar el bot con el atajo de diagnóstico
En el nuevo cliente de Teams, presiona Ctrl+Shift+K para abrir el panel de diagnóstico de reuniones. Escribe el nombre del bot en el cuadro de búsqueda. El panel mostrará si se puede acceder al bot y si hay errores de conexión. Si el panel muestra un error de red, continúa con el siguiente paso. - Borrar la caché del cliente de Teams
Cierra Teams. Presiona Ctrl+R en el teclado para recargar el cliente. Si eso no funciona, borra la caché manualmente. Presiona Ctrl+Shift+Esc para abrir el Administrador de tareas, finaliza todos los procesos de Teams y luego elimina la carpeta de caché en %appdata%\Microsoft\Teams. Reinicia Teams y prueba el bot de nuevo. - Reinstalar el bot desde la tienda de aplicaciones
En el nuevo cliente de Teams, ve a Aplicaciones en la barra lateral izquierda. Busca el bot. Haz clic en el icono del bot y luego en Quitar. Después de quitarlo, haz clic en Agregar para reinstalarlo. Esto restablece la configuración local del bot. - Comprobar el punto de conexión del bot con un navegador web
Si tienes acceso al código fuente del bot, abre la URL del punto de conexión del bot en un navegador. La URL suele estar en el registro del bot en Azure. Si el punto de conexión devuelve un error 404 o un error SSL, el bot no se está ejecutando correctamente. Actualiza el punto de conexión para usar HTTPS y asegúrate de que la versión del protocolo Bot Framework sea v3 o posterior.
Si el bot sigue sin responder después de la solución principal
El bot de Teams aparece como desconectado aunque esté en línea
Esto suele ocurrir cuando la presencia del bot no está sincronizada con el nuevo cliente. Ve a la ventana de chat del bot y escribe /status. Si el bot responde con un mensaje de estado, el bot funciona. Si no, es posible que el bot esté caído. Comprueba el servicio de hospedaje del bot, como Azure App Service, para ver si se está ejecutando.
El bot de Teams solo funciona en Teams clásico, no en el nuevo Teams
Esto indica un problema de compatibilidad con el SDK de JavaScript de Teams. El bot debe actualizarse para usar la versión más reciente del SDK. Si no eres el propietario del bot, ponte en contacto con el desarrollador del bot. Como solución alternativa, puedes volver temporalmente al Teams clásico haciendo clic en el conmutador de la esquina superior izquierda del nuevo cliente.
El bot de Teams no responde a los comandos pero sí a los mensajes
Esto suele deberse a una definición de comando mal formada. Es posible que el archivo de manifiesto del bot tenga identificadores de comando incorrectos. Solicita al desarrollador del bot que revise el manifiesto y se asegure de que cada comando tenga un identificador único y el ámbito correcto. En el nuevo cliente, también puedes intentar escribir el comando con una barra inicial, como /help.
Nuevo cliente de Teams frente a Teams clásico para la compatibilidad de bots
| Elemento | Nuevo cliente de Teams | Cliente de Teams clásico |
|---|---|---|
| Entorno de ejecución | Shell basado en Chromium | Shell basado en Electron |
| Versión del SDK de JavaScript | Requiere SDK v1.13 o posterior | Funciona con SDK v1.12 o anterior |
| Aplicación de permisos de aplicaciones | Más estricta, con bloqueo automático | Más permisiva, directiva manual |
| Ubicación de la caché | %appdata%\Microsoft\Teams | %appdata%\Microsoft\Teams |
| Atajo de diagnóstico | Ctrl+Shift+K | Ctrl+Shift+K |
La tabla muestra que la principal diferencia es el requisito de versión del SDK. Si tu bot se creó para el cliente clásico, es posible que no cumpla los requisitos del nuevo cliente. Actualiza el bot al SDK más reciente para garantizar la compatibilidad.
Ahora puedes diagnosticar por qué tu bot no responde en el nuevo cliente de Teams. Las soluciones van desde comprobar las directivas de administrador hasta borrar la caché. Empieza por las comprobaciones en el centro de administración, ya que son la causa más común. Si el bot sigue fallando, actualiza su SDK o ponte en contacto con el desarrollador. Usa el diagnóstico Ctrl+Shift+K para probar rápidamente la conectividad después de cada cambio.