Exemplo de utilização do package Microsoft Teams

Neste exemplo, você criará uma automação para enviar um alerta de incidente P1 para um canal específico do Microsoft Teams, notificar diretamente o engenheiro de suporte de plantão por chat e registrar a conversa do canal para registros de incidentes.

Procedimento

  1. Crie uma automação.
    1. No painel do lado esquerdo, clique em Automação.

      Uma lista de formulários e bots disponíveis é exibida.

    2. Clique em Criar um bot.
    3. Digite o nome do bot: MSTeams_demo.
    4. Clique em Criar e editar.
  2. Conecte-se ao Microsoft Teams para estabelecer uma sessão para autenticar e executar todas as ações subsequentes do Teams.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Conectar.
    2. No campo OAuth2 Connection, digite MSTeam.
    3. No campo Nome de usuário, insira office365_dev@automationanywhere.store
    4. Selecione a Sessão local Padrão.
  3. Recupera o ID da equipe específica.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Obter equipe pelo nome.
    2. No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
    3. No campo Nome da equipe, insira Operações de suporte.
      Nota: A equipe Operações de suporte deve existir no aplicativo Microsoft Teams.
    4. No campo Atribuir ID da equipe à variável, insira $TeamID$
  4. Recupere o ID de canal exclusivo de um canal específico na equipe Operações de suporte.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Obter canal por nome.
    2. No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
    3. No campo ID da equipe, insira $TeamID$.
    4. No campo Nome do canal, insira Gerenciamento de incidentes.
      Nota: Esse canal deve existir no aplicativo Microsoft Teams.
    5. No campo Atribuir ID do canal à variável, crie uma nova variável chamada $ChannelID$.
  5. Publique o alerta no canal Gerenciamento de incidentes.
    Nota: A suposição aqui é que o aplicativo externo está acionando essa automação para enviar a mensagem de alerta para o canal Gerenciamento de Incidentes.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Enviar mensagem do canal.
    2. No campo ID da equipe, digite $TeamID$
    3. No campo ID do canal, digite $ChannelID$
    4. No campo Mensagem, insira a seguinte mensagem:

      ID do incidente: INC-2025-08-13-045

      Severidade: P1: essenciais para os negócios

      Detectado em: 13-ago-2025 14:48 IST

      Descrição: A API de processamento de pedidos está retornando erros 500. Todos os novos pedidos estão com falha no processamento.

      Impacto: clientes de comércio eletrônico incapazes de concluir transações.

      Próximas etapas: o engenheiro de plantão deve investigar imediatamente os registros da API e a integridade do banco de dados.

    5. No campo Atribuir ID da mensagem à variável, crie uma nova variável chamada $MessageId$ para armazenar o ID da mensagem de alerta.
  6. Recupere os detalhes do usuário Engenheiro de suporte.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Obter detalhes do usuário.
    2. No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
    3. No campo Nome de usuário, crie uma nova variável para armazenar o endereço de e-mail do usuário para recuperar seus detalhes. Variável criada: $email$ (por exemplo, tony.dean@office.store)
    4. No campo Atribuir detalhes do usuário à variável, selecione a opção Dicionário. Digite $user_dict$ para armazenar os detalhes do usuário.
  7. Notifique o Engenheiro via chat direto.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Enviar mensagem de chat.
    2. No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
    3. No campo Enviar mensagem para > E-mail, especifique $user_dict{email}$
    4. No campo Mensagem, insira a seguinte mensagem:

      Oi, $user_dict{displayName}$,

      Um incidente crítico P1 foi detectado: falha na API de processamento de pedidos. ID do incidente: INC-2025-08-13-045 Detectado: 13-ago-2025 14:48 IST Impacto: todos os novos pedidos estão falhando.

      Entre imediatamente na Ponte de incidentes: Link para a reunião do Teams: Link do ServiceNow

      Alerta automatizado do Bot do A360 MS Teams.

    5. No campo Atribuir o ID da mensagem à variável, crie uma nova variável chamada $user_msgid$.
  8. Confirme que a mensagem foi enviada para o engenheiro.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Caixa de mensagem.
    2. No campo Inserir a mensagem a ser exibida, insira Mensagem enviada para o engenheiro de suporte.
  9. Recupere e registre o histórico de chat do canal.
    1. Clique duas vezes ou arraste a action Loop.
    2. No campo suspenso do iterador Loop, selecione o iterador Microsoft Teams > Para cada mensagem em um canal.
    3. No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
    4. No campo ID da equipe, digite $TeamID$
    5. No campo ID do canal, digite $ChannelID$
    6. No campo Data de início, crie uma nova variável chamada $start_dt$ com o valor 13/08/2025 15:00 IST (UTC+5.30) Calcutá, Ásia
    7. No campo Data de término, crie uma nova variável chamada $end_dt$ com o valor 14/08/2025 00:00 IST (UTC+5.30) Calcutá, Ásia
    8. No campo Atribuir detalhes da mensagem à variável, crie uma variável chamada $ChannelMessageDetails$ para armazenar as mensagens do canal.
  10. Extraia detalhes da mensagem dentro da ação Loop.
    Nota: Apenas mensagens em grupo são recuperadas, e não conversas individuais.

    Clique duas vezes ou arraste a action Dicionário > Obter para cada chave para recuperar seu valor de $ChannelMessageDetails$:
    Chave Variável
    $ChannelMessageDetails (msg_id)$ $msg_id$
    $ChannelMessageDetails (msg)$ $msg$
    $ChannelMessageDetails (sentByUserID)$ $sentByUserID$
    $ChannelMessageDetails (sentByUsername)$ $sentByUsername$
    $ChannelMessageDetails (createdDateTime)$ $createdDateTime$
    $ChannelMessageDetails (modifiedDateTime)$ $modifiedDateTime$
  11. Registre os detalhes da mensagem do canal no arquivo de log de incidentes dentro da ação de loop.
    • Clique duas vezes ou arraste as variáveis da action Registro > Registrar variáveis no arquivo.
    • No campo Caminho do arquivo de saída, digite C:\output\Incident Log File.txt
    • Na opção Ao registrar em log, selecione Acrescentar ao arquivo de log existente.
    • Selecione a opção Seleção personalizada para identificar as variáveis a serem registradas. Selecione a seguinte variável:
      • $createdDateTime$
      • $modifiedDateTime$
      • $msg$
      • $msg_id$
      • $sentByUserID$
      • $sentByUserName$
  12. Desconectar do Microsoft Teams.
    1. Clique duas vezes ou arraste a action Microsoft Teams > Desconectar.
    2. No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
  13. Use a action Arquivo > Abrir para abrir o arquivo de log de incidentes. As informações abaixo serão exibidas no arquivo .txt.
    Chave Valor
    msg_id por exemplo, 1692210012345
    mensagem

    Alerta de incidente crítico: ação necessária

    ID do incidente: INC-2025-08-13-045

    Severidade: P1: essenciais para os negócios

    Detectado em: 13-ago-2025 14:48 IST

    Descrição: A API de processamento de pedidos está retornando erros 500. Todos os novos pedidos estão com

    falha no processamento.

    Impacto: clientes de comércio eletrônico incapazes de concluir transações.

    Próximas etapas: o engenheiro de plantão deve investigar os registros da API e a integridade do banco de dados

    imediatamente.

    sentbyuserid por exemplo, a-user-guid
    createddatetime 13-08-2025T14:50:12Z
    modifieddatetime 13-08-2025T14:50:12Z
    sentbyusername por exemplo, tony.dean@office.store