Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
Importante
Este artículo se basa en el SDK de Bot Framework v3.
- Si desea crear un bot de IA, consulte Crear un bot de IA.
- Si desea crear un bot básico, consulte Introducción. Si desea buscar la versión 4.6 o posterior de la documentación actual del SDK, consulte Bots de conversación.
Cree y conecte bots inteligentes para interactuar con los usuarios de Microsoft Teams de forma natural a través del chat. También puede proporcionar un bot simple basado en comandos que se usará como interfaz de "línea de comandos" para una experiencia más amplia de la aplicación de Teams. Puede crear un bot de solo notificación, que puede insertar información relevante para los usuarios directamente en un canal o mensaje directo. Incluso puede traer su bot basado en Bot Framework existente y agregar soporte específico de Teams para que su experiencia brille.
Importante
Los bots están disponibles en Government Community Cloud (GCC), GCC High, Departamento de Defensa (DoD) y Teams operados por entornos de 21Vianet .
Lo que necesitas saber: Bots
Un bot se parece a cualquier otro miembro del equipo con el que interactúa en una conversación, excepto que tiene un icono de avatar hexagonal y siempre está en línea.
Un bot se comporta de forma diferente según el tipo de conversación en la que esté involucrado. Los bots en Teams admiten varios tipos de conversaciones denominadas ámbitos en el manifiesto de la aplicación.
-
teamsTambién se denominan conversaciones de canal. -
personalConversaciones entre un bot y un único usuario. -
groupChatUna conversación entre un bot y dos o más usuarios.
Para obtener más información, consulte Tener una conversación con un bot de Microsoft Teams.
Con las aplicaciones de Teams, puede convertir al bot en la estrella de su experiencia o simplemente en un ayudante. Los bots se publican como parte de un paquete de aplicación más amplio, que puede incluir otras funcionalidades, como pestañas o extensiones de mensajes.
API de bot
Teams admite la mayor parte de Microsoft Bot Framework. (Si ya tiene un bot basado en Bot Framework, puede adaptarlo fácilmente para que funcione en Teams). Le recomendamos que use C# o Node.js para aprovechar nuestros SDK. Estos paquetes amplían las clases y métodos básicos del SDK de Bot Builder:
- Usar tipos de tarjeta especializados, como la tarjeta de conector para Grupos de Microsoft 365.
- Consumir y establecer datos de canal específicos de Teams sobre actividades.
- Procesando solicitudes de extensión de mensajería.
Las extensiones del SDK instalan dependencias, incluido el SDK de Bot Builder.
- .NET Para usar las extensiones de Microsoft Teams para el SDK de Bot Builder para .NET, instale el paquete NuGet Microsoft.Bot.Connector.Teams en el proyecto de Visual Studio. Para el desarrollo de Node.js, la funcionalidad de BotBuilder para Microsoft Teams se ha incorporado al SDK de Bot Framework a partir de la versión 4.6.
Importante
Puede desarrollar aplicaciones de Teams en cualquier otra tecnología de programación web y llamar directamente a las API de REST de Bot Framework , pero debe realizar todo el control de tokens usted mismo.
El portal para desarrolladores de Teams le ayuda a crear y configurar el manifiesto de la aplicación, y puede crear el bot de Bot Framework por usted. También contiene una biblioteca de control React y un generador de tarjetas interactivo.
Webhooks salientes
Los webhooks salientes le permiten crear un bot simple para interacciones básicas, como iniciar un flujo de trabajo u otros comandos simples que pueda necesitar. Los webhooks salientes solo están presentes en el equipo en el que se crean y están diseñados para procesos sencillos específicos del flujo de trabajo de su empresa. Para obtener más información, consulte Webhooks salientes.
Crear un gran bot de Teams
Los siguientes artículos le guiarán a través del proceso de creación de un buen bot para Teams:
- Crear un bot: aproveche las excelentes herramientas, la documentación y la comunidad proporcionada por el equipo de Bot Framework.
- Hable con el bot: agregue un flujo de conversación básico y use la funcionalidad específica del canal. Si desarrolla en .NET o Node.js, use nuestras extensiones para el SDK de Bot Builder para simplificar el trabajo.
- Uso de tarjetas en el bot: Tarjetas de diseño para comunicarse y aceptar la respuesta del usuario.
- Responder a eventos de bot
- Bots solo de notificación: Uso de bots para enviar notificaciones para la aplicación.
- Obtener contexto: Obtener información sobre el usuario.
- Menús de bots: Uso de menús en bots.
- Bots y archivos: enviar y recibir archivos de bots.
- Usar pestañas con bots: hacer que las pestañas y los bots funcionen juntos.
- Prueba tu bot: agrega tu bot para conversaciones personales o de equipo para verlo en acción.
Bots SDK V3
Importante
Este artículo se basa en el SDK de Bot Framework v3.
- Si desea crear un bot de IA, consulte Crear un bot de IA.
- Si desea crear un bot básico, consulte Introducción. Si desea buscar la versión 4.6 o posterior de la documentación actual del SDK, consulte Bots de conversación.
El portal para desarrolladores de Teams para Teams es una herramienta que puede ayudar a crear su bot y un paquete de aplicación que hace referencia a su bot. También contiene una biblioteca de control React y muestras configurables para tarjetas. Para obtener más información, consulte Introducción al portal para desarrolladores de Teams para Teams. En los pasos siguientes se presupone que está configurando manualmente el bot y no está usando el Portal para desarrolladores de Teams para Teams:
Cree el bot con Bot Framework. Asegúrese de agregar Microsoft Teams como un canal desde la lista de canales destacados después de crear el bot. Siéntase libre de reutilizar cualquier id. de aplicación de Microsoft que haya generado si ya ha creado el paquete o manifiesto de la aplicación.
Nota
Si no desea crear el bot en Azure, debe usar este vínculo para crear un nuevo bot: Bot Framework. Si selecciona Crear un bot en el portal de Bot Framework en su lugar, creará el bot en Microsoft Azure en su lugar.
Compile el bot con el paquete NuGet Microsoft.Bot.Connector.Teams , el SDK de Bot Framework o la API de Bot Connector.
Pruebe el bot con Bot Framework Emulator.
Implemente el bot en un servicio en la nube, como Microsoft Azure. Como alternativa, ejecute la aplicación localmente y use un servicio de tunelización como ngrok para exponer un punto de conexión de https:// para el bot, como
https://45az0eb1.ngrok-free.app/api/messages.
Nota
Bots y Microsoft Azure
El portal de Bot Framework está optimizado para registrar bots en Microsoft Azure. A continuación ofrecemos algunas medidas útiles:
- El canal de Microsoft Teams para bots registrados en Azure es gratuito. Los mensajes enviados a través del canal de Teams no contarán para los mensajes consumidos por el bot.
- Aunque es posible crear un nuevo bot de Bot Framework sin usar Azure, debe usar crear un nuevo bot de Bot Framework, que ya no se expone en el portal de Bot Framework.
- Al editar las propiedades de un bot existente en la lista de bots en Bot Framework, como su "punto de conexión de mensajería", que es común cuando se desarrolla un bot por primera vez, especialmente si usa ngrok, verá la columna "Estado de migración" y un botón azul "Migrar" que le llevará al Microsoft Azure Portal. No seleccione el botón "Migrar" a menos que eso sea lo que quiera hacer; en su lugar, seleccione el nombre del bot y podrá editar sus propiedades:
- Si registra el bot con Microsoft Azure, no es necesario hospedar el código del bot en Microsoft Azure.
- Si registra un bot con Azure Portal, debe tener una cuenta de Microsoft Azure. Puedes crear uno gratis. Para verificar su identidad cuando cree una, debe proporcionar una tarjeta de crédito, pero no se cobrará; crear y usar bots con Teams siempre es gratis.
- Ahora puede usar el Portal para desarrolladores de Teams para registrar o actualizar la información de bots y aplicaciones directamente dentro de Teams. Solo tendrá que usar Azure Portal para agregar o configurar otros canales de Bot Framework, como Direct Line, Chat en web, Skype y Facebook Messenger.