Exemplo de utilização do package Microsoft Teams
- Última atualização2025/09/30
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
- Crie uma automação.
- No painel do lado esquerdo, clique em Automação.
Uma lista de formulários e bots disponíveis é exibida.
- Clique em Criar um bot.
- Digite o nome do bot: MSTeams_demo.
- Clique em Criar e editar.
- No painel do lado esquerdo, clique em Automação.
- Conecte-se ao Microsoft Teams para estabelecer uma sessão para autenticar e executar todas as ações subsequentes do Teams.
- Clique duas vezes ou arraste a action .
- No campo OAuth2 Connection, digite MSTeam.
- No campo Nome de usuário, insira office365_dev@automationanywhere.store
- Selecione a Sessão local Padrão.
- Recupera o ID da equipe específica.
- Clique duas vezes ou arraste a action .
- No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- No campo Nome da equipe, insira Operações de suporte.Nota: A equipe Operações de suporte deve existir no aplicativo Microsoft Teams.
- No campo Atribuir ID da equipe à variável, insira $TeamID$
- Recupere o ID de canal exclusivo de um canal específico na equipe Operações de suporte.
- Clique duas vezes ou arraste a action .
- No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- No campo ID da equipe, insira $TeamID$.
- No campo Nome do canal, insira Gerenciamento de incidentes.Nota: Esse canal deve existir no aplicativo Microsoft Teams.
- No campo Atribuir ID do canal à variável, crie uma nova variável chamada $ChannelID$.
- 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.
- Clique duas vezes ou arraste a action .
- No campo ID da equipe, digite $TeamID$
- No campo ID do canal, digite $ChannelID$
- 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.
- No campo Atribuir ID da mensagem à variável, crie uma nova variável chamada $MessageId$ para armazenar o ID da mensagem de alerta.
- Recupere os detalhes do usuário Engenheiro de suporte.
- Clique duas vezes ou arraste a action .
- No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- 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)
- 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.
- Notifique o Engenheiro via chat direto.
- Clique duas vezes ou arraste a action .
- No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- No campo , especifique $user_dict{email}$
- 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.
- No campo Atribuir o ID da mensagem à variável, crie uma nova variável chamada $user_msgid$.
- Confirme que a mensagem foi enviada para o engenheiro.
- Clique duas vezes ou arraste a action .
- No campo Inserir a mensagem a ser exibida, insira Mensagem enviada para o engenheiro de suporte.
- Recupere e registre o histórico de chat do canal.
- Clique duas vezes ou arraste a action Loop.
- No campo suspenso do iterador Loop, selecione o iterador .
- No campo Nome da sessão, use a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- No campo ID da equipe, digite $TeamID$
- No campo ID do canal, digite $ChannelID$
- 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
- 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
- No campo Atribuir detalhes da mensagem à variável, crie uma variável chamada $ChannelMessageDetails$ para armazenar as mensagens do canal.
- 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 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$ - 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 .
- 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$
- Desconectar do Microsoft Teams.
- Clique duas vezes ou arraste a action .
- No campo Nome da sessão, selecione a mesma sessão que você usou para se conectar ao Microsoft Teams, ou seja, Padrão.
- Use a action
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