Microsoft Teams

Atividades do Microsoft Teams para automatizar interações com canais, chats e mensagens do Teams por meio da API do Microsoft Graph.

Visão geral

O Microsoft Teams é um aplicativo de colaboração que ajuda sua equipe a se organizar e conversar, tudo em um só lugar.

As atividades do Microsoft Teams oferecem a capacidade de automatizar interações com seu aplicativo Microsoft Teams. Integrando-se à API do Microsoft Graph beta, esse pacote de atividades permite que seus Robôs gerenciem seus Canais e Equipes, recuperem Chats e recebam e enviem Mensagens.

Se você estiver pronto para começar a usar as atividades Microsoft Teams, consulte a seção Começar abaixo. Para saber mais sobre o pacote, continue lendo para ver Como ele funciona e as Referências técnicas.

Importante:

Esse pacote de atividades é compatível com projetos legados do Windows e do Windows. Não é compatível com projetos multiplataforma. Recomendamos que você use o pacote de atividades Microsoft Teams do Integration Service.

Observação:

Consulte a página Ciclo de vida do produto para compatibilidade e suporte da versão do UiPath Studio.

Como funciona

Para habilitar a automação de saída entre o UiPath e o Microsoft Teams, as atividades Microsoft Teams estabelecem uma conexão autenticada com o seu aplicativo Microsoft Teams por meio da atividade Microsoft Teams Scope .

Depois que sua conexão for estabelecida, você pode adicionar as outras atividades do Microsoft Teams para criar novos projetos de automação ou adicioná-las a projetos existentes para estender os recursos de automação para incluir o aplicativo Microsoft Teams.

Como ele se conecta?

É aqui que precisamos da sua ajuda.

Para estabelecer uma conexão autenticada, as atividades do Microsoft Teams precisam de autorização da plataforma de identidade da Microsoft.

Para habilitar a autorização, registre primeiro seu aplicativo Microsoft Teams no seu Azure Active Directory (usando sua conta pessoal, profissional e/ou escolar do Microsoft Office 365). Ao registrar seu aplicativo, você atribui permissões de API do Microsoft Graph para especificar os recursos que seu Robot pode acessar em seu nome.

Depois de registrar seu aplicativo Microsoft Teams, o Azure Active Directory atribui a ele um ID exclusivo de aplicativo (cliente), que você insere na atividade Microsoft Teams Scope . A IdDoAplicativo é usada para coletar as informações necessárias sobre seu aplicativo registrado para iniciar a autenticação e obter o token de acesso para estabelecer a conexão.

Como isso é diferente das atividades do Microsoft Office 365?

Os requisitos de configuração e técnicos para os pacotes de atividades do Microsoft Office 365 e Microsoft Teams são os mesmos, exceto pelas permissões de API do Microsoft Graph, que você atribui ao registrar seu aplicativo.

Tanto as atividades Microsoft Office 365 quanto Microsoft Teams dependem de uma atividade de escopo para coletar informações do seu aplicativo registrado (IdDoAplicativo). Na verdade, seu aplicativo registrado pode incluir as permissões necessárias para interagir com o Microsoft Teams e os outros aplicativos do Microsoft Office 365 - resultando em um único IdDoAplicativo que tem permissões para todos os aplicativos que você deseja automatizar.

A diferença e a razão pela qual existem duas atividades de escopo (Microsoft Office 365 Scope e Microsoft Teams Scope) são os pontos de extremidade da API do Microsoft Graph que estão sendo usados. Atualmente, as atividades Microsoft Office 365 usam a API do Microsoft Graph, enquanto as atividades do Microsoft Teams usam a API do Microsoft Graph Beta. Devido a esses diferentes pontos de extremidade, cada pacote precisa de sua própria atividade de escopo para estabelecer uma conexão.

No futuro, ambos os pacotes compartilharão a atividade Microsoft Office 365 Scope com o Teams sendo adicionado como uma opção de propriedade de Serviços (além dos existentes E-mail, Arquivos, Calendário).

Referências técnicas

Cada atividade do Microsoft Teams chama uma API do Microsoft Graph usando os parâmetros de solicitação que você insere nas propriedades de entrada da atividade. Se a chamada for bem-sucedida, a atividade gera os elementos de resposta relevantes (ou seja, propriedades de saída) que você pode usar como valores da propriedade de entrada em atividades subsequentes, itens de fila em uma fila existente e assim por diante.

Para obter uma lista completa das APIs do Microsoft Graph usadas por cada atividade e links para a documentação da API relevante, consulte a página. Você não precisa estar familiarizado com as APIs do Microsoft Graph para usar as atividades. Esses links são para apenas para fins informativos, caso você queira saber mais sobre a ação que acontece "nos bastidores".

Introdução

Antes de você criar seu primeiro projeto, conclua as etapas no guia de Configuração .

Depois de concluir as etapas de configuração, 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 se familiarizar com 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