Autenticação do Microsoft Teams

Conecte o UiPath ao Microsoft Teams usando a autenticação baseada em usuário OAuth 2.0, com suporte opcional de aplicativo personalizado e robô, no Automation Suite.

Este documento descreve como autenticar o Microsoft Teams com o UiPath Integration Service usando o OAuth 2.0. O conector do Microsoft Teams é compatível com a autenticação OAuth baseada em usuário, com suporte opcional para aplicativos personalizados OAuth e cenários habilitados para bots.

Visão geral

A tabela a seguir resume as opções de autenticação compatíveis e seus pré-requisitos.

Cenário de autenticação	Description	Pré-requisitos
Traga seu próprio aplicativo OAuth (BYOA)	Usa um aplicativo do Azure AD gerenciado pelo cliente	Aplicativo do Azure AD, ID do cliente, Segredo do cliente, ID do tenant, consentimento do administrador

Traga sua própria configuração do aplicativo OAuth (BYOA)

Configure seu aplicativo do Azure AD da seguinte maneira.

Configurações de aplicativos do Azure

Configuração	Valor
Fluxo do OAuth	Authorization Code
Redirecionamento/URL de retorno de chamada	https://{yourDomain}/provisioning_/callback
Tipos de conta compatíveis	Tenant único ou vários tenants
API	Microsoft Graph

ID do Tenant

Tipo de app	ID do Tenant
Multi-tenant	common
Tenant único	ID de tenant do Azure

Observação:

A UiPath é compatível com aplicativos de tenant único e de vários tenants.

Escopos e permissões

Os escopos controlam quais ações a UiPath pode executar no Microsoft Teams. Os escopos são configuráveis durante a criação da conexão.

Escopos obrigatórios

Os escopos a seguir são obrigatórios e não devem ser removidos. Eles são necessários para uma conexão bem-sucedida.

Escopo	Finalidade
openid	Autenticação do usuário e geração de token de ID
offline_access	Habilita a emissão de token de atualização
User.Read	Lê o perfil do usuário conectado

Observação:

A remoção de qualquer escopo obrigatório resultará em falhas de conexão ou autenticação do runtime.

Todos os escopos

Os escopos a seguir habilitam cenários comuns de automação do Microsoft Teams.

Escopo	Use case	Atividade ou evento
openid	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	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	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	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	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, Listar 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 de 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, Obter equipe pelo nome, 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.	Obter canal por nome, Convidar membro para um canal, Listar todos os canais, Listar canal por 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 à 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 à mensagem do canal, Listar todas as mensagens do canal, Listar todos os registros → Mensagens dos canais do Teams, Quando uma mensagem foi publicada no canal (Futchi), Quando uma palavra-chave ou nome de usuário é 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 ID da reunião, senha e URL 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 a mensagem do canal

Os escopos podem ser adicionados ou removidos para seguir os princípios de privilégio mínimo .

Tokens de atualização para aplicativos OAuth

Os tokens de atualização para aplicativos OAuth podem ser invalidados ou revogados a qualquer momento pela Microsoft. Isso pode acontecer por diferentes motivos, como tempos limite e revogação. Para obter detalhes, consulte a documentação oficial da Microsoft.

Observação:

A invalidação de tokens resulta em conexões com falha e as automações não podem ser executadas sem corrigir as conexões.

Esse problema afeta todos os conectores baseados no Microsoft Graph.

Certifique-se de seguir as práticas recomendadas da Microsoft ao criar seus aplicativos OAuth. Para obter detalhes completos sobre como criar um aplicativo Microsoft OAuth, consulte a documentação da Microsoft.

Conceder permissões

Para usar 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. Você será redirecionado para a página de conexão.
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.