Probar y depurar el bot de Microsoft Teams

Al probar el bot, debe tener en cuenta los contextos en los que desea que se ejecute el bot y cualquier funcionalidad que haya agregado al bot que requiera datos específicos de Microsoft Teams. Asegúrese de que el método elegido para probar el bot se alinea con su funcionalidad.

Probar cargando en Teams

La forma más completa de probar el bot es crear un paquete de aplicación y cargarlo en Teams. La carga de la aplicación en Teams es el único método para probar la funcionalidad completa disponible para el bot, en todos los ámbitos.

Hay dos métodos para cargar la aplicación. Puede usar el Portal para desarrolladores de Teams o crear manualmente un paquete de aplicación y cargar la aplicación. Si necesitas modificar tu manifiesto y volver a cargar tu aplicación, debes eliminar tu bot antes de cargar tu paquete de aplicación alterado.

Depurar el bot localmente

Si hospeda el bot localmente durante el desarrollo, deberá usar un servicio de tunelización como ngrok para probar el bot. Una vez que haya descargado e instalado ngrok, ejecute el siguiente comando para iniciar el servicio de tunelización. Es posible que tenga que agregar ngrok a su ruta de acceso.

ngrok http <port> --host-header=localhost:<port>

Use el punto de conexión https proporcionado por ngrok en el manifiesto de la aplicación. Si cierra la ventana de comandos y reinicia, obtendrá una nueva dirección URL y tendrá que actualizar la dirección del punto de conexión del bot para usar también esa.

Probar el bot sin cargarlo en Teams

En ocasiones, es necesario probar el bot sin instalarlo como una aplicación en Teams. Probar el bot sin instalarlo como una aplicación puede ser útil para asegurarse de que el bot está disponible y respondiendo, pero no le permitirá probar toda la amplitud de la funcionalidad de Teams que puede haber agregado a su bot. Si necesitas probar tu bot por completo, sigue las instrucciones para realizar la prueba mediante la carga.

Use el emulador de bot

Bot Framework Emulator es una aplicación de escritorio que permite a los desarrolladores de bots probar y depurar sus bots, ya sea de forma local o remota. Con el emulador, puede chatear con el bot e inspeccionar los mensajes que envía y recibe. Esto puede ser útil para comprobar que su bot está disponible y respondiendo, pero el emulador no le permitirá probar ninguna funcionalidad específica de Teams que haya agregado al bot, ni las respuestas de su bot serán una representación visual precisa de cómo se representan en Teams. Si necesita probar cualquiera de esas cosas, no es mejor cargar el bot.

Las instrucciones completas sobre el emulador de Bot Framework Emulator se pueden encontrar aquí.

Bloquear un bot en un chat personal

Los usuarios pueden optar por impedir que el bot envíe mensajes de chat personales. Para activar esta alternancia, haga clic con el botón derecho en el bot en el canal de chat y elija Bloquear conversación del bot. Esto significa que los bots seguirán enviando mensajes, pero el usuario no recibirá esos mensajes.

Quitar un bot de un equipo

Los usuarios pueden eliminar el bot eligiendo el icono de papelera en la lista de bots en su vista de equipos. Tenga en cuenta que esto solo elimina el bot del uso de ese equipo, los usuarios individuales pueden interactuar en el contexto personal.

En el contexto personal, un usuario no puede deshabilitar ni quitar los bots, salvo eliminar completamente el bot de Teams.

Deshabilitar un bot en Teams

Para impedir que el bot reciba mensajes, vaya al Panel de bots y edite el canal de Microsoft Teams. Desactive la opción Habilitar en Microsoft Teams . Deshabilitar un bot en Teams impide que los usuarios interactúen con el bot, pero seguirá siendo reconocible y los usuarios podrán agregarlo a Teams.

Eliminar un bot de Teams

Para quitar el bot por completo de Teams, vaya al panel de bots y edite el canal de Microsoft Teams. Elija el botón Eliminar en la parte inferior. La eliminación de un bot de Teams impide que los usuarios descubran, agreguen o interactúen con el bot. Eliminar un bot de Teams no lo quita de las instancias de Teams de otros usuarios, aunque también dejará de funcionar para ellos.

Quitar el bot de AppSource

Si desea quitar el bot de la aplicación de Teams en AppSource (anteriormente Office Store), debe quitar el bot del manifiesto de la aplicación y volver a enviar la aplicación para validación. Para obtener más información, consulte Publicar la aplicación de Microsoft Teams en AppSource.