Início rápido — obter chats e enviar 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 Chats, Get Chat Members, Send Message e Get Message .

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. Recupera todos os seus chats (Get Chats).
3. Recupera os membros de cada um dos seus chats (For Each e Get Chat Members).
4. Localiza o chat que inclui um membro específico do chat e envia uma mensagem (If, Assign e Send Message).

5. Verifica se a mensagem foi enviada com sucesso ao recuperar e gerar o ID da mensagem e o conteúdo da mensagem (Get Message e Write Line).

   
   

   

   
   

Pré-requisitos

Antes de você começar:

1. Conclua as etapas de configuração do Microsoft Teams.
2. Crie ou use um chat existente e envie pelo menos uma mensagem.

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 Chats após a atividade Microsoft Teams Scope .

   1. Crie e insira uma variável Chat[] para seu valor de Chats (por exemplo, myChats).
      • Ao criar sua variável, selecione Microsoft.Graph.Chat como o tipo de variável.
   2. Adicione uma atividade For Each após a atividade Get Chats .
   3. Na propriedade ArgumentoDeTipo , selecione Microsoft.Graph.Chat.
   4. Na propriedade Valores , insira a variável Chat[] que você criou para a atividade Get Chats (por exemplo, myChats).

5. Na atividade For Each , adicione uma atividade Assign.

   1. Criar e insira uma variável String para a propriedade To (por exemplo, chatId)

   2. Na propriedade Value , insira item.Id.

      • Criar e atribuir o valor de item.id a essa variável permite que ele seja usado em uma atividade For Each posterior que tenha um tipo de argumento diferente.
   3. Adicione a atividade Get Chat Members após a atividade Assign .
   4. Na propriedade ChatId , insira Item.Id para obter os membros de cada chat.
   5. Crie e insira uma variável ConversationMember[] para seu valor do ChatMembers (por exemplo, myChatMembers).
      • Ao criar sua variável, selecione Microsoft.Graph.ConversationMember como o tipo de variável.
   6. Adicione outra atividade For Each após a atividade Get Chat Members .
   7. Na propriedade ArgumentoDeTipo , selecione Microsoft.Graph.ConversationMember.
   8. Na propriedade Valores , insira a variável ConversationMember[] que você criou para a atividade Get Chat Members (por exemplo, myChatMembers).

6. Na atividade For Each , adicione uma atividade If .

   1. Na propriedade Condição , insira um valor para identificar um chat específico por membro (por exemplo, item.DisplayName="Saah Connor")

7. No bloco da sequência Then , adicione a atividade Send Message .

   1. Na propriedade ChatId , insira a variável String que você criou para a atividade Assign (por exemplo, chatId).
   2. Insira o conteúdo do Corpo que você deseja enviar (por exemplo, "Só dizer oi")
   3. Na propriedade TipoDeCorpo , insira BodyType.Text.
   4. Crie e insira uma nova variável String para seu valor de IdDaMensagem (por exemplo, newMessageId)
      
      

      

      
      

Teste seu projeto

1. Para testar se suas atividades recuperaram seus chats, membros do chat e enviaram uma mensagem, adicione uma atividade Write Line após a atividade Send Message .

   1. Na propriedade Texto , insira a variável String que você criou para a atividade Send Message (por exemplo, newMessageId)

2. Adicione a atividade Get Message após a atividade Write Line .

   1. Na propriedade ChatId , insira a variável String que você criou para a atividade Assign (por exemplo, chatId).
   2. Na propriedade IdDaMensagem , insira a variável String que você criou para a atividade Send Message (por exemplo, newMessageId).
      3. Crie e insira uma variável ChatMessage para seu valor de Message (por exemplo, newMessage).
      • Ao criar sua variável, selecione _Microsoft.Graph.ChatMessage_ como o tipo de variável.
   3. Adicione outra atividade Write Line abaixo da atividade Get Message .
   4. Na propriedade Text , insira a variável ChatMessage que você criou para a atividade Get Message e anexe .Body.Content no final dela (por exemplo, newMessage.Body.Content)

3. Clique em Executar e verifique se a janela Saída inclui o ID e o conteúdo da mensagem que você enviou.

   
   

   

   
   

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