Dokumentace
Upozornění a reporty v Microsoft Teams
Vytvořte ve kanálu Teams webhook přes Workflows, přidejte ho do AutoPSEO a dostávejte upozornění a plánované reporty jako Adaptive Cards obarvené podle závažnosti.
AutoPSEO odesílá zprávy do Microsoft Teams přes webhook z Workflows. Teams vám dá URL, které publikuje do jednoho kanálu, a vy ji v AutoPSEO přidáte jako kanál Teams. Upozornění, plánované reporty, testovací zprávy i souhrny jednorázových reportů pak chodí jako Adaptive Cards s nadpisem obarveným podle závažnosti a tlačítkem, které vede zpět do reportu. Nepotřebujete workspace ve Slack a v Teams se neinstaluje žádná aplikace AutoPSEO.
Získání URL webhooku z Teams
Microsoft v návodu k příchozím webhookům vytváří URL pomocí aplikace Workflows:
- V Teams otevřete kanál, který má karty přijímat, a vedle něj zvolte Další možnosti (...).
- Zvolte Workflows a vyberte šablonu webhooku. Microsoft ji aktuálně nazývá Send webhook alerts to a channel; nápověda AutoPSEO na stránce nastavení stále používá starší název Post to a channel when a webhook request is received.
- Zkontrolujte tým a kanál, které šablona předvyplnila, a klikněte na Uložit.
- Zkopírujte odkaz na webhook, který vám workflow zobrazí.
URL ze staršího konektoru Incoming Webhook (na webhook.office.com) se stále přijímá. Microsoft konektory Microsoft 365 ruší a nové už blokuje, proto pro cokoli, co nastavujete nově, používejte Workflows.
Přidání kanálu v AutoPSEO
- V sekci Microsoft Teams na stránce Slack, Teams & Webhooks klikněte na New Teams channel. Formulář se otevře s cílem Microsoft Teams.
- Zadejte Name, podle kterého kanál poznáte, a vložte URL. Pro položku Teams AutoPSEO přijímá adresy Workflows a konektorů (hostitele jako
logic.azure.com,powerautomate.com,azure-api.netawebhook.office.com) a ostatní hostitele odmítne. - Klikněte na Add channel a poté na Send test na jeho řádku. V kanálu by se měla objevit karta s názvem této položky.
- Vytvořte plánovaný report nebo upozornění a vyberte tento kanál.
Pravidlo odesílá do jednoho kanálu. Chcete-li mít stejné upozornění ve Slack i v Teams, vytvořte pravidlo dvakrát, pro každý kanál zvlášť.
Jak karta vypadá
Každá zpráva se stane jednou kartou Adaptive Card (verze 1.4, plná šířka), zabalenou do obálky message s přílohou application/vnd.microsoft.card.adaptive, jaká se používá v ukázkách od Microsoftu.
- Nadpis velkým tučným písmem. U upozornění má nadpis barvu karty Attention pro kritická a vysoká upozornění, Warning pro střední a výchozí barvu pro nízká; reporty a testy používají barvu Accent.
- Shrnutí: stejná věta, jakou obsahuje zpráva ve Slack, včetně časového období.
- Fakta: až 12 popsaných hodnot, například kliknutí a jejich změna, nebo aktuální hodnota upozornění oproti základní hodnotě.
- Tabulka: u reportů a souhrnů reportů až deset řádků neproporcionálním písmem.
- Zápatí: web, upozornění, že data ze Search Console se zpožďují zhruba o den a započítávají se jen ustálené dny, a odesílatel.
- Open report: tlačítko vedoucí na příslušný report v AutoPSEO.
Proč karta nedorazila
Send test ohlásí selhání okamžitě; u plánovaných zpráv uchovává odpověď z Teams Delivery history.
| Co vidíte | Pravděpodobná příčina | Řešení |
|---|---|---|
| Při ukládání se zobrazí „That does not look like a Teams Workflows or Incoming Webhook URL" | URL nepatří hostiteli Workflows ani konektoru | Zkopírujte odkaz z workflow znovu |
| HTTP 400 při Send test | Nejde o webhook Teams: je to URL Slack, hook Zapier nebo workflow upravený tak, aby očekával jiné tělo požadavku | Vytvořte ze šablony nové workflow a přidejte jeho URL |
| Vypršel časový limit 10 sekund | Teams neodpověděl včas | Zkuste to znovu později |
| Přesměrování se nenásledují | URL přesměrovává jinam | Přidejte koncovou URL |
| Karty přestaly chodit po odchodu kolegy | Microsoft váže každé workflow na jeho vlastníky a workflow bez vlastníka se může zastavit | Přidejte k workflow další vlastníky nebo ho vytvořte znovu |
Neúspěšný plánovaný report se ve stejném období neodesílá znovu: odstraňte příčinu a použijte Send now.
Kdy raději použít webhook
Teams a odchozí webhooky mohou nést stejná pravidla, ale slouží různým příjemcům. Kanál Teams je pro lidi: naformátovaná karta a nic, co by bylo třeba programovat. Webhook je pro software: surová událost jako podepsaný JSON pro Zapier, Make, n8n nebo vaši vlastní službu. Teams očekává kartu, nikoli událostní JSON z AutoPSEO, takže URL Teams patří vždy do sekce Microsoft Teams.
Přehled toho, co Teams uživatelé získají, najdete na stránce Microsoft Teams.