Enviar mensajes proactivos
Un mensaje proactivo es un mensaje enviado por un bot en respuesta a comandos simples enviados en el chat desde un usuario. La respuesta del mensaje puede tener uno de los siguientes formatos:
- Mensajes de bienvenida
- Mensajes programados
- Notificaciones
Esta guía paso a paso le ayuda a enviar un mensaje proactivo desde un bot. Verá la siguiente salida:
Requisitos previos
Asegúrese de instalar las siguientes herramientas para compilar e implementar las aplicaciones.
| Instalar | Para usar | |
|---|---|---|
| Microsoft Visual Studio Code | JavaScript o TypeScript, entornos de compilación. Use la versión más reciente. | |
| Kit de herramientas de Microsoft Teams | Extensión de Visual Studio Code que crea un scaffolding de proyecto para la aplicación. Use la versión más reciente. | |
| Node.js | Entorno de tiempo de ejecución de JavaScript de back-end. Para obtener más información, vea Node.js tabla de compatibilidad de versiones para el tipo de proyecto. | |
| Microsoft Teams | Teams para colaborar con todos los usuarios con los que trabaje a través de aplicaciones para chat, reuniones, llamadas y todo en un solo lugar. | |
| Microsoft Edge (recomendado) o Google Chrome | Un explorador con herramientas de desarrollo. | |
| Cuenta de desarrollador de Microsoft 365 | Acceso a la cuenta de Teams con los permisos adecuados para instalar una aplicación. |
Preparación del entorno de desarrollo
Después de instalar las herramientas necesarias, configure el entorno de desarrollo.
Instalación del kit de herramientas de Teams
Microsoft Teams Toolkit ayuda a simplificar el proceso de desarrollo con herramientas para aprovisionar e implementar recursos en la nube para la aplicación y publicarlos en la Tienda Teams.
Puede usar Teams Toolkit con Visual Studio Code o una interfaz de línea de comandos denominada CLI de TeamsFx.
Abra Visual Studio Code y seleccione Extensiones (Ctrl+Mayús+X o Ver>extensiones).
En el cuadro de búsqueda, escriba Kit de herramientas de Teams.
Seleccione Instalar.
El icono del kit de herramientas de
Teams aparece en la barra de actividad de Visual Studio Code.
También puede instalar Teams Toolkit desde Visual Studio Code Marketplace.
Configuración del inquilino de desarrollo de Teams
Un inquilino es un espacio o un contenedor para su organización en Teams, donde chatea, comparte archivos y ejecuta reuniones. Este espacio también es donde carga y prueba la aplicación. Vamos a comprobar si está listo para desarrollar con el inquilino.
Comprobación de la opción cargar una aplicación
Después de crear la aplicación personalizada, debe cargarla en Teams con la opción Cargar una aplicación personalizada . Inicie sesión en su cuenta de Microsoft 365 para comprobar si esta opción está habilitada.
Los pasos siguientes le ayudan a comprobar si puede cargar aplicaciones en Teams:
En el cliente de Teams, seleccione el icono Aplicaciones .
Seleccione Administrar las aplicaciones.
Seleccione Cargar una aplicación.
Busque la opción Cargar una aplicación personalizada. Si la opción está visible, puede cargar aplicaciones personalizadas.
Nota:
Si no encuentra la opción de cargar una aplicación personalizada, póngase en contacto con el administrador de Teams.
Creación de un inquilino para desarrolladores de Teams gratuito (opcional)
Si no tiene una cuenta de desarrollador de Teams, únase al programa para desarrolladores de Microsoft 365.
Seleccione Unirse ahora y siga las instrucciones en pantalla.
En la pantalla de bienvenida, seleccione Configurar suscripción A5.
Configure su cuenta de administrador. Una vez finalizada, aparece la siguiente pantalla:
Inicie sesión en Teams con la cuenta de administrador que acaba de configurar. Compruebe que tiene la opción Cargar una aplicación personalizada en Teams.
Compilación de un bot de mensaje proactivo
Para compilar un bot de mensajes proactivo mediante Visual Studio Code, siga estos pasos:
Abrir Visual Studio Code.
Seleccione el icono Kit de herramientas de
Teams en la barra de actividad de Visual Studio Code.En el panel izquierdo, seleccione Ver ejemplos.
En la lista de ejemplos, seleccione Mensajería proactiva. Se abre un ejemplo precompilado que está listo para la depuración.
Seleccione Crear.
Seleccione Carpeta predeterminada para almacenar la carpeta raíz del proyecto en la ubicación predeterminada.
Si desea cambiar la ubicación predeterminada, siga estos pasos:
Seleccione Examinar.
Seleccione la ubicación del área de trabajo del proyecto.
Seleccione Seleccionar carpeta.
El bot de mensajes proactivo se crea en unos segundos y muestra el cuadro de diálogo del bot de mensajes proactivo correcto en la esquina inferior derecha con la opción de depurar:
:::Seleccione el icono Ejecutar y depurar
en la esquina superior izquierda.Seleccione Depurar (Edge) o Depurar (Chrome) en la lista desplegable.
Cuando la depuración se realice correctamente, se le pedirá que cargue el bot de mensajes proactivo en Teams en el equipo local.
En la lista desplegable situada junto a Agregar, seleccione Agregar a un equipo o Agregar a un chat o Agregar a una reunión.
Escriba el nombre de un chat o equipo en el campo de búsqueda y seleccione Configurar un bot.
La aplicación de bot de mensaje proactivo se carga en el cliente de Teams y aparece el siguiente mensaje en respuesta al mensaje enviado.
Copie y pegue la dirección URL o vaya a la dirección URL en el explorador. Se desencadena y se comparte un mensaje de saludo proactivo en el chat.
Vaya a Teams. Recibirá un mensaje de saludo proactivo del bot.
Dar un paseo por el código fuente
Teams Toolkit proporciona componentes para crear una aplicación. Después de crear el proyecto, puede ver las carpetas y los archivos del proyecto en el área EXPLORER de Visual Studio Code.
La nueva carpeta del proyecto contiene el siguiente contenido:
| Carpeta o archivo | Contenido |
|---|---|
.vscode/ |
Archivos de Visual Studio Code para la depuración. |
appManifest/ |
Plantillas para el manifiesto de aplicación (anteriormente denominado manifiesto de aplicación de Teams). |
env/ |
Los pares nombre/valor se almacenan en archivos de entorno y los usan teamsapp.yml para personalizar las reglas de aprovisionamiento e implementación. |
manifest.json |
El manifiesto de aplicación para publicar a través del Portal para desarrolladores para Teams se almacena en Properties/manifest.json. |
teamsapp.yml |
El archivo de proyecto principal describe la configuración de la aplicación y define el conjunto de acciones que se van a ejecutar en cada fase del ciclo de vida. |
teamsapp.local.yml |
Esto invalida teamsapp.yml con acciones que habilitan la ejecución y depuración locales. |
Implementación del bot de mensajes proactivo
Ha aprendido a compilar y ejecutar aplicaciones de Teams con funcionalidad de bot de mensajes proactivo. Vamos a implementar la primera aplicación con funcionalidad de bot de mensajes proactivo en Azure mediante el kit de herramientas de Teams.
Inicio de sesión en su cuenta de Azure
Use su cuenta para acceder a Microsoft Azure Portal y aprovisionar nuevos recursos en la nube para admitir la aplicación.
Abrir Visual Studio Code.
Abra la carpeta del proyecto donde creó la aplicación de bot de mensajes proactivo.
Seleccione el icono Kit de herramientas de
Teams en la barra de actividad de Visual Studio Code.Seleccione Iniciar sesión en Azure con sus credenciales.
Sugerencia
Si tiene instalada la extensión AZURE ACCOUNT y usa la misma cuenta, puede omitir este paso.
Se abre el explorador web predeterminado para permitirle iniciar sesión en la cuenta.
Cierre el explorador cuando se le solicite y vuelva a Visual Studio Code.
La sección ACCOUNTS de la barra lateral muestra las dos cuentas por separado. También muestra el número de suscripciones de Azure utilizables disponibles. Asegúrese de que tiene al menos una suscripción de Azure utilizable disponible. Si no es así, cierre la sesión y use otra cuenta.
Implementar la aplicación en Azure
La implementación consta de dos pasos. En primer lugar, se crean los recursos en la nube necesarios (también conocidos como aprovisionamiento). A continuación, el código de la aplicación se copia en los recursos en la nube creados. En este tutorial, implementará la aplicación de bot.
¿Cuál es la diferencia entre Aprovisionar e Implementar?
El aprovisionamiento crea recursos en Azure y Microsoft 365 para la aplicación, pero no se copia ningún código (HTML, CSS y JavaScript) en los recursos. Deploy copia el código de la aplicación en los recursos que creó durante el aprovisionamiento. Es habitual implementar varias veces sin aprovisionar nuevos recursos. Dado que el aprovisionamiento puede tardar algún tiempo en completarse, es independiente de la implementación.
Seleccione el icono Kit de herramientas de
Teams en la barra de actividad de Visual Studio Code.Seleccione Aprovisionar en CICLO DE VIDA.
Seleccione una de las suscripciones existentes.
Seleccione un grupo de recursos existente o cree un nuevo grupo de recursos. Para obtener más información, consulte Creación de un grupo de recursos.
Nota:
Aparece un cuadro de diálogo en el que se menciona que se pueden incurrir en costos al ejecutar recursos en Azure.
Seleccione Aprovisionar.
El proceso de aprovisionamiento crea recursos en la nube de Azure. Puede supervisar el progreso en los diálogos que aparecen en la esquina inferior derecha. Después de unos minutos, aparece el siguiente cuadro de diálogo:
Seleccione Implementar en CICLO DE VIDA.
Seleccione Implementar.
La implementación tarda algún tiempo. Puede supervisar el progreso en los diálogos que aparecen en la esquina inferior derecha. Después de unos minutos, aparece el siguiente cuadro de diálogo.
Abra el panel de depuración (Ctrl+Mayús+D / ⌘⇧-D o Ver>ejecución) desde Visual Studio Code.
Seleccione Iniciar remoto (Edge) en la lista desplegable de configuración de inicio.
Cuando la depuración se realice correctamente, se le pedirá que cargue la aplicación de bot de mensajes proactivo en Teams.
En la lista desplegable situada junto a Agregar, seleccione Agregar a un equipo o Agregar a un chat o Agregar a una reunión.
Escriba el nombre de un chat o equipo en el campo de búsqueda y seleccione Configurar un bot.
La aplicación de bot de mensaje proactivo se carga en el cliente de Teams y aparece el siguiente mensaje en respuesta al mensaje enviado.
Copie y pegue la dirección URL o vaya a la dirección URL en el explorador. Se desencadena y se comparte un mensaje de saludo proactivo en el chat.
Vaya a Teams. Recibirá un mensaje de saludo proactivo del bot.
Desafío completo
¿Se te ocurrió algo como esto?
¡Enhorabuena!
Ha completado el escenario.
- Puede enviar notificaciones diariamente o solicitar comentarios de los usuarios periódicamente.
- Puede controlar los límites de limitación para evitar varias notificaciones.
¿Tiene algún problema con esta sección? Si es así, envíenos sus comentarios para que podamos mejorarla.