Ligar o Microsoft Teams

O Mirox pode publicar as suas notificações diretamente num canal do Microsoft Teams — alarmes, atividade de tickets, relatórios —, para que toda a sua equipa as veja onde já trabalha. A ligação é um fluxo de trabalho de webhook de entrada padrão do Teams: o Teams fornece-lhe um URL, e regista esse URL como webhook nas suas definições de notificações do Mirox. Não é necessário nenhum plugin nem instalação de aplicação.

Antes de Começar

• Precisa de permissão no Microsoft Teams para adicionar fluxos de trabalho ao canal de destino (a maioria dos membros do canal tem-na; o seu administrador do Teams pode restringi-la).
• Decida que canal deve receber as notificações do Mirox — um canal dedicado como Mirox Alerts mantém-nas fáceis de acompanhar.

Passo 1 — Criar o Fluxo de Trabalho de Webhook no Teams

1. No Microsoft Teams, vá ao canal que deve receber as notificações.
2. Clique nos três pontos (⋯) junto ao nome do canal e escolha Fluxos de trabalho (Workflows).
3. Selecione o modelo «Publicar num canal quando é recebido um pedido de webhook» (em inglês: "Post to a channel when a webhook request is received").
4. Inicie sessão ou confirme a ligação se lhe for pedido, mantenha ou ajuste o nome do fluxo e clique em Seguinte.
5. Confirme a equipa e o canal e clique em Adicionar fluxo de trabalho.
6. O Teams mostra agora o URL do webhook. Copie-o e clique em Concluído.

Passo 2 — Adicionar o Webhook no Mirox

1. Abra o seu Perfil e selecione o separador Notificações.
2. No cartão Canais, em Webhooks, clique em Adicionar webhook.
3. Dê-lhe um nome reconhecível, por exemplo Teams — Operações.
4. Cole o URL do fluxo de trabalho do Teams.
5. Defina o formato como Microsoft Teams — assim o Mirox envia mensagens que o Teams consegue apresentar como cartões.
6. Guarde. O Mirox mostra o segredo de assinatura uma única vez — para uma ligação com o Teams pode simplesmente fechar; veja Sobre os Cabeçalhos de Assinatura abaixo.

Passo 3 — Enviar uma Mensagem de Teste

1. Na linha do novo webhook, clique em Testar.
2. Em poucos instantes, uma mensagem de teste do Mirox aparece no seu canal do Teams.

Se nada chegar, verifique se o URL foi copiado por completo e se o fluxo de trabalho está ativado no Teams, e teste novamente.

Encaminhar as Notificações para o Teams

Adicionar o webhook torna o canal disponível — agora certifique-se de que as notificações realmente o usam:

• Ative o interruptor principal Enviar notificações fora da aplicação no separador Notificações.
• Certifique-se de que o canal de webhook está ativado e selecionado para os grupos de notificação que lhe interessam no cartão O que me notifica (por predefinição, os grupos seguem a sua seleção global de canais).

A partir daí, as notificações correspondentes são publicadas no seu canal do Teams à medida que acontecem.

Sobre os Cabeçalhos de Assinatura

Cada pedido de webhook enviado pelo Mirox é assinado: transporta cabeçalhos de assinatura e de carimbo temporal calculados a partir do segredo de assinatura do webhook, para que um sistema recetor possa verificar que o pedido veio realmente do Mirox e não é uma repetição. O Microsoft Teams ignora estes cabeçalhos — o fluxo de trabalho aceita qualquer pedido bem formado que conheça o URL —, pelo que, para uma ligação com o Teams, nunca precisa do segredo. Ele importa quando aponta um webhook Generic JSON para o seu próprio sistema e quer autenticar os pedidos recebidos; pode reemiti-lo a qualquer momento com Rodar segredo.

Resolução de Problemas

Guias Relacionados

• Notificações — o guia completo das definições de notificações: canais, grupos, silenciamentos e horário de trabalho
• Tickets — a atividade de tickets que pode ser publicada no Teams