Configuração

Introdução

Para habilitar as atividades do Microsoft Teams, seu aplicativo deve estar integrado à 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á garantir a adição do 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 do Microsoft Office Teams, o Azure Active Directory atribui um ID de aplicativo exclusivo (cliente) que você insere no escopo do Microsoft Office Teams.

Observação:

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

Após adicionar as permissões, você poderá usar o mesmo IdDoAplicativo nas atividades do Microsoft Office 365 Scope e do Microsoft Teams Scope .

Etapas

1. Registre seu aplicativo

1. Entre no portal do Azure usando sua conta pessoal, profissional ou escolar do Microsoft Office 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. Em Tipos de conta suportadas, selecione a opção que se aplica a você.

   • 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.
   • Em URI de redirecionamento (opcional), insira um endereço de URI (se aplicável).
   • A seleção depende do tipo de autenticação. Para obter mais informações sobre esse tópico, consulte a página de detalhes da atividade Automação não assistida e assistida no escopo do Microsoft Teams ).
   • 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. Clique em Registrar.

   
   

   

   
   
   Observação:

   Hoje, a Biblioteca de Autenticação da Microsoft (MSAL.NET) usa urn:ietf:wg:oauth:2.0:oob como o URI de redirecionamento padrão. Esse valor provavelmente funcionará para você ao usar o tipo de autenticação InteractiveToken (usamos esse em todos os exemplos) e guias de início rápido).

   No futuro, a Microsoft planeja alterar o URI de redirecionamento padrão para https://<span>login.microsoftonline.com/common/oauth2/nativeclient</span>, então, considere usar este.

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

2. Adicionar permissões de API

1. Na página do aplicativo registrado (portal do Azure > Azure Active Directory > registros de aplicativo > Office365App), clique em permissões de API no painel de navegação à esquerda.
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. Em Que tipo de permissões seu aplicativo requer? e clique em Permissões delegadas para mostrar a lista de permissões.

   • Embora as permissões do aplicativo também funcionem, as atividades são projetadas para aplicativos com permissões delegadas atribuídas às APIs do Microsoft Graph.
   • 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:

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

7. Clique em Adicionar permissões (retornando à sua lista de permissões de API)

   
   

   

   
   

8. Verifique se as permissões da API incluem as permissões do Chat, Grupo e Usuário .

   
   

   

   
   

3. Crie seu projeto

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

   1. Abra o UiPath Studio.
   2. Em Novo projeto, clique em Processo (isso abre uma janela Novo processo em branco ).
   3. Insira um Nome,Locale Descriçãopara o projeto.

   4. Clique em Criar.

      
      

      

      
      

2. Instale o pacote UiPath.MicrosoftTeamsActivities .

   1. Na faixa de opções Design , clique em Gerenciar pacotes (isso abre a janela Gerenciar pacotes ).
   2. Em Todos os pacotes, clique em Ir!
   3. Na barra de Pesquisa , insira Teams.

   4. Clique em, instale e aceite a licença do UiPath.Teams.Activities.

      • Para obter mais informações sobre os pacotes do Uipath Studio, consulte Gerenciando 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 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 conhecer 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