Dokumentation
Microsoft Teams-aviseringar och rapporter
Skapa en Workflows-webhook i en Teams-kanal, lägg till den i AutoPSEO och ta emot aviseringar och schemalagda rapporter som Adaptive Cards, färgade efter allvarlighetsgrad.
AutoPSEO skickar meddelanden till Microsoft Teams via en Workflows-webhook. Teams ger dig en URL som publicerar i en enskild kanal, och du lägger till den URL:en i AutoPSEO som en Teams-kanal. Aviseringar, schemalagda rapporter, testmeddelanden och sammanfattningar av enstaka rapporter kommer sedan som Adaptive Cards, med rubriken färgad efter allvarlighetsgrad och en knapp som leder tillbaka till rapporten. Du behöver ingen Slack-arbetsyta, och det finns ingen AutoPSEO-app att installera i Teams.
Hämta en webhook-URL från Teams
Microsofts guide för inkommande webhooks bygger URL:en med appen Workflows:
- Gå i Teams till kanalen som ska ta emot korten och välj Fler alternativ (...) bredvid den.
- Välj Workflows och välj en webhook-mall. Microsoft kallar den för närvarande Send webhook alerts to a channel. AutoPSEO:s tips på inställningssidan använder fortfarande det äldre namnet, Post to a channel when a webhook request is received.
- Kontrollera vilket team och vilken kanal som mallen har fyllt i och klicka sedan på Spara.
- Kopiera webhook-länken som arbetsflödet visar.
En URL från den äldre Incoming Webhook-kopplingen (på webhook.office.com) accepteras fortfarande. Microsoft håller på att avveckla Microsoft 365 Connectors och kommer att blockera nya, så använd Workflows för allt du sätter upp nu.
Lägg till kanalen i AutoPSEO
- Klicka på Ny Teams-kanal i avsnittet Microsoft Teams under Slack, Teams & Webhooks. Formuläret öppnas med Microsoft Teams som mål.
- Ange ett Namn som du känner igen och klistra in URL:en. För en Teams-post accepterar AutoPSEO adresser till Workflows och kopplingar (värdar som
logic.azure.com,powerautomate.com,azure-api.netochwebhook.office.com) och avvisar andra värdar. - Klicka på Lägg till kanal och sedan på Skicka test på kanalens rad. Ett kort med postens namn som rubrik bör dyka upp i kanalen.
- Skapa en schemalagd rapport eller en avisering och välj den här kanalen.
En regel skickar till en kanal. Om du vill ha samma avisering i både Slack och Teams skapar du regeln två gånger, en för varje.
Så är kortet uppbyggt
Varje meddelande blir ett Adaptive Card (version 1.4, full bredd), inpackat i message-kuvertet med en bilaga av typen application/vnd.microsoft.card.adaptive, som Microsofts egna exempel använder.
- Rubrik i stor, fet stil. Aviseringar får kortets färg Attention för kritiska och höga, Warning för medelhöga och standardfärgen för låga. Rapporter och tester använder färgen Accent.
- Sammanfattning: samma mening som ett Slack-meddelande innehåller, med datumintervallet.
- Nyckeltal: upp till 12 märkta värden, till exempel klick och deras förändring, eller en aviserings aktuella värde jämfört med baslinjen.
- Tabell: för rapporter och rapportsammanfattningar, upp till tio rader i teckensnitt med fast breddsteg.
- Sidfot: webbplatsen, en påminnelse om att data från Search Console släpar ungefär ett dygn och att bara avslutade dagar räknas, samt avsändaren.
- Öppna rapport: en knapp till motsvarande rapport i AutoPSEO.
Varför ett kort inte kom fram
Skicka test rapporterar ett fel direkt. För schemalagda meddelanden sparar Leveranshistorik svaret som Teams gav.
| Vad du ser | Trolig orsak | Åtgärd |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" vid sparande | URL:en ligger inte på en värd för Workflows eller kopplingar | Kopiera länken från arbetsflödet igen |
| HTTP 400 vid Skicka test | Det är trots allt inte en Teams-webhook: en Slack-URL, en Zapier-hook eller ett arbetsflöde som ändrats så att det förväntar sig en annan body | Skapa ett nytt arbetsflöde från mallen och lägg till dess URL |
| Tidsgräns på 10 sekunder överskreds | Teams svarade inte i tid | Försök igen senare |
| Omdirigeringar följs inte | URL:en vidarebefordrar till någon annanstans | Lägg i stället till den slutliga URL:en |
| Korten slutade komma efter att en kollega slutat | Microsoft knyter varje arbetsflöde till de personer som äger det, och ett arbetsflöde utan ägare kan sluta fungera | Lägg till medägare i arbetsflödet eller skapa det på nytt |
En misslyckad schemalagd rapport skickas inte om under samma period: åtgärda orsaken och använd Skicka nu.
När du bör använda en webhook i stället
Teams och utgående webhooks kan hantera samma regler, men de riktar sig till olika mottagare. En Teams-kanal är till för människor: ett formaterat kort och inget att bygga. En webhook är till för programvara: den råa händelsen som signerad JSON, för Zapier, Make, n8n eller din egen tjänst. Teams förväntar sig ett kort snarare än AutoPSEO:s händelse-JSON, så en Teams-URL hör alltid hemma under Microsoft Teams.
En översikt över vad Teams-användare får finns på sidan om Microsoft Teams.