Agregar bots a aplicaciones de Microsoft Teams

  • Artículo

Importante

Este artículo se basa en el SDK de Bot Framework v3. Si busca la versión 4.6 o posterior de la documentación actual del SDK, consulte la sección bots conversacionales .

Cree y conecte bots inteligentes para interactuar con los usuarios de Microsoft Teams con naturalidad a través del chat. O bien proporcione un bot sencillo basado en comandos, que se usará como su interfaz de "línea de comandos” para ampliar su experiencia en la aplicación de Teams. Puede crear un bot con solo notificaciones, que puede insertar información relevante para los usuarios directamente en un canal o mensaje directo. Incluso puede traer su bot existente basado en Bot Framework y agregar soporte técnico específico para Teams para que su experiencia sea deslumbrante.

Importante

Los bots están disponibles en los entornos de Government Community Cloud (GCC), GCC-High y Department of Defense (DOD).

Ejemplo de un bot ayudando a un usuario

Aspectos que debe saber sobre los bots

Un bot aparece igual que cualquier otro miembro del equipo con el que interactúe en una conversación, salvo que aparece con un icono de avatar de forma hexagonal y siempre está en línea.

Un bot se comporta de forma diferente en función del tipo de conversación en la que esté implicado. Los bots de Teams admiten varios tipos de conversaciones denominadas ámbitos en el manifiesto de aplicación.

  • teams También se denominan conversaciones de canal.
  • personal Conversaciones entre bots y un único usuario.
  • groupChat Una conversación entre un bot y dos o más usuarios.

Para obtener más información, consulte Mantener una conversación con un bot de Microsoft Teams.

Con las aplicaciones de Teams, puede hacer que el bot sea la estrella de su experiencia, o simplemente un asistente. Los bots se distribuyen como parte de un paquete de aplicación más amplio, que puede incluir otras funcionalidades, como pestañas o extensiones de mensaje.

Las API del bot

Teams admite la mayoría de Microsoft Bot Framework. (Si ya tiene un bot basado en Bot Framework, puede adaptarlo fácilmente para que funcione en Teams). Se recomienda usar C# o Node.js para aprovechar nuestros SDK. En estos paquetes, se amplían las clases y métodos básicos del SDK de Bot Builder:

  • Usar tipos de tarjeta especializados, como la tarjeta del conector para grupos de Microsoft 365.
  • Consumo y configuración de datos de canal específicos de Teams en actividades.
  • Procesar solicitudes de extensión de mensaje.

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 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 herramienta de programación web y llamar a las API de REST de Bot Framework directamente, pero debe realizar usted mismo toda la gestión de los tokens.

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 automáticamente. También contiene una biblioteca de control de React y un generador de tarjetas interactivo.

Webhooks salientes

Los webhooks salientes permiten crear un bot sencillo para una interacción básica, como iniciar un flujo de trabajo u otros comandos sencillos que pueda necesitar. Los webhooks salientes solo residen en el equipo donde los crea y están diseñados para procesos simples específicos del flujo de trabajo de su empresa. Para obtener más información, consulte webhooks salientes.

Cree un bot de Teams espectacular

Los siguientes artículos le guiarán a través del proceso de creación de un bot excelente para Teams:

  • Crear un bot: saque provecho de las excelentes herramientas, la documentación y la comunidad proporcionados por el equipo de Bot Framework.
  • Hablar con el bot: agregue un flujo de conversación básico y aproveche la funcionalidad específica del canal. Si lo desarrolla en .NET o Node.js, use nuestras extensiones para el SDK de Bot Builder para simplificar el trabajo.
  • Usar tarjetas en el bot: diseñe tarjetas para comunicarse y aceptar la respuesta del usuario.
  • Responder a eventos del bot
  • Bots de solo notificación: uso de bots para enviar notificaciones en la aplicación.
  • Obtener contexto: obtener información sobre el usuario.
  • Menús de bot: uso de menús en bots.
  • Bots y archivos: envío y recepción de archivos por parte de los bots.
  • Usar pestañas con bots: hacer que las pestañas y los bots funcionen juntos.
  • Probar el bot: agregue el bot para conversaciones personales o de equipo para comprobar cómo funciona.

Consulte también

Ejemplos de Bot Framework.