Set up your Microsoft 365 Azure application

Para habilitar as atividades Microsoft 365 Classic, seu aplicativo deve ser integrado com a plataforma de identidade da Microsoft e ter as permissões corretas da API do Microsoft Graph atribuídas a ele.

Para integrar seu aplicativo, atribuir permissões e começar a criar seu projeto de automação, conclua as seguintes etapas:

1. Registre seu aplicativo.
2. Adicione permissões de API.
3. Construa seu projeto.

Após o registro de seu aplicativo Microsoft 365, o Azure Active Directory atribui uma ID de aplicativo (cliente) exclusiva, que você insere na atividade Microsoft 365 Scope , juntamente com os serviços aos quais você atribuiu permissões (por exemplo, arquivos, e-mail, calendário).

Registre seu aplicativo

Tip: This process is described in detail in the Microsoft documentation in Quickstart: Register an application with the Microsoft identity platform. Please note that the Microsoft UI may have changed since these steps were first documented.

1. Faça login no portal do Azure usando sua conta pessoal, profissional ou escolar do Microsoft 365.
2. No painel de navegação à esquerda, clique em Azure Active Directory.
3. Depois que a página do Azure Active Directory for aberta, clique em Registros de aplicativos.

4. Clique em + Novo registro na barra de navegação superior.

5. Insira um Nome para seu aplicativo (por exemplo, "Office365App").

6. Under Supported account types, select the option that applies to you. For more information about which option to select, refer to Who can sign in to you app?:

   • Accounts in this organizational directory only - Use this option if your target audience is internal to your organization. This represents a single tenant application.
   • Accounts in any organizational directory (Any Azure AD directory - Multitenant) - Use this option if your target audience is business or educational customers. This represents a multitenant application.
   • Accounts in any organizational directory and personal Microsoft accounts (e.g. Skype, Xbox) - Use this option to target the widest set of Microsoft identities. This represents a multitenant application.
7. Under Redirect URI (optional), enter a URI address (if applicable). The Microsoft Authentication Library (MSAL.NET) uses a default redirect URI: https://login.microsoftonline.com/common/oauth2/nativeclient. This value will likely work for you when using the Interactive Token authentication type.
   • Your selection is dependent on your authentication type. For more information on this topic, see How to connect to Microsoft 365 activities).
   • In our example, the organization supports multi-tenant authentication and can only use the Interactive Token authentication type which requires a redirect URI.
     • If you use Interactive Token and the default Microsoft Redirect URI, you must add a platform of type Mobile and desktop applications. For more information, see Configure platform settings in the Microsoft documentation.
     • If your authentication type is Integrated Windows Authentication or Username and Password, you don't need to register a redirect URI for your application. These flows do a round trip to the Microsoft identity platform v2.0 endpoint, and your application won't be called back on any specific URI.
   • When working with Microsoft 365 in a UiPath Studio project targeting .NET 5.0, add http://localhost to the Redirect URI of your custom applications.

     Para obter mais informações, consulte Registro de aplicativo de área de trabalho na documentação da plataforma de identidade da Microsoft.

8. Select Register. An example configuration is available in the image below.

   Nota: Esta configuração é apenas um exemplo. Siga as etapas descritas na documentação e faça seleções com base nas políticas de sua organização.
   
   

   

   
   

Você Terminou! Agora, vamos adicionar permissões de API ao seu aplicativo registrado.

Adicionar permissões de API

1. Na página do seu aplicativo registrado (Portal do Azure > Azure Active Directory > Registros de aplicativos > Office365App), selecione permissões de API no painel de navegação esquerdo.
2. Depois que a página de permissão da API for aberta, clique em + Adicionar uma permissão (isso abre a janela Solicitar permissões da API ).
3. Em Selecione uma API, clique em APIs da Microsoft (podem ser abertas por padrão).

4. Em APIs da Microsoft comumente usadas, clique em Microsoft Graph.

5. Under What type of permissions does your application require?, click Delegated permissions or Application permissions to show the list of permissions. Select Application permissions if you are using ApplicationIdAndSecret or ApplicationIdAndCertificate authentication type. The other authentication types available in Microsoft 365 Scope activity require Delegated permissions.

   Para obter mais informações sobre tipos de permissão, consulte Configure a client application to access web APIs na documentação do Microsoft Azure.

6. Use a barra de pesquisa ou role para baixo na lista alfabética e selecione as seguintes permissões:

   Note: These permissions are not all mandatory. The provided list represents the complete set of permissions required to run all Microsoft 365 activities. You can restrict permissions depending on your particular use case. Check out the activities documentation pages to learn what permissions they need.

   • Calendário

     • Calendários.Leia
     • Calendários.ReadWrite

   • Arquivos

     • Arquivos.Read
     • Arquivos.Ler.Todos
     • Arquivos.ReadWrite
     • Arquivos.ReadWrite.All

   • Sites

     • Sites.Read.All
     • Sites.ReadWrite.All

   • Email

     • Mail.Read
     • Mail.ReadWrite
     • E-mail.Enviar
   • Usuários
     • User.Read

   • Shared (scopes needed to access resources that are shared with, but not owned by, the user.)

     • Mail.Read.Shared
     • Mail.ReadWrite.Shared
     • Mail.Enviar.Compartilhado
     • Calendars.Read.Shared
     • Calendars.ReadWrite.Shared

   • Select Add permissions to return to your list of API permissions.

     
     

     

     
     

7. Make sure your API permissions include your added Calendars, Files, User, and Mail permissions.

   
   

   

   
   

Crie seu projeto no Studio Desktop

1. Crie um novo projeto de automação.

   1. Abra o UiPath Studio.

   2. Under New Project, click Process. This opens a New Blank Process window.

   3. Insira um Nome, Locale Descriçãodo projeto.

   4. Escolha a compatibilidade. O Windows é selecionado por padrão.

   5. Clique em Criar.

2. Instale o pacote UiPath.MicrosoftOffice365.Activities .

   1. From the Design ribbon, select Manage Packages.
   2. Em Todos os Pacotes, na barra de Pesquisa , insira Office 365 ou Microsoft.
   3. Select the package version you want, then select Install.
   4. Clique no botão Salvar .
   Para obter mais informações sobre os pacotes do UiPath Studio, consulte Gerenciando pacotes no Guia do Studio.

Está feito!Agora que concluiu a configuração, você pode começar a adicionar as atividades Microsoft 365 ao seu projeto.

Próximas Etapas

Para um aprendizado prático e para começar a usar as atividades rapidamente, consulte os Guias de início rápido . Esses guias fornecem instruções passo a passo para ajudar você a criar amostras de trabalho das diferentes atividades para que você possa verificar a conexão com seu aplicativo registrado e se familiarizar com as propriedades de entrada/saída.

To learn more about the Microsoft 365 activities (including example property inputs/outputs), see the Classic activities for a complete list and links to the activity detailed pages.