Conexión de un bot a Microsoft Teams

  • Artículo

SE APLICA A: SDK v4

Puedes configurar el bot para comunicarte con personas a través de Microsoft Teams. En este artículo se describe cómo crear una aplicación de Teams en Teams, conectar el bot a la aplicación de Teams en Azure y, a continuación, probar el bot en Teams.

Requisitos previos

  • Suscripción a Azure. Si aún no tiene una, cree una cuenta gratuita antes de empezar.
  • Un bot publicado en Azure que quiere conectarse a Teams.
  • Un inquilino de desarrollador en Teams con la carga de aplicaciones personalizadas o la instalación de prueba habilitadas. Para más información, consulta Prepara tu inquilino de Microsoft 365.
  • Un paquete de aplicación de Teams válido. Para obtener más información, consulta Cargar mi aplicación en Microsoft Teams.

Configura tu bot en Azure

  1. Abra Azure Portal.
  2. Abra la hoja de recursos del bot de Azure para el bot.
  3. Abre Canales y selecciona Microsoft Teams:
    1. Lee y acepta los términos del servicio.
    2. En la pestaña Mensajería, selecciona el entorno en la nube del bot. Para obtener más información, consulta la sección Poscreación de Planifica la aplicación con características de Teams.
    3. Seleccione Aplicar.
  4. Selecciona Obtener código de inserción del bot, busca el código de inserción para Teams y, a continuación, copia la parte https del código. Por ejemplo, https://teams.microsoft.com/l/chat/0/0?users=28:b8a22302e-9303-4e54-b348-343232. Puedes usar este código para probar el bot en Teams.

Sugerencia

Prueba el bot en Teams

Los bots de producción se deben agregar a Teams como parte de una aplicación de Teams. Para obtener más información, consulta Probar mi aplicación.

Importante

No se recomienda agregar un bot por GUID, salvo con fines de prueba. Si lo hace, se limitará en gran medida la funcionalidad de un bot. Los bots de producción se deben agregar a Teams como parte de una aplicación.

  1. En el explorador, abre la dirección URL que copiaste del código de inserción y elige la aplicación de Microsoft Teams (cliente o web) que usas para agregar el bot a Teams. Verás que el bot aparece como un contacto al que puedes enviar mensajes y del que puedes recibir mensajes en Microsoft Teams.
  2. Interactúa con el bot en Teams.

Sugerencia

Usa un registro de canal de bot por entorno, ya que el punto de conexión cambia al cambiar entre entornos de desarrollo, almacenamiento provisional y producción locales.

Al eliminar el registro del canal de Teams, se generará un nuevo par de claves cuando se vuelva a habilitar. Esto invalida los identificadores 29:xxx y a:xxx que el bot puede haber almacenado para la mensajería proactiva.

Publica tu bot en Teams

Para obtener instrucciones sobre cómo publicar la aplicación, consulte la información general de Teams sobre cómo Distribuir la aplicación de Microsoft Teams. En él y en los artículos asociados se explica cómo:

  • Elegir y configurar las opciones de instalación del bot
  • Crea el manifiesto de la aplicación de Teams, el icono y el paquete
  • Carga tu aplicación en Teams
  • Publica tu aplicación en tu organización o en la tienda de Teams

Información adicional