Autenticação do Microsoft Teams

Pré-requisitos

Para autenticar, você precisa das seguintes credenciais:

• Escopo, ID do cliente, Segredo do cliente (para Traga seu próprio aplicativo OAuth 2.0)

O campo Escopo representa os escopos padrão para operações regulares do usuário: OnlineMeetingTranscript.Read.All, OnlineMeetingRecording.Read.All, Team.ReadBasic.All, TeamMember.ReadWrite.All, Channel.Create, Channel.ReadBasic.All, ChannelMember.ReadWrite.All, ChannelMessage.Send, ChannelMessage.Read.All, Chat.ReadWrite, ChatMember.ReadWrite, Calendars.ReadWrite, OnlineMeetings.ReadWrite, Files.Read.All, User.Read, profile, openid, email, offline_access.

Você pode adicionar ou remover escopos para personalizar as permissões de usuário para sua conexão. Para obter mais detalhes, consulte a seção Escopos abaixo, bem como a documentação da Microsoft: referência das permissões do Microsoft Graph.

Para criar um aplicativo OAuth2 privado, siga as etapas descritas na documentação do Microsoft Teams: Configurar a autenticação do OAuth de terceiros - Teams.

Além disso, você deve conceder permissões para aplicativos de terceiros acessarem suas informações.

Conceder permissões

Para usar o aplicativo UiPath para Microsoft Teams ou seu próprio aplicativo OAuth 2.0 privado, você deve conceder consentimento para as permissões do aplicativo. Siga as etapas descritas em Conceder o consentimento de administrador de toda a organização para as permissões de um aplicativo.

Adicionar a conexão do Microsoft Teams

Para criar uma conexão com sua instância do Microsoft Teams, você precisa realizar as seguintes etapas:

1. Selecione Integration Service no Automation Suite.

2. Na lista Conectores , selecione Microsoft Teams. Você também pode usar a barra de pesquisa para restringir o conector.

3. Selecione Conectar-se ao Microsoft Teams.

4. Você será redirecionado para a página de conexão.

5. Insira as credenciais necessárias.

6. Selecione Conectar.

7. Sua conexão foi adicionada.

Para obter mais informações sobre a autenticação no Microsoft Teams, consulte a página Autenticação e autorização da Microsoft.

Escopos e permissões

Você pode usar essa conexão para habilitar o pacote de atividades Microsoft Teams no UiPath Studio para criar automações para gerenciamento de usuários e canais, mensagens e outras formas de trabalhar em equipe. Os vários casos de uso baseados em permissão que podem ser alcançados são os seguintes:

Escopo	Use case	Atividade ou evento
openid (obrigatório)	Ao usar essa permissão, um aplicativo pode receber um identificador exclusivo para o usuário na forma da subdeclaração. A permissão também dá ao aplicativo acesso ao endpoint UserInfo . O escopo openid pode ser usado no endpoint do token da plataforma de identidade da Microsoft para adquirir tokens de ID. O aplicativo pode usar esses tokens para autenticação	N/A
offline_access (obrigatório)	Necessário para receber o token de atualização no endpoint de solicitação de autenticação. Quando você troca um código de autorização no fluxo de código de autorização do OAuth 2.0 sem o escopo offline_access, você não recebe o token de atualização do ponto de extremidade /token.	N/A
profile (obrigatório)	Recuperar o perfil do usuário atual, como nome, nome de usuário, e-mail etc., para que possa ser usado como usuário padrão/autenticado na criação da conexão e em determinadas atividades	N/A
email (obrigatório)	Permite que o aplicativo leia todos os endereços de e-mail primários de seus usuários, para enviar mensagens ou convidá-los para um canal	Enviar mensagem de chat individual Convidar membro para o canal Convidar usuário para a equipe
User.Read (Recomendado)	Permite que os usuários façam login no aplicativo, e permite que o aplicativo leia o perfil de usuários conectados. Isso também permite que o aplicativo leia informações básicas da empresa dos usuários conectados	Obter Registro → Eu
Team.Create	Criar uma equipe para convidar e envolver os usuários respectivos	Inserir registro → Teams
Team.ReadBasic.All	Recupere a lista de equipes a serem selecionadas nas atividades, como enviar uma mensagem de canal etc.	Criar canal List All Channels Send chat message Enviar mensagem de chat individual Convidar membros para o canal Reply to a channel message Send channel message Obter equipe pelo nome
TeamMember.ReadWrite.All	Adicionar membro a uma equipe em nome do usuário conectado Recuperar a lista de membros de uma equipe	Listar todos os membros da equipe Convidar usuário para a equipe Inserir registro → Membros das equipes Listar todos os registros → Membros das equipes
Channel.Create	Crie um canal (padrão/privado) para convidar e envolver os respectivos usuários da equipe	Criar canal
Channel.ReadBasic.All	Recuperar a lista de canais de uma equipe a serem selecionados nas atividades, como envio de mensagem de canal etc.	Convidar membros para o canal Obter canal pelo nome Responder à mensagem do canal Send channel message
ChannelMember.ReadWrite.All	Adicionar membro a um canal em nome do usuário conectado Recuperar a lista de membros envolvidos em um canal	Convidar membros para o canal Listar todos os registros → Membros dos canais de equipes
ChannelMessage.Send	Envie uma mensagem em um canal. Além disso, responda a uma mensagem em um thread, se necessário.	Responder à mensagem do canal Send channel message
ChannelMessage.Read.All	Permite que o aplicativo leia todas as mensagens de canal no Microsoft Teams, sem um usuário conectado Usado também para disparar eventos sempre que uma mensagem for publicada no canal ou sempre que uma palavra-chave for mencionada no canal	Responder à mensagem do canal Listar todas as mensagens do canal Listar Todos os Registros → Mensagens dos Canais de Equipes Quando uma mensagem for publicada no canal (futuro) Quando uma palavra-chave ou nome de usuário é mencionado no canal (Futuro)
Chat.ReadWrite	Permite que o aplicativo leia e envie sua versão 1:1 Permite que o aplicativo leia e envie mensagens de chat em grupo Também usado para disparar eventos sempre que uma mensagem de chat for publicada	Enviar mensagem no chat em grupo Enviar mensagem de chat individual Listar todas as mensagens Listar todos os registros → Chats Quando uma mensagem do chat for publicada (futuro)
ChatMember.ReadWrite	Adicionar membro a um chat em nome do usuário conectado Recuperar a lista de membros envolvidos em um chat	Inserir Registro → Membros do chat Listar todos os registros → Membros dos chats
Calendars.ReadWrite	Crie uma entrada de calendário do Outlook da reunião online do Teams.	Create Online Teams Meeting
OnlineMeetings.ReadWrite	Crie uma reunião online no Microsoft Teams e recupere o ID, a senha e o URL da reunião em nome do usuário atual.	Create Online Teams Meeting
Files.Read.All	Recuperar as informações do arquivo que foram carregadas no SharePoint para compartilhá-las em um canal ou chat do Teams	Send channel message Enviar mensagem no chat em grupo Enviar mensagem de chat individual Responder à mensagem do canal