Configure um Microsoft Teams para acionar uma ação quando um evento ocorrer no chat do Microsoft Teams monitorado. Este exemplo mostra como criar um Task Bot com um gatilho do Microsoft Teams para enviar um e-mail para uma caixa de entrada do Microsoft 365 Outlook quando um usuário publica uma mensagem em um canal específico dentro de uma equipe.

O exemplo a seguir demonstra como configurar um gatilho da Web do Microsoft Teams que inicia o fluxo de automação quando o usuário publica uma mensagem com o assunto Crítico no canal Geral da equipe de Suporte técnico.

Pré-requisitos

Certifique-se de que os seguintes pré-requisitos sejam atendidos:
  • Pré-requisitos mencionados nos gatilhos da Web do Microsoft Teams.
  • Conexão OAuth ativa para conta do Microsoft 365 Outlook e do Microsoft Teams.
  • Um certificado do Microsoft Azure válido armazenado no Credential Vault. Você pode usar o mesmo certificado para autenticar o gatilho e a ação.
  • Registrar variáveis nomeadas MSTeamsTriggerData e OutlookTriggerData.

Procedimento

  1. Execute as seguintes etapas para criar um Task Bot
    1. No painel da esquerda, clique em Automation (Automação).
    2. Clique em Criar > Task Bot.
      O assistente Criar bot de tarefa é exibido.
    3. Digite um nome apropriado para o bot no campo Nome.
      Todos os bots são armazenados na pasta <\Bots> por padrão.
    4. Opcional: Adicione uma descrição para o bot no campo Descrição.
    5. Opcional: Clique em Escolher e siga as instruções para salvar o bot em uma pasta diferente.
    6. Clique em Criar e editar.
      O bot é criado e a página Editor de bot é exibida.
  2. Execute as etapas a seguir para adicionar e configurar o gatilho da Web do Microsoft Teams.
    1. Clique em Gatilhos > Microsoft Teams, e depois clique duas vezes ou arraste o gatilho da Web para adicioná-lo à seção Gatilhos.
    2. Clique em Selecionar para escolher a conexão OAuth pré-configurada no modal Selecionar uma conexão OAuth.
    3. Selecione Equipes e canal > Chat em equipe para escolher chat em equipe como condição de gatilho.
    4. Selecione Quando uma nova mensagem de chat é adicionada em Monitorar evento.
    5. Insira Suporte técnico em Nome da equipe.
      Você também pode usar o botão Selecionar nome da equipe para navegar e selecionar a equipe no modal Equipes.
    6. Insira Geral em Nome do canal.
      Você também pode usar o botão Selecionar nome do canal para navegar e selecionar a equipe no modal Canais.
    7. Ative a caixa de seleção Filtro e, em seguida, insira Crítico no campo Palavras-chave para pesquisar.
    8. Selecione Certificado > Credenciais > Escolher e siga as instruções no modal Escolher uma credencial para selecionar o certificado do Microsoft Azure que já está disponível no Credential Vault.
    9. Selecione MSTeamsTriggerData na lista suspensa Resposta.
  3. Execute as seguintes etapas para adicionar e configurar a ação Message Box.
    1. Clique em Ações > Message Box e, em seguida, clique duas vezes ou arraste a ação Message Box para adicioná-la à seção Ações.
    2. Digite um título apropriado para a caixa de mensagens em Insira o título da janela da caixa de mensagens.
    3. Digite $MSTeamsTriggerData{subject}$ em Digite a mensagem a ser exibida.
      A chave assunto dos dados de resposta do gatilho contém o assunto da mensagem de chat como seu valor.
    A Message Box serve como um alerta para a mensagem do chat.
  4. Execute as etapas a seguir para adicionar e configurar a ação Conectar do Microsoft 365 Outlook.
    1. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste Conectar para adicionar a ação à seção Ações.
    2. Selecione Azure Global em Azure Cloud.
      Se o seu Microsoft 365 Outlook faz parte da versão governamental do Microsoft 365, escolha Azure US GCC High.
    3. Selecione Gerenciado pela Control Room em Modo de autenticação OAuth2.
    4. Clique em Escolher e siga as instruções no modal Escolher uma conexão OAuth para escolher a conexão OAuth para o Microsoft 365 Outlook.
    5. Clique em Variável > Inserir um valor e siga as instruções para escolher a credencial de nome de usuário do Microsoft 365 Outlook.
    6. Opcional: Insira um nome apropriado para a sessão em Criar sessão do Microsoft 365 Outlook.
      O sistema define Microsoft365OutlookSession como o nome da sessão por padrão.
  5. Execute as etapas a seguir para adicionar e configurar a ação Enviar do Microsoft 365 Outlook.
    1. Clique em Ações > Microsoft 365 Outlook e, em seguida, clique duas vezes ou arraste Enviar para adicionar a ação à seção Ações.
    2. Insira o nome da sessão que você informou ao configurar a ação Conectar.
      Se o nome padrão for mantido, o sistema preencherá automaticamente Microsoft365OutlookSession como a sessão do Microsoft 365 Outlook.
    3. Digite o ID de e-mail do Microsoft 365 Outlook para o qual os detalhes do arquivo devem ser encaminhados em Para.
    4. Digite um assunto apropriado em Assunto.
      Por padrão, o sistema define A Automation Anywhere terminou a execução do TaskBot como o assunto.
    5. Selecione código HTML em Tipo de corpo de e-mail e insira $MSTeamsTriggerData{"body.content"}$
      A chave body.content dos dados de resposta do gatilho contém o conteúdo da mensagem de chat como seu valor.
      Para mais informações sobre os dados de resposta do gatilho, consulte Logs de auditoria do gatilho do Microsoft Teams.
  6. Clique em Salvar para salvar o bot de tarefas.
Ao clicar em Executar > Executar com gatilhos, o sistema ativa o gatilho e ele começa a monitorar o evento Quando uma nova mensagem de chat é adicionada no canal Geral da equipe de Suporte técnico. O gatilho inicia as ações subsequentes do Microsoft 365 Outlook quando qualquer usuário publica uma mensagem que contém a palavra-chave Crítico, seja no assunto ou no corpo, no canal Geral da equipe de Suporte técnico.