Compartir a través de

Agregar bots a aplicaciones de Microsoft Teams

  • Artículo

Importante

Este artículo se basa en el SDK de Bot Framework v3.

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 el star de su experiencia, o simplemente un asistente. Los bots se publican como parte del paquete de aplicación más amplio, que puede incluir otras funcionalidades, como pestañas o extensiones de mensajes.

Las API del bot

Teams admite la mayoría de los 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.
Bots SDK V3

Importante

Este artículo se basa en el SDK de Bot Framework v3.

Portal para desarrolladores de Teams para Teams es una herramienta que puede ayudar a compilar el bot y un paquete de aplicación que hace referencia al bot. También contiene una biblioteca de control React y ejemplos 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 da por hecho que está configurando manualmente el bot y no mediante el Portal para desarrolladores de Teams para Teams:

  1. Cree el bot mediante Bot Framework. Asegúrese de agregar Microsoft Teams como canal de la lista de canales destacados después de crear el bot. No dude en reutilizar cualquier identificador de aplicación de Microsoft que haya generado si ya ha creado el paquete o manifiesto de la aplicación.

    Página de registro de Bot Framework

Nota:

Si no desea crear el bot en Azure, debe usar este vínculo para crear un nuevo bot: Bot Framework. Si en su lugar hace clic en Crear un bot en el portal de Bot Framework, creará el bot en Microsoft Azure .

  1. Compile el bot con el paquete NuGet Microsoft.Bot.Connector.Teams , el SDK de Bot Framework o la API de Bot Connector.

  2. Pruebe el bot con el Bot Framework Emulator.

  3. 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

A partir de diciembre de 2017, el portal de Bot Framework está optimizado para registrar bots en Microsoft Azure. Estos son algunos aspectos que debe tener en cuenta:

  • 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 para 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 de Bot Framework, como su "punto de conexión de mensajería", que es común al desarrollar por primera vez un bot, especialmente si usa ngrok, verá la columna "Estado de la migración" y un botón azul "Migrar" que le llevará a Microsoft Azure Portal. No haga clic en el botón "Migrar" a menos que eso sea lo que quiere hacer; en su lugar, haga clic en el nombre del bot y puede editar sus propiedades:
    Editar propiedades del bot
  • Si registra el bot mediante Microsoft Azure, no es necesario hospedar el código del bot en Microsoft Azure.
  • Si registra un bot mediante Azure Portal, debe tener una cuenta de Microsoft Azure. Puede crear una de forma gratuita. Para comprobar su identidad al crear una, debe proporcionar una tarjeta de crédito, pero no se le cobrará; siempre es gratis crear y usar bots con Teams.
  • Ahora puede usar el Portal para desarrolladores de Teams para registrar o actualizar la información de aplicaciones y bots directamente en Teams. Solo tendrá que usar la Azure Portal para agregar o configurar otros canales de Bot Framework, como Direct Line, Chat en web, Skype y Facebook Messenger.

Consulte también

Ejemplos de Bot Framework.