Autenticação do Microsoft Teams

Pré-requisitos

Dependendo do tipo de autenticação selecionado, você precisará de uma das seguintes credenciais:

• Código de autorização do OAuth 2.0: escopo, nome de usuário e senha da Microsoft
• Traga seu próprio aplicativo OAuth 2.0: Escopo, ID do Cliente, Segredo do Cliente, ID do Tenant

Para criar um aplicativo OAuth2 privado, siga as etapas descritas na documentação do Microsoft Teams: Configurar autenticação OAuth de terceiros - Teams. Além disso, você deve conceder permissões para aplicativos de terceiros para acessar suas informações.

Observação:

Por meio do método de autenticação de aplicativo Traga seu próprio OAuth 2.0, oferecemos suporte a aplicativos de multitenant e de tenant único. Se você estiver usando um aplicativo multitenant, mantenha o valor padrão para o ID do tenant (common). Se você estiver usando um aplicativo de tenant único, recupere o ID do tenant do Azure. Consulte Como encontrar seu ID de tenant do Microsoft Entra.

O campo Escopo representa os escopos padrão para operações de usuário regulares:

OnlineMeetingTranscript.Read.AllOnlineMeetingRecording.Read.AllTeam.ReadBasic.AllTeamMember.ReadWrite.AllChannel.CreateChannel.ReadBasic.AllChannelMember.ReadWrite.AllChannelMessage.SendChannelMessage.Read.AllChat.ReadWriteChatMember.ReadWriteCalendars.ReadWriteOnlineMeetings.ReadWriteFiles.Read.AllUser.Readprofileopenidemailoffline_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, bem como a documentação da Microsoft: referência de permissões do Microsoft Graph.

Conceder permissões

Para usar o aplicativo UiPath para Microsoft Teams ou seu próprio aplicativo OAuth 2.0 privado, você deve conceder consentimento às permissões do aplicativo. Siga as etapas descritas em Conceder consentimento de administrador em toda a organização às 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 menu de navegação esquerdo.
2. Na lista Conectores , selecione Microsoft Teams. Você também pode usar a barra de pesquisa para restringir o conector.
3. Selecione Conectar ao Microsoft Teams.
4. Agora, você é redirecionado para a página de conexão. É possível escolher entre dois tipos de autenticação: Código de autorização do OAuth 2.0 ou Traga seu próprio aplicativo do OAuth 2.0.
5. Insira as credenciais necessárias.
6. Select Connect.

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 conjunto. 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)	Obrigatório para receber o token de atualização no ponto de extremidade de solicitação de autenticação. Quando você simula 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 um 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 lista de canais Todos os canais Enviar mensagem de chat Enviar mensagem de chat individual Convidar membro para um canal Responder a uma mensagem de canal Enviar mensagem do canal Obter equipe por 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 membro para um canal Obter canal pelo nome Responder à mensagem do canal Enviar mensagem do canal
ChannelMember.ReadWrite.All	Adicionar membro a um canal em nome do usuário conectado Recuperar a lista de membros envolvidos em um canal	Convidar membro para um 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 a mensagem do canal Enviar mensagem do canal
ChannelMessage.Read.All	Permite que o aplicativo leia todas as mensagens do canal no Microsoft Teams, sem um usuário conectado Também é usado para disparar eventos sempre que uma mensagem é publicada no canal ou sempre que uma palavra-chave é mencionada no canal	Responder a Mensagem do canal Listar todas as Mensagens do canal Listar todos os registros → Mensagens dos canais do Teams Quando uma mensagem for publicada no canal (Futrino) Quando uma palavra-chave ou nome de usuário for mencionado no canal (Future)
Chat.ReadWrite	Permite que o aplicativo leia e envie suas mensagens 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 de chat em grupo Enviar mensagem de chat individual Listar Todas as Mensagens de Chat Listar Todos os Registros → Chats Quando uma mensagem de chat for publicada (Futura)
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 dos chats 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	Enviar mensagem do canal Enviar mensagem de chat em grupo Enviar mensagem de chat individual Responder à mensagem do canal