Documentação
Alertas e relatórios no Microsoft Teams
Crie um webhook do Workflows em um canal do Teams, adicione-o ao AutoPSEO e receba alertas e relatórios agendados como Adaptive Cards coloridos conforme a gravidade.
O AutoPSEO publica no Microsoft Teams por meio de um webhook do Workflows. O Teams fornece uma URL que publica em um único canal, e você adiciona essa URL ao AutoPSEO como um canal do Teams. Alertas, relatórios agendados, mensagens de teste e resumos avulsos de relatórios chegam então como Adaptive Cards, com o título colorido conforme a gravidade e um botão que leva de volta ao relatório. Você não precisa de um workspace do Slack, e não há nenhum app do AutoPSEO para instalar no Teams.
Obtenha uma URL de webhook no Teams
O guia de webhook de entrada da Microsoft cria a URL com o app Workflows:
- No Teams, acesse o canal que deve receber os cards e escolha Mais opções (...) ao lado dele.
- Escolha Workflows e selecione um modelo de webhook. Atualmente a Microsoft o chama de Enviar alertas de webhook para um canal; a dica do AutoPSEO na página de configurações ainda usa o nome antigo, Postar em um canal quando uma solicitação de webhook for recebida.
- Confira a equipe e o canal que o modelo preencheu e clique em Salvar.
- Copie o link do webhook exibido pelo workflow.
Uma URL do antigo conector Incoming Webhook (em webhook.office.com) ainda é aceita. A Microsoft está descontinuando os Microsoft 365 Connectors e vai bloquear a criação de novos, portanto use o Workflows em tudo o que configurar agora.
Adicione o canal no AutoPSEO
- Na seção Microsoft Teams de Slack, Teams & Webhooks, clique em Novo canal do Teams. O formulário abre com o Microsoft Teams como destino.
- Informe um Nome que você reconheça e cole a URL. Para uma entrada do Teams, o AutoPSEO aceita endereços do Workflows e de conectores (hosts como
logic.azure.com,powerautomate.com,azure-api.netewebhook.office.com) e recusa os demais hosts. - Clique em Adicionar canal e, em seguida, em Enviar teste na linha dele. Um card com o nome da entrada como título deve aparecer no canal.
- Crie um relatório agendado ou um alerta e escolha este canal.
Uma regra envia para um único canal. Para ter o mesmo alerta no Slack e no Teams, crie a regra duas vezes, uma para cada destino.
Como o card é organizado
Cada mensagem se torna um Adaptive Card (versão 1.4, largura total), envolvido no envelope message com um anexo application/vnd.microsoft.card.adaptive, como nos próprios exemplos da Microsoft.
- Título em fonte grande e em negrito. Nos alertas, o card usa a cor Attention para críticos e altos, Warning para médios e a cor padrão para baixos; relatórios e testes usam a cor Accent.
- Resumo: a mesma frase que uma mensagem do Slack traz, com o período de datas.
- Fatos: até 12 valores rotulados, como cliques e sua variação, ou o valor atual de um alerta em comparação com a linha de base.
- Tabela: para relatórios e resumos de relatórios, até dez linhas em fonte de largura fixa.
- Rodapé: a propriedade, um lembrete de que os dados do Search Console têm um atraso de cerca de um dia e de que apenas os dias já consolidados são contados, e o remetente.
- Abrir relatório: um botão para o relatório correspondente no AutoPSEO.
Por que um card não chegou
O Enviar teste informa uma falha imediatamente; no caso das mensagens agendadas, o Histórico de entregas guarda a resposta dada pelo Teams.
| O que você vê | Causa provável | Solução |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" ao salvar | A URL não pertence a um host do Workflows ou de conector | Copie o link novamente a partir do workflow |
| HTTP 400 em Enviar teste | Na verdade, não é um webhook do Teams: uma URL do Slack, um hook do Zapier ou um workflow editado para esperar um corpo diferente | Crie um workflow novo a partir do modelo e adicione a URL dele |
| Tempo esgotado após 10 segundos | O Teams não respondeu a tempo | Tente novamente mais tarde |
| Os redirecionamentos não são seguidos | A URL encaminha para outro endereço | Adicione a URL final |
| Os cards pararam depois que um colega saiu | A Microsoft vincula cada workflow às pessoas que são proprietárias dele, e um workflow sem proprietário pode parar | Adicione coproprietários ao workflow ou recrie-o |
Um relatório agendado que falhou não é reenviado no mesmo período: corrija a causa e use Enviar agora.
Quando usar um webhook em vez disso
O Teams e os webhooks de saída podem transportar as mesmas regras, mas atendem leitores diferentes. Um canal do Teams é para pessoas: um card formatado e nada para construir. Um webhook é para software: o evento bruto como JSON assinado para Zapier, Make, n8n ou o seu próprio serviço. O Teams espera um card, e não o JSON de evento do AutoPSEO, por isso uma URL do Teams sempre pertence à seção Microsoft Teams.
Uma visão geral do que os usuários do Teams recebem está na página do Microsoft Teams.