Configuração

Introdução

Para habilitar as atividades do Microsoft Teams, 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, primeiro você precisa decidir se criará seu próprio aplicativo ou usará o aplicativo UiPath (por exemplo, UiPathStudioO365App).

Importante:

Se você estiver usando o aplicativo UiPath, precisará certificar-se de adicionar o consentimento do administrador.

Se você não adicionar o consentimento do administrador, verá o erro abaixo.

Se estiver criando seu próprio aplicativo, você precisará seguir as etapas abaixo.

Após registrar seu aplicativo Microsoft Office Teams, o Azure Active Directory atribui uma ID de aplicativo (cliente) exclusiva, que você insere no Microsoft Office Teams Scope.

Observação:

Se você já concluiu as Atividades do Microsoft Office 365 ou tiver um aplicativo registrado existente, pode acessar diretamente a seção Adicionar permissões de API e adicionar as permissões necessárias para as atividades do Microsoft Teams.

Depois de adicionar as permissões, você poderá usar o mesmo IdDoAplicativo nas atividades Microsoft Office 365 Scope e Microsoft Teams Scope .

Etapas

1. Registre seu aplicativo

1. Faça login no portal do Azure usando sua conta pessoal, profissional ou escolar do 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 obter mais informações sobre qual opção selecionar, veja abaixo as recomendações da Microsoft:
     • Contas apenas neste diretório organizacional - Use esta opção se seu público-alvo for interno à sua organização.
     • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) - use esta opção se seu público-alvo for clientes corporativos ou educacionais e para habilitar a multilocação.
     • Contas em qualquer diretório organizacional (qualquer diretório do Azure AD - multilocatário) e contas pessoais da Microsoft (por exemplo, Skype, Xbox) - Use esta opção para direcionar o conjunto mais amplo de identidades da Microsoft e habilitar a multilocação.
   • Under Redirect URI (optional), enter a URI address (if applicable).
   • Sua seleção depende do seu tipo de autenticação. Para obter mais informações sobre esse tópico, consulte a página de detalhes da atividade Automação Unattended e Attended no Microsoft Teams Scope ).
   • Em nosso exemplo, a organização oferece suporte à autenticação multilocatário e só pode usar o tipo de autenticação de token interativo, que requer um URI de redirecionamento.
   • Se o seu tipo de autenticação for Autenticação Integrada do Windows ou Nome de Usuário e Senha, você não precisará registrar um URI de redirecionamento para seu aplicativo. Esses fluxos fazem uma viagem de ida e volta para o ponto de extremidade v2.0 da plataforma de identidade da Microsoft e seu aplicativo não será chamado de volta em nenhum URI específico.
   • Para obter mais informações, consulte Registro de aplicativo de área de trabalho na documentação da plataforma de identidade da Microsoft.

7. Click Register.

   

   Observação:

   Today the Microsoft Authentication Library (MSAL.NET) uses urn:ietf:wg:oauth:2.0:oob as the default redirect URI and this value will likely work for you when using the InteractiveToken authentication type (we use this in all of our examples and Quickstart guides).

   In the future, Microsoft plans to change the default redirect URI to https://login.microsoftonline.com/common/oauth2/nativeclient, so you may consider using this instead.

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

2. Add API permissions

1. Na página do seu aplicativo registrado (Portal do Azure > Azure Active Directory > Registros de aplicativos > Office365App), clique em Permissões de API no painel de navegação à esquerda.

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. Em Que tipo de permissões seu aplicativo exige?, clique em Permissões delegadas para mostrar a lista de permissões.

   • While the Application permissions will also work, the activities are designed for apps with Delegated permissions assigned to the Microsoft Graph APIs.
   • Para obter mais informações sobre tipos de permissão, consulte a documentação do Microsoft Azure sobre Como configurar um aplicativo cliente para acessar APIs da web .

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

   • Chat.ReadWrite
   • Group.ReadWrite.All
   • Usuário.Ler.Todos

7. Click Add permissions (returning you to your list of API permissions)

   

8. Verifique se suas permissões de API incluem suas permissões adicionadas do Chat, Grupo e Usuário .

   

3. Crie seu projeto

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

   1. Open UiPath Studio.

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

   3. Enter a project Name, Location, and Description.

   4. Clique em Criar.

      

2. Instale o pacote UiPath.MicrosoftTeamsActivities .
   1. In the Design ribbon, click Manage Packages (this opens the Manage Packages window).
   2. Under All Packages, click Go!
   3. Na barra de pesquisa , insira Teams.
   4. Clique em, instale e aceite a licença para o UiPath.Teams.Activities.

      • Para obter mais informações sobre os pacotes do Uipath Studio, consulte o Gerenciamento de Pacotes no Guia do Studio.

        

Está feito!

Agora que você concluiu a configuração, pode começar a adicionar as atividades do Microsoft Teams ao seu projeto.

Próximas Etapas

Para uma experiência de aprendizado prática e para começar rapidamente a usar as atividades, 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.

Para saber mais sobre as atividades do Microsoft Teams (incluindo um exemplo de entradas/saídas de propriedades), consulte as seguintes páginas de atividades para uma lista completa de atividades e links para as páginas de detalhes das atividades.

• Canais
• Chats
• Mensagens
• Teams