Integración con Microsoft Teams

IBM Cloud

Añada un chatbot a Microsoft Teams para crear y personalizar un centro productivo donde el contenido, las herramientas y las personas se reúnen para chatear, reunirse y colaborar.

Después de crear una acción, puede utilizar esta integración para conectar su asistente con Microsoft Teams.

Antes de empezar

Para integrar su asistente con Microsoft Teams, debe tener los roles Global Administrator, o Teams Administrator. Para obtener más información, consulte Políticas de permisos de aplicación.

Regístrese para obtener una dirección de correo electrónico de Microsoft 365 Developer Administrator, si no tiene una:

  1. Vaya a Microsoft Dev Center.

  2. Pulse Unirse ahora para convertirse en miembro del programa Microsoft 365 Developer.

  3. En el panel de control, pulse Configurar suscripción E5 y seleccione un recinto de seguridad Instant o Configurable.

  4. Copie la dirección de correo electrónico listada en Administrador. Las credenciales de administrador son necesarias en varios puntos de la configuración.

Añadir la integración Microsoft Teams

  1. Vaya a la página Integraciones pulsando el icono de integraciones (Icono Integraciones) en el menú de la izquierda.

  2. Haga clic en Añadir en la Microsoft Teams azulejo.

  3. Pulse Confirmar. La página Cómo empezar proporciona un resumen del proceso de configuración.

  4. Pulse Siguiente para iniciar el registro de la aplicación.

Registro de aplicaciones

  1. Vaya al portal deMicrosoft Azuree inicie sesión con sus credenciales de administrador.

  2. En la página Registros de aplicaciones, pulse Nuevo registro.

  3. En la página Registrar una aplicación, especifique un nombre, seleccione la opción de multiarrendatario que se aplica a la aplicación y, a continuación, pulse Registrar.

  4. Copie el ID de la aplicación de la página de descripción general de su aplicación y péguelo en el campo de registro de la aplicación de su integración en watsonx Assistant Microsoft Teams.

  5. En la misma página Microsoft Azure , pulse el hiperenlace Añadir un certificado o secreto junto a Credenciales de cliente.

  6. En la página Certificados y secretos para la creación de señales, pulse Nuevo secreto de cliente. Especifique una descripción y, a continuación, seleccione Recomendado 180 días. Pulse Añadir.

  7. Copie la cadena en Valor y péguela en Valor secreto del cliente en la página de registro de la aplicación de su integración en watsonx Assistant Microsoft Teams. Nota: Debe generar un valor nuevo antes de que el actual caduque el día 180.

  8. Haz clic en Siguiente para crear tu bot.

Crear el bot

  1. Vaya al portal del desarrollador de Microsoft Bot Frameworke inicie sesión con sus credenciales de administrador.

  2. En la página Cuéntenos sobre su bot, complete su perfil de bot.

  3. Copia el endpoint generado en la página Crea tu bot de tu integración watsonx Assistant Microsoft Teams y pégalo en el campo Endpoint de mensajería de la sección Configuración.

  4. Seleccione Multi-Tenant como tipo de aplicación.

  5. Copie y pegue el ID de app y, a continuación, pulse Registrar.

  6. En la página Conectarse a los canales, haga clic en Configurar canal Microsoft Teams en la sección Añadir un canal destacado.

  7. En la página Configurar Microsoft Teams, especifica las opciones de las pestañas Mensajería, Llamada y Publicar que se ajusten a las necesidades de tu bot y, a continuación, haz clic en Guardar.

  8. En su integración watsonx Assistant Microsoft Teams, haga clic en Siguiente para crear su aplicación Teams.

Crear la app de Teams

  1. Vaya al portal para desarrolladores Microsoft Teams e inicie sesión con sus credenciales de administrador.

  2. En la pestaña Aplicaciones, haga clic en Nueva aplicación.

  3. Especifique un nombre y pulse Añadir.

  4. En la página Información básica, especifique nombres de aplicación, ID de aplicación, descripciones, información de desarrollador y URL de aplicación y, a continuación, copie y pegue el ID de aplicación en ID de aplicación (cliente). Pulse Guardar.

  5. En la sección Configurar, seleccione Características de la aplicación y, a continuación, Bot.

  6. En la página Identificar el bot, seleccione el bot.

  7. En la sección Seleccionar el ámbito en el que las personas pueden utilizar este mandato, seleccione Personal, Equipo y Conversación de grupo.

  8. Pulse Guardar, pero mantenga abierta la ventana.

  9. En su integración watsonx Assistant Microsoft Teams, haga clic en Finalizar.

  10. Pulse Publicar para publicar el bot.

Cuando se ejecuta una extensión personalizada durante una conversación en Microsoft Teams, el cliente recibe los pasos previos a la ejecución sólo después de que finalice la llamada a la extensión. Para obtener más información, consulte Llamar a una extensión personalizada.

Publicación de la aplicación Teams

  1. En la ventana Microsoft Teams Developer Portal donde creaste y guardaste tu aplicación Teams, haz clic en Publish para publicar tu bot.

  2. Pulse Descargar el paquete de aplicaciones.

  3. Vaya a Microsoft Teams e inicie sesión con sus credenciales de administrador.

  4. Pulse Aplicaciones en el menú de la barra lateral y, a continuación, pulse Gestionar sus aplicaciones y Cargar una aplicación.

  5. Seleccione Cargar una aplicación personalizada y especifique el archivo comprimido del paquete de aplicaciones que ha descargado.

  6. Haz clic en Añadir para terminar.

  7. Pruebe las acciones y respuestas en la sección Conversación de la aplicación Teams.

Tipos de respuesta

Estos tipos de respuesta se admiten y se muestran de la forma esperada cuando su asistente se despliega para Microsoft Teams mensajes directos, canales o chats de grupo.

  • fecha
  • imagen
  • option
  • suberencia
  • Texto

Limitaciones

En Microsoft Teams, los botones de opción, tanto si proceden de una acción como de un nodo de diálogo, permanecen activos después de seleccionarlos. Estos botones se pueden pulsar varias veces durante una conversación, y cada vez que se pulsa se vuelve a enviar la misma carga a watsonx Assistant. Este comportamiento puede dar lugar a un procesamiento duplicado y podría generar respuestas de seguimiento inesperadas o incorrectas.

Esta limitación es específica del canal Microsoft Teams. En otros canales, como el chat web y la página Pruébalo de watsonx Assistant, los botones de opción se desactivan tras el primer clic y no se pueden volver a seleccionar.