Autenticación de Microsoft Teams

Requisitos previos

Dependiendo del tipo de autenticación que selecciones, necesitarás una de las siguientes credenciales:

Ámbito y tu nombre de usuario y contraseña de Microsoft (para el código de autorización OAuth 2.0)
Ámbito, ID de cliente, Secreto de cliente (para Trae tu propia aplicación OAuth 2.0)

El Ámbito representa los ámbitos predeterminados para las operaciones regulares de los usuarios, como:

Team.Create Channel.Create ChannelMember.ReadWrite.All
                     ChannelMessage.Send Chat.ReadWrite ChannelMessage.Read.All
                     Calendars.ReadWrite

Puedes añadir o eliminar ámbitos para personalizar los permisos de usuario para tu conexión. Para obtener más información sobre los ámbitos, consulta la sección Ámbitos a continuación, así como la documentación de Microsoft: referencia de permisos de Microsoft Graph.

Para crear una aplicación OAuth2 privada, sigue los pasos descritos en la documentación de Microsoft Teams: Configurar la autenticación OAuth de terceros - Teams.

Además, debe conceder permisos a las aplicaciones de terceros para que accedan a su información.

Conceder permisos a aplicaciones de terceros

Antes de establecer la conexión, asegúrate de que se conceden los permisos para las aplicaciones integradas desde el centro de administración:

Inicia sesión en el centro de administración de Microsoft 365.
Ve a Configuración y selecciona Configuración de la organización.
En la pestaña Servicios , selecciona Consentimiento del usuario para las aplicaciones.
Asegúrate de que la casilla Permitir que los usuarios den su consentimiento cuando las aplicaciones soliciten acceso a los datos de tu organización en su nombre está habilitada y selecciona Guardar.

Agregar la conexión de Microsoft Teams

Para crear una conexión a su instancia de Microsoft Teams, debe realizar los siguientes pasos:

Select Integration Service from Automation Cloud^TM.
En la lista Conectores , selecciona Microsoft Teams. También puedes utilizar la barra de búsqueda para acotar el conector.
Selecciona el botón Añadir conexión .
Ahora se te redirige a la página de conexión. Puedes elegir entre dos tipos de autenticación: Código de autorización OAuth 2.0 o Trae tu propia aplicación OAuth 2.0.
Introduce las credenciales necesarias.
Seleccione Conectar.
Se ha agregado su conexión.

Para obtener más información sobre la autenticación en Microsoft Teams, consulta la página Autenticación y autorización de Microsoft.

Ámbitos y permisos

Puedes utilizar esta conexión para habilitar el paquete de actividades de Microsoft Teams en UiPath Studio para crear automatizaciones para la gestión de usuarios y canales, la mensajería y otras formas de trabajar juntos. Los diversos casos de uso basados en permisos que se pueden lograr son los siguientes:

`Scope`	Use case	Actividad/Evento
`openid` (obligatorio)	Al utilizar este permiso, una aplicación puede recibir un identificador único para el usuario en forma de subdemanda. El permiso también otorga a la aplicación acceso al punto final `UserInfo` . El ámbito `openid` puede utilizarse en el punto final del token de la plataforma de identidad de Microsoft para adquirir tokens de ID. La aplicación puede utilizar estos tokens para la autenticación	N/D
`offline_access` (obligatorio)	Necesario para recibir el token de actualización en el punto final de la solicitud de autenticación. Cuando canjeas un código de autorización en el flujo de código de autorización OAuth 2.0 sin ámbito offline_access, no recibirás el token de actualización del punto final /token.	N/D
`profile` (obligatorio)	Recuperar el perfil de usuario actual, como nombre, nombre de usuario, correo electrónico, etc., para que pueda usarse como usuario predeterminado/autenticado en la creación de la conexión y en ciertas actividades	N/D
`email` (obligatorio)	Permite que la aplicación lea las direcciones de correo electrónico principales de todos los usuarios, para enviar mensajes o invitarlos a un canal	Enviar mensaje de chat individual Invitar miembros al canal Invitar usuario al equipo
`User.Read` (Recomendado)	Permite a los usuarios iniciar sesión en la aplicación y permite que la aplicación lea el perfil de los usuarios que han iniciado sesión. También permite que la aplicación lea la información básica de la empresa de los usuarios que han iniciado sesión	Obtener registro → Yo
`Team.Create`	Crear un equipo para invitar e involucrar a los usuarios respectivos	Insertar registro → Equipos
`Team.ReadBasic.All`	Recuperar la lista de equipos que se seleccionarán en las actividades, como enviar un mensaje de canal, etc.	Crear canal Enumerar todos los canales Enviar mensaje de chat Enviar mensaje de chat individual Invitar a un miembro a un canal Responder a mensaje de canal Enviar mensaje de canal Obtener equipo por nombre
`TeamMember.ReadWrite.All`	Añadir miembro a un equipo en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros de un equipo	Enumerar todos los miembros de la lista Invitar usuario al equipo Insertar registro → Miembros de equipos Enumerar todos los registros → Miembros de los equipos
`Channel.Create`	Crear un canal (estándar/privado) para invitar e involucrar a los respectivos usuarios del equipo	Crear canal
`Channel.ReadBasic.All`	Recuperar la lista de canales de un equipo que se seleccionará en las actividades, como enviar un mensaje de canal, etc.	Invitar a un miembro a un canal Obtener canal por nombre Responder a mensaje de canal Enviar mensaje de canal
`ChannelMember.ReadWrite.All`	Añadir miembro a un canal en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros involucrados en un canal	Invitar a un miembro a un canal Enumerar todos los registros → Miembros de los canales de Teams
`ChannelMessage.Send`	Enviar un mensaje en un canal. Además, responde a un mensaje en un hilo, si es necesario.	Responder a mensaje de canal Enviar mensaje de canal
`ChannelMessage.Read.All`	Permite que la aplicación lea todos los mensajes del canal en Microsoft Teams, sin un usuario que haya iniciado sesión También se utiliza para desencadenar eventos cada vez que se publica un mensaje en el canal o cada vez que se menciona una palabra clave en el canal	Responder a mensaje de canal Enumerar todos los mensajes del canal Enumerar todos los registros → Mensajes de los canales de Teams Cuando se publica un mensaje en el canal (Futuro) Cuando se menciona una palabra clave o nombre de usuario en el canal (Futuro)
`Chat.ReadWrite`	Permite que la aplicación lea y envíe tu 1:1 Permite que la aplicación lea y envíe mensajes de chat de grupo También se utiliza para desencadenar eventos cada vez que se publica un mensaje de chat	Enviar mensaje de chat de grupo Enviar mensaje de chat individual Enumerar todos los mensajes de chat Enumerar todos los registros → Chats Cuando se publica un mensaje de chat (futuro)
`ChatMember.ReadWrite`	Añadir miembro a un chat en nombre del usuario que ha iniciado sesión Recuperar la lista de miembros involucrados en un chat	Insertar registro → Miembros de chats Enumerar todos los registros → Miembros de chats