Configuración

Introducción

Para habilitar las actividades de Microsoft Teams, tu aplicación debe estar integrada con la plataforma de identidad 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 utilizas la aplicación UiPath, deberás asegurarte de añadir el consentimiento del 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 Microsoft Office Teams, Azure Active Directory asigna un ID de aplicación único (cliente) que introduces en el Ámbito de Microsoft Office Teams.

Nota:

Si ya completaste las actividades de Microsoft Office 365 o tienes una aplicación registrada existente, puedes ir directamente a la sección Añadir permisos de API y añadir los permisos necesarios para las actividades de Microsoft Teams. Después de añadir los permisos, podrás utilizar el mismo ID de aplicación tanto en las actividades de Ámbito de Microsoft Office 365 como de Ámbito de Microsoft Teams .

Pasos

1. Registre su aplicación

1. Inicia sesión en el portal de Azure con tu cuenta personal, de trabajo o educativa de Microsoft Office 365.

2. In the left-hand navigation panel, click Azure Active Directory.

3. After the Azure Active Directory page opens, click App registrations.

4. Click + New registration in the top navigation bar.

   

5. Enter a Name for your application (e.g., "Office365App").

6. Under Supported account types, select the option that applies to you.

   • 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.
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • Tu selección depende de tu tipo de autenticación. Para obtener más información sobre este tema, consulta la página de detalles de la actividad Automatización desatendida y atendida 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. Click Register.

   

   Nota:

   Hoy en día, la biblioteca de autenticación de Microsoft (MSAL.NET) utiliza urn:ietf:wg:oauth:2.0:oob como URI de redirección predeterminada y este valor probablemente funcione cuando utilices el tipo de autenticación InteractiveToken (lo utilizamos 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://login.microsoftonline.com/common/oauth2/nativeclient, así que puedes 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 tu aplicación registrada (Portal de Azure > Azure Active Directory > Registros de aplicaciones > Office365App), haz clic en Permisos de API en el panel de navegación de la izquierda.

2. After the API permission page opens, click + Add a permission (this opens the Request API permissions window).

3. Under Select an API, click Microsoft APIs (may be open by default).

4. Under Commonly used Microsoft APIs, click Microsoft Graph.

   

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

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • 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. Click Add permissions (returning you to your list of API permissions)

   

8. Verifica que tus permisos de API incluyen tus permisos añadidos de Chat, Grupo y Usuario .

   

3. Cree su proyecto

1. Crear un nuevo proyecto de automatización.

   1. Open UiPath Studio.

   2. Under New Project, click Process (this opens a New Blank Process window).

   3. Introduzca un nombre de proyecto,una ubicación y una descripción.

   4. Haz clic en Crear.

      

2. Instala el paquete UiPath.MicrosoftTeamsActivities .
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. En la barra de búsqueda , introduce Teams.
   4. Haz clic en, instala y acepta 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 obtener una experiencia de aprendizaje práctico y empezar a utilizar las actividades rápidamente, consulta las guías de inicio rápido. Estas guías proporcionan instrucciones paso a paso para ayudarte a crear muestras funcionales de las diferentes actividades para que puedas verificar la conexión a tu aplicación registrada y familiarízate 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