Início rápido — obtenha equipes, canais e mensagens

Visão geral

O objetivo deste guia é ajudar você a criar uma amostra de trabalho que usa diferentes atividades do Microsoft Teams, incluindo Get Teams, Get Channels, Get Messages e atividades.

Este exemplo de trabalho permite verificar rapidamente a conexão com seu aplicativo Microsoft Teams registrado e se familiarizar com os tipos de dados de entrada/saída da atividade.

Depois de concluir as etapas deste guia, você terá uma sequência de automação que faz o seguinte:

1. Estabelece uma conexão com o aplicativo Microsoft Teams registrado (Escopo do Microsoft Teams).

2. Encontra e retorna uma equipe que corresponda à sua consulta de pesquisa da equipe (Get Teams).

3. Encontra e retorna o canal, da equipe especificada, que corresponda à sua consulta de pesquisa de canal (Get Channels).

4. Recupera todas as mensagens do canal especificado (Get Messages).

5. Verifica se as mensagens foram recuperadas exibindo o conteúdo do corpo da mensagem e retornando quaisquer respostas de mensagem (For Each and Write Line e Get Message Replies).

   

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de Configuração do Microsoft Teams.
2. Crie ou use uma Equipe e um Canal existentes. Envie pelo menos uma mensagem e responda a essa mensagem.
   • Para usar os mesmos valores que neste guia, crie e envie o seguinte:
     • Nome da equipe: Quickstart_Test1
     • Canal: QS4_Channel
     • Mensagem 1: Olá, UiPath!
     • Resposta 1: Ei, ei, ei
     • Resposta 2: Que bom estar aqui!
     • Mensagem 2: qual é a hora da reunião?
     • Resposta 1: 11h

Etapas

Crie seu projeto

1. Adicione a atividade Microsoft Teams Scope ao seu projeto.
2. Insira o IdDoAplicativo para seu aplicativo registrado.
   • Para obter mais informações, consulte a seção Registrar seu aplicativo no guia de Configuração .
3. Na lista suspensa TipoDeAutenticação , selecione o fluxo de autenticação aplicável (por exemplo, InteractiveToken).
   • Para obter mais informações, consulte a página Automação Unattended vs. Attended na atividade Microsoft Teams Scope .
4. Adicione a atividade Get Teams após a atividade Microsoft Teams Scope .
5. Selecione o tipo de equipes que você deseja recuperar na lista suspensa TipoDeLista (por exemplo, MyJoinedTeams)
6. Insira suas OpçõesDeConsulta para encontrar uma equipe específica na sua lista de equipes (por exemplo, {New QueryOption("filter", "displayName eq 'Team Name'")}).
   • Para obter mais informações, consulte a seção QueryOptions na página da atividade Get Teams .
7. Crie e insira uma variável Team[] para o valor do seu Teams (por exemplo, minhasEquipes).
   • Ao criar sua variável, selecione *Microsoft.Graph.Team
   • como o tipo da variável.
8. Adicione a atividade Get Channels após a atividade Get Teams .
9. Insira suas OpçõesDeConsulta para encontrar um canal específico da sua equipe especificada (por exemplo, {New QueryOption("filter", "displayName eq 'Channel Name'")}).
   • Para obter mais informações, consulte a seção QueryOptions na página da atividade Get Channels .
10. Na propriedade TeamId , insira a variável Team[] que você criou para a atividade Get Teams . Para inserir um valor String , especifique o item na matriz e anexe .Id ao final da variável (por exemplo, myTeams(0).Id).
11. Crie e insira uma variável Channel[] para seu valor de Canais (por exemplo, meusChannels).
    • Ao criar sua variável, selecione *Microsoft.Graph.Channel
    • como o tipo da variável.
12. Adicione a atividade Get Messages após a atividade Get Channels .
13. Na propriedade ChannelId , insira a variável Channel[] que você criou para a atividade Get Channels . Para inserir um valor String , especifique o item na matriz e anexe .Id ao final da variável (por exemplo, meusChannels(0).Id).
14. Na propriedade TeamId , insira a variável Team[] que você criou para a atividade Get Teams . Para inserir um valor String , especifique o item na matriz e anexe .Id ao final da variável (por exemplo, myTeams(0).Id).
15. Para limitar o número de mensagens que você gerará, insira um número baixo na propriedade Limite (por exemplo, 5).
16. Crie e insira uma variável ChatMessage[] para seu valor de Mensagens (por exemplo, minhasMensagens).

    • Ao criar sua variável, selecione *Microsoft.Graph.ChatMessage

    • como o tipo da variável.

      

Teste seu projeto

1. Para testar se suas atividades recuperaram a equipe, canal e mensagens, adicione uma atividade For Each após a atividade Get Messages .

   1. Na propriedade ArgumentoDeTipo , selecione Microsoft.Graph.ChatMessage.
   2. Na propriedade Values , digite a variável ChatMessage[] que você criou para a atividade Get Messages (por exemplo, myMessages).

2. Na atividade For Each , adicione uma atividade Write Line .

   1. Na propriedade Text , digite "Message: "+ item.Body.Content

3. Adicione a atividade Get Message Replies após a atividade Write Line .

   1. Na propriedade ChannelId , insira a variável Channel[] que você criou para a atividade Get Channels . Para inserir um valor String , especifique o item na matriz e anexe .Id ao final da variável (por exemplo, meusChannels(0).Id).

4. Para limitar o número de mensagens que você gerará, insira um número baixo na propriedade Limite (por exemplo, 2).

5. Na propriedade MessageId , insira Item.Id para obter cada uma das respostas das mensagens recuperadas.

6. Na propriedade TeamId , insira a variável Team[] que você criou para a atividade Get Teams . Para inserir um valor String , especifique o item na matriz e anexe .Id ao final da variável (por exemplo, myTeams(0).Id).

7. Crie e insira uma variável ChatMessage[] para seu valor de MessageReplies (por exemplo, myReplies).

   • Ao criar sua variável, selecione Microsoft.Graph.ChatMessage como o tipo de variável.

8. Adicione outra atividade For Each após a atividade Get Message Replies .

   1. Na propriedade ArgumentoDeTipo , selecione Microsoft.Graph.ChatMessage.
   2. Na propriedade Values , digite a variável ChatMessage[] que você criou para a atividade Get Message Replies (por exemplo, myReplies).

9. Na atividade For Each , adicione uma atividade Write Line .

   1. Na propriedade Text , digite "Reply: "+ item.Body.Content

10. Clique em Executar e verifique se a janela Saída inclui suas mensagens e respostas associadas.

    

Está feito!

Quando você estiver pronto, tente os outros guias de Início rápido para se familiarizar mais com as diferentes atividades do Microsoft Teams.

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