Início rápido — obter chats e enviar mensagem

Crie um exemplo de automação que recupere os chats do Microsoft Teams e envie uma mensagem usando as atividades Get Chats, Get Chat Members e Send Message.

Visão geral

O objetivo deste guia é ajudar você a criar uma amostra de trabalho que usa diferentes atividades do Microsoft Teams, incluindo as atividades Get Chats, Get Chat Members, Send Message e Get Message .

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. 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 recuperando e gerando 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, 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 Chats após a atividade Microsoft Teams Scope .
   1. Crie e insira uma variável Chat[] para seu valor dos Chats (por exemplo, myChats).
      • Ao criar sua variável, selecione *Microsoft.Graph.Chat
      • como o tipo da 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 Values , digite a variável Chat[] que você criou para a atividade Get Chats (por exemplo, myChats).
5. Na atividade For Each , adicione uma Assign.
   1. Crie e insira uma variável String para a propriedade To (por exemplo, chatId)
   2. Na propriedade Valor , insira item.Id.
      • Como criar e atribuir o *item.id
      • a essa variável permite que ela seja usada 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 ChatMembers (por exemplo, myChatMembers).
      • Ao criar sua variável, selecione *Microsoft.Graph.ConversationMember
      • como o tipo da 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 Values , digite 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="Saray Connor")
7. No bloco de 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, "Saída Dindo oi")

   3. Na propriedade BodyType , 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, os 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 Enviar mensagem (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 MessageId , 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 Mensagem (por exemplo, novaMensagem).

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

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

   4. Na propriedade Text , digite 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 enviada.

   

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