Configuración

Introducción

Para habilitar las actividades de Microsoft Teams, tu aplicación debe estar integrada con la plataforma de identidades de Microsoft y tener asignados los permisos correctos de la API de Microsoft Graph .

Para integrar su aplicación, asignar permisos y comenzar a crear su proyecto de automatización, primero deberá decidir si creará su propia aplicación o usará la aplicación UiPath (por ejemplo, UiPathStudioO365App).

Importante: si está utilizando la aplicación UiPath, deberá asegurarse de agregar el consentimiento de administrador.

Si no agrega el consentimiento del administrador, verá el siguiente error.

Si está creando su propia aplicación, deberá seguir los pasos a continuación.

Después de registrar tu aplicación de Microsoft Office Teams, Azure Active Directory asigna un ID de aplicación (cliente) único que se introduce en el ámbito de Microsoft Office Teams.

Nota:

Si ya completaste las actividades de Microsoft Office 365 o tienes una aplicación registrada, puedes ir directamente a la sección Agregar permisos de API y agregar los permisos necesarios para las actividades de Microsoft Teams.

Después de agregar los permisos, podrás usar el mismo ApplicationID en las actividades del ámbito de Microsoft Office 365 y del ámbito de Microsoft Teams .

Pasos

1. Registre su aplicación

1. Inicia sesión en Azure Portal con tu cuenta personal, del trabajo o de la escuela de Microsoft Office 365.
2. En el panel de navegación de la izquierda, haz clic en Azure Active Directory.
3. Una vez que se abra la página de Azure Active Directory , haz clic en Registros de aplicaciones.

4. Haga clic en + Nuevo registro en la barra de navegación superior.

   
   

   

   
   
5. Introduzca un nombre para su aplicación (por ejemplo, "Office365App").

6. En Tipos de cuentas admitidos, selecciona la opción que más te convenga.

   • Para obtener más información sobre qué opción seleccionar, a continuación se presentan las recomendaciones de Microsoft:

     • Solo cuentas en este directorio de la organización: usa esta opción si el público de destino es interno de tu organización.
     • Cuentas en cualquier directorio de la organización (Cualquier directorio de Azure AD - Multitenant): usa esta opción si tu público objetivo son clientes empresariales o educativos y para habilitar el multitenemento.
     • Cuentas de cualquier directorio de la organización (cualquier directorio de Azure AD - Multitenant) y cuentas personales de Microsoft (p. Ej. Skype, xbox): usa esta opción para dirigirte al conjunto más amplio de identidades de Microsoft y habilitar el tenant múltiple.
   • En URI de redirección (opcional), introduce una dirección URI (si corresponde).
   • Su selección depende de su tipo de autenticación. Para obtener más información sobre este tema, consulta la página de detalles de la actividad Automatización y supervisión desatendida en el ámbito de Microsoft Teams .
   • En nuestro ejemplo, la organización admite la autenticación de tenant múltiple y solo puede usar el tipo de autenticación de token interactivo, que requiere un URI de redirección.
   • Si tu tipo de autenticación es Autenticación de Windows integrada o Nombre de usuario y contraseña, no necesitarás registrar un URI de redirección para tu aplicación. Estos flujos viajan de vuelta al punto final de la plataforma de identidad de Microsoft v2.0 y no se volverá a llamar a tu aplicación en ningún URI específico.
   • Para obtener más información, consulta Registro de aplicaciones de escritorio en la documentación de la plataforma de identidad de Microsoft.

7. Haz clic en Registrar.

   
   

   

   
   
   Nota:

   Hoy en día, la biblioteca de autenticación de Microsoft (MSAL.NET) usa urn: ietf: wg: oauth: 2.0: oob como URI de redirección predeterminado y es probable que este valor le funcione cuando use el tipo de autenticación InteractiveToken (usaremos esto en todos nuestros ejemplos y guías de inicio rápido).

   En el futuro, Microsoft planea cambiar el URI de redirección predeterminado a https: //<span>sign.microsoftonline.com/common/oauth2/nativeclient</span>, por lo que puede considerar usar esto en su lugar.

¡Listo! Ahora, agreguemos permisos de API a su aplicación registrada.

2. Add API permissions

1. Desde la página de la aplicación registrada (Azure Portal> Azure Active Directory> Registros de aplicaciones> Office365App), haz clic en Permisos de API en el panel de navegación de la izquierda.
2. Una vez que se abra la página de permisos de API, haz clic en + Añadir un permiso (se abre la ventana Solicitar permisos de API ).
3. En Seleccionar una API, haz clic en API de Microsoft (puede estar abierto de forma predeterminada).

4. En API de Microsoft usadas habitualmente, haz clic en Microsoft Graph.

   
   

   

   
   

5. ¿En Qué tipo de permisos requiere su aplicación?, haz clic en Permisos delegados para mostrar la lista de permisos.

   • Aunque los permisos de la aplicación también funcionarán, las actividades están diseñadas para aplicaciones con permisos delegados asignados a las API de Microsoft Graph.
   • Para obtener más información sobre los tipos de permisos, consulta Configurar una aplicación cliente para acceder a las API web en la documentación de Microsoft Azure.

6. Use la barra de búsqueda o desplácese hacia abajo en la lista alfabética y seleccione los siguientes permisos:

   • Chat.LeerEscribir
   • Grupo.LeerEscribir todo
   • Usuario.LeerTodo

7. Haz clic en Añadir permisos (volviendo a tu lista de permisos de API)

   
   

   

   
   

8. Verifique que sus permisos de API incluyan sus permisos de chat, grupo y usuario agregados.

   
   

   

   
   

3. Cree su proyecto

1. Crear un nuevo proyecto de automatización.

   1. Abra UiPath Studio.
   2. En Nuevo proyecto, haz clic en Proceso (se abre una ventana Nuevo proceso en blanco ).
   3. Introduce un Nombre, unaUbicacióny una Descripcióndel proyecto.

   4. Haz clic en Crear.

      
      

      

      
      

2. Instale el paquete UiPath.MicrosoftTeamsActivities .

   1. En la cinta Diseño , haz clic en Administrar paquetes (se abre la ventana Administrar paquetes ).
   2. En Todos los paquetes, haz clic en Ir.
   3. En la barra de búsqueda , escribe Teams.

   4. Haga clic en, instale y acepte la licencia para UiPath.Teams.Activities.

      • Para obtener más información sobre los paquetes de Uipath Studio, consulta Gestionar paquetes en la Guía de Studio.

        
        

        

        
        

¡Ya está!

Ahora que has completado la configuración, puedes empezar a añadir las actividades de Microsoft Teams a tu proyecto.

Próximos pasos

Para una experiencia de aprendizaje práctica y para empezar a utilizar rápidamente las actividades, consulte las guías de inicio rápido , que ofrecen instrucciones paso a paso para ayudarle a crear ejemplos prácticos de las diferentes actividades para que pueda verificar la conexión con la aplicación registrada y familiarizarse con las propiedades de entrada / salida.

Para obtener más información sobre las actividades de Microsoft Teams (incluidas las entradas / salidas de propiedades de ejemplo), consulta las siguientes páginas de actividades para obtener una lista completa y enlaces a las páginas de detalles de las actividades.

• Equipos