Autenticação do Microsoft Teams

Pré-requisitos

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

Scope, seu nome de usuário e senha da Microsoft (para o código de autorização do OAuth 2.0)
Escopo, ID do cliente, Segredo do cliente (para Traga seu próprio aplicativo OAuth 2.0)

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

Team.Create Channel.Create ChannelMember.ReadWrite.All
                     ChannelMessage.Send Chat.ReadWrite ChannelMessage.Read.All
                     Calendars.ReadWrite

Você pode adicionar ou remover escopos para personalizar as permissões de usuário para sua conexão. Para obter detalhes sobre escopos, consulte a seção Escopos abaixo, bem como a documentação da Microsoft: referência de 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 que apps de terceiros acessem suas informações.

Conceda permissões para aplicativos de terceiros

Antes de estabelecer a conexão, certifique-se de que as permissões sejam concedidas para aplicativos integrados do centro de administração:

Faça login no centro de administração do Microsoft 365.
Acesse Configurações e selecione Configurações da organização .
Na guia Serviços , selecione Consentimento do usuário para aplicativos.
Certifique-se de que a caixa de seleção Permitir que os usuários forneçam consentimento quando os aplicativos solicitarem acesso aos dados da sua organização em seu nome esteja habilitada e selecione Salvar.

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:

Select Integration Service from Automation Cloud^TM.
Na lista Conectores , selecione Microsoft Teams. Você também pode usar a barra de pesquisa para restringir o conector.
Selecione o botão Adicionar conexão .
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.
Insira as credenciais necessárias.
Selecione Conectar.
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:

`Scope`	Use case	Atividade/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