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

Visão geral

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

Este exemplo de trabalho permite que você verifique rapidamente a conexão com seu aplicativo Microsoft Teams registrado e se familiarize 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 seu aplicativo Microsoft Teams registrado (Microsoft Teams Scope).
2. Encontra e retorna uma equipe que corresponda à sua consulta de pesquisa de equipe (Get Teams).
3. Encontra e retorna o canal, da sua equipe especificada, que corresponde à sua consulta de pesquisa de canal (Obter canais).
4. Recupera todas as mensagens do canal especificado (Get Messages).

5. Verifica se as mensagens foram recuperadas emitindo o conteúdo do corpo da mensagem e retornando as respostas das mensagens (For Each e Write Line, e Get Message Reply).

   
   

   

   
   

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á! da UiPath!
     • Resposta 1: oi, oi, oi
     • Resposta 2: Que bom estar aqui!
     • Mensagem 2: A que horas é a 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, InterativoToken).

   • Para obter mais informações, consulte a página de atividade Automação não assistida vs. Automação assistida na página de atividades do 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, MinhasEquipes

6. Insira suas QueryOptions para encontrar uma equipe específica da 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 seu valor de Teams (por exemplo, myTeams).
   • Ao criar sua variável, selecione Microsoft.Graph.Team como o tipo de variável.
8. Adicione a atividade Get Channels após a atividade Get Teams .

9. Insira suas QueryOptions para encontrar um canal específico da 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 IDDaEquipe , 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, myChannels).
    • Ao criar sua variável, selecione Microsoft.Graph.Channel como o tipo de variável.
12. Adicione a atividade Get Messages após a atividade Get Channels .
13. Na propriedade IdDoCanal , 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 no fim da variável (por exemplo, myChannels(0).Id).
14. Na propriedade IDDaEquipe , 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 de saída, 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, myMessages).

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

      
      

      

      
      

Teste seu projeto

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

   1. Na propriedade ArgumentoDeTipo , selecione Microsoft.Graph.ChatMessage.
   2. Na propriedade Valores , insira 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 Texto , insira "Message: "+ item.Body.Content

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

   1. Na propriedade IdDoCanal , 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 no fim da variável (por exemplo, myChannels(0).Id).
4. Para limitar o número de mensagens de saída, insira um número baixo na propriedade Limite (por exemplo, 2).
5. Na propriedade IdDaMensagem , insira Item.Id para obter as respostas de cada mensagem recuperada.
6. Na propriedade IDDaEquipe , 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 Replys .

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

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

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

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

    
    

    

    
    

Está feito!

Quando estiver pronto, experimente os outros guias de início rápido para se familiarizar 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