El artículo describe los pasos necesarios para configurar Microsoft (MS) Teams como canal de chat para Luma. Una vez finalizada la configuración, los usuarios podrán enviar y recibir mensajes de Luma utilizando Microsoft Teams.
Configuraciones en MS Teams
Apps Studio en MS Teams permite crear y distribuir aplicaciones empresariales que se han creado específicamente para su organización. Los siguientes pasos lo guiarán a través del proceso de creación de una aplicación en el portal de Microsoft Teams y de su configuración para conectarse a la instancia de Luma.
Crear aplicación
El primer paso es crear una aplicación en MS Teams. La aplicación se configurará como un bot para su organización y se conectará a la instancia de Luma. Para crear la aplicación en MS Teams, haga lo siguiente:
Inicie sesión en MS Teams https://teams.microsoft.com/ . Inicie sesión en el cliente de Microsoft Teams con una cuenta que tenga el rol de administrador global o administrador de servicios de Microsoft Teams activado para publicar aplicaciones para su organización. Obtenga más información sobre el uso de los roles de administrador para gestionar Teams.
En la navegación del lado izquierdo, haga clic en el botón más. Busque y seleccione App Studio de la lista.
En App Studio, vaya a Manifest editor (Editor de manifiestos). En esta ficha, se muestra el bot disponible para la organización a través de MS Teams.
Haga clic en “Create a new app” (Crear una nueva aplicación) para iniciar la generación de la aplicación para conectarse a Luma.
Ahora se lo dirigirá a la página App Details (Detalles de la aplicación). Agregue los siguientes detalles obligatorios para crear y configurar la aplicación:
En Details (Detalles) → App Details (Detalles de la aplicación), agregue Short Name (el nombre corto) y Full Name (nombre completo) de la aplicación en la sección App Name (Nombre de la aplicación). El nombre corto se utiliza para identificar el bot en MS Teams.
El paso siguiente es generar el ID de la aplicación. Este ID de la aplicación se utiliza para configurar el canal en Luma.
Desplácese hacia abajo hasta la sección Identification (Identificación) y haga clic en Generate (Generar). El ID de la aplicación será generado automáticamente por Teams.
Agregue Package Name (Nombre del paquete) y Version (Versión).
En la sección Descriptions (Descripciones), agregue Short Description (Descripción breve) y Full Description (Descripción completa) de la aplicación. Las dos descripciones deben ser detalladas y diferentes.
Agregue los detalles del desarrollador en la sección Developer Information (Información del desarrollador). Introduzca el nombre del desarrollador del bot y una dirección URL válida del sitio web.
Desplácese hacia la sección App URLs (Direcciones URL de la aplicación) y agregue las direcciones URL a Privacy statement (Declaración de privacidad) y Terms of Use (Términos de uso).
Ahora se deben establecer los íconos para el bot.
Upload a full-color image in .png format (192x192) . Este es el ícono de la aplicación y aparece en la parte superior del canal de chat.
Upload another image with one transparent outline in .png format (32x32). Este es el ícono de la aplicación que aparece en la navegación de la izquierda.
Los detalles se guardarán automáticamente. La aplicación se ha creado correctamente.
Instalar el bot
Ahora que se ha creado la aplicación, los siguientes pasos consisten en agregar capacidades del bot a la aplicación. Siga los pasos que aparecen a continuación para configurar la aplicación para que se conecte a la instancia de Luma.
En la sección Capabilities (Capacidades), haga clic en Bots (Bots).
Haga clic en Setup (Configuración) para configurar el bot y los permisos.
En la pantalla, aparece la ventana Set up a bot (Configurar un bot). En la pestaña New bot (Nuevo bot), agregue los siguientes detalles:
Agregue Name (Nombre). Este es el nombre para el bot en MS Teams. Este es el modo en que los usuarios identificarán el bot en MS Teams una vez que se hayan completado todos los pasos de configuración. El nombre del bot no se puede editar una vez que se ha creado.
En Messaging bot (Bot de mensajería), seleccione “My bot supports uploading and downloading files” (Mi bot admite la carga y la descarga de archivos). Esto permite adjuntar archivos mediante el bot.
En Scope (Ámbito), seleccione Personal (Personal).
Haga clic en Create Bot (Crear bot).
Se ha creado el bot. El sistema genera automáticamente el ID del bot. Este ID se utilizará en la configuración de canales en Luma. Copie y guarde el ID para usarlo en pasos posteriores.
El paso siguiente es generar una clave secreta para que MS Teams y Luma se comuniquen. Haga clic en Generate new Password (Generar nueva contraseña).
Copie y guarde la contraseña para usarla en pasos posteriores. Esta contraseña o clave secreta se utilizará para la configuración de canales en Luma.
Desplácese hacia abajo hasta la sección Messaging endpoint (Punto de conexión de mensajería). La dirección del punto de conexión del bot se debe agregar aquí, que hace referencia a la instancia de Luma.
Siga los pasos que aparecen a continuación para obtener la dirección URL del punto de conexión:
Ahora en el explorador de MS Teams, pegue la dirección URL del mensaje copiada en el paso anterior en el campo Bot endpoint address (Dirección del punto de conexión del bot) en la sección Bots (Bots).
Si la organización es compatible con varios dominios, agregue todos los dominios válidos en la pestaña Domain and Permissions (Dominio y permisos). Este es un paso opcional.
El paso siguiente es instalar la aplicación. Una vez que se haya instalado la aplicación, estará disponible para que los usuarios finales puedan agregarla a su perfil de Teams.
En la pestaña Test and Distribute (Probar y distribuir), haga clic en Install (Instalar).
Aparece una ventana emergente con los detalles del bot. Haga clic en Add (Agregar) para completar la creación y la configuración del bot.
La configuración del bot ya está completa. La aplicación ahora está disponible en la navegación izquierda.
Configuraciones en el portal de Azure
Una vez que la aplicación de MS Teams está lista, el paso siguiente es asignar permisos a la aplicación para comunicarse con Luma. Siga los pasos que aparecen a continuación para asignar los permisos necesarios.
Inicie sesión en el portal de Azure con las credenciales de administrador.
https://portal.azure.com/Seleccione App Registrations (Registros de aplicaciones) de la lista Azure Services (Servicios de Azure).
En la lista All applications (Todas las aplicaciones), busque su aplicación. Su aplicación se identifica por el nombre del bot.
Haga clic en su aplicación para ver los detalles. Ahora está en la página de descripción general de la aplicación. Aquí Application (client) ID (ID de la aplicación [del tenant]) es el mismo que el ID del bot generado en el paso 3 de la instalación del bot.
Ahora vaya a API permissions (Permisos de la API) y haga clic en el botón Add a permission (Agregar un permiso) para solicitar permisos para que la aplicación se comunique con Luma.
En la pantalla Request API permission (Solicitar permiso de la API), haga clic en Microsoft Graph.
Haga clic en Application permissions (Permisos de la aplicación) y seleccione los siguientes permisos:
En User (Usuario), seleccione User.Read.All.
En AccessReview (Revisión de acceso), seleccione AccessReview:Read.All.
En Directory (Directorio), seleccione Directory.Read.All.
Haga clic en Add Permissions (Agregar permisos) para actualizar los permisos para la aplicación. Los permisos solicitados aparecerán ahora en la lista API Permission (Permisos de la API). Haga clic en el botón “Grant admin consent” (Otorgar el consentimiento del administrador).
El sistema ahora muestra una solicitud para que se conceda el consentimiento para los permisos solicitados. Haga clic en Yes (Sí) para actualizar.
Una vez que se han agregado los permisos, aparecerá el mensaje de operación correcta “Successfully granted admin consent for the requested permissions” (Se ha otorgado correctamente el consentimiento del administrador para los permisos solicitados).
Se han asignado todos los permisos necesarios a la aplicación.
Activar MS Teams en Luma
El último paso de la configuración consiste en activar MS Teams en Luma. Siga los pasos que aparecen a continuación para configurar el canal de chat de MS Teams en Luma.
Inicie sesión en la interfaz de usuario de Bot Builder (Generador de bots) para la instancia de Luma con las credenciales de administrador. Vaya a la pestaña Bot → Configurations (Configuraciones) → Channel Configuration (Configuración de canales).
Haga clic en Microsoft Teams.
En la página Configure channel (Configurar canal), agregue los siguientes detalles:
Agregue App ID (ID de la aplicación). Este es el ID del bot generado automáticamente por MS Teams en el paso 3 de la instalación del bot. Copie y pegue el ID del bot en el campo App ID (ID de la aplicación) en la interfaz de usuario de Luma.
Agregar contraseña. Esta es la clave secreta o la contraseña generada automáticamente por MS Teams en el paso 4 de la instalación del bot. Copie y pegue la contraseña en el campo Password (Contraseña) en la interfaz de usuario de Luma.
En User Reconciliation for Channel Authentication (Conciliación de usuarios para la autenticación de canales), seleccione los campos para la conciliación de usuarios en el campo Field Name (Nombre del campo). Haga clic en Set (Establecer).
Este paso es para establecer los campos que se usarán para la autenticación automática del usuario a través del canal. Se pueden seleccionar varios campos, ordenados por orden de validación.
Alterne el botón Status (Estado) a Active (Activo).
Haga clic en Guardar.
El canal ya está configurado.
MS Teams ya está configurado para su tenant. El usuario final puede utilizar la aplicación para conectarse y comunicarse con Luma.
De forma predeterminada, la autenticación automática está activada para todos los canales configurados en Luma. Luma podrá autenticar automáticamente a un usuario existente de Luma. No es necesario registrar manualmente el usuario en el canal.