Dokumentáció
Microsoft Teams értesítések és jelentések
Hozzon létre Workflows webhookot egy Teams-csatornában, adja hozzá az AutoPSEO-hoz, és kapjon riasztásokat és ütemezett jelentéseket a súlyosság szerint színezett Adaptive Card kártyákként.
Az AutoPSEO egy Workflows webhookon keresztül küld üzeneteket a Microsoft Teamsbe. A Teams egy URL-t ad, amely egyetlen csatornába posztol, ezt az URL-t pedig Teams-csatornaként adja hozzá az AutoPSEO-hoz. A riasztások, az ütemezett jelentések, a tesztüzenetek és az egyszeri jelentésösszegzések ezután Adaptive Card kártyákként érkeznek meg: a cím a súlyosság szerint színezett, és egy gomb vezet vissza a jelentéshez. Nincs szükség Slack-munkaterületre, és a Teamsbe nem kell AutoPSEO-alkalmazást telepíteni.
Webhook URL beszerzése a Teamsből
A Microsoft bejövő webhookokról szóló útmutatója a Workflows alkalmazással építi fel az URL-t:
- A Teamsben nyissa meg azt a csatornát, amelynek a kártyákat kell fogadnia, és válassza a mellette lévő További beállítások (...) lehetőséget.
- Válassza a Workflows elemet, majd válasszon egy webhooksablont. A Microsoft jelenleg Send webhook alerts to a channel néven hivatkozik rá; az AutoPSEO beállítási oldalán megjelenő súgó még a régebbi nevet használja: Post to a channel when a webhook request is received.
- Ellenőrizze a sablon által kitöltött csapatot és csatornát, majd kattintson a Mentés gombra.
- Másolja ki a munkafolyamat által megjelenített webhookhivatkozást.
A régebbi Incoming Webhook összekötő URL-je (a webhook.office.com címen) továbbra is elfogadott. A Microsoft megszünteti a Microsoft 365 összekötőket, és letiltja az újak létrehozását, ezért most mindenképp a Workflowst használja.
A csatorna hozzáadása az AutoPSEO-ban
- A Slack, Teams & Webhooks oldal Microsoft Teams szakaszában kattintson az Új Teams-csatorna gombra. Az űrlap a Microsoft Teams célhellyel nyílik meg.
- Adjon meg egy könnyen felismerhető Nevet, és illessze be az URL-t. Teams-bejegyzéshez az AutoPSEO a Workflows- és összekötőcímeket fogadja el (például a
logic.azure.com,powerautomate.com,azure-api.netéswebhook.office.comhosztokat), más hosztokat elutasít. - Kattintson a Csatorna hozzáadása gombra, majd a sorában a Teszt küldése gombra. A csatornában meg kell jelennie egy kártyának, amelynek a címe a bejegyzés neve.
- Hozzon létre egy ütemezett jelentést vagy egy riasztást, és válassza ezt a csatornát.
Egy szabály egy csatornára küld. Ha ugyanazt a riasztást Slackben és Teamsben is meg szeretné kapni, hozza létre a szabályt kétszer, mindkét helyre egyet-egyet.
A kártya felépítése
Minden üzenet egyetlen Adaptive Card kártya (1.4-es verzió, teljes szélesség), amely a message burkolóba van csomagolva egy application/vnd.microsoft.card.adaptive mellékletként, ahogyan a Microsoft saját példái is teszik.
- Cím nagy, félkövér betűkkel. A riasztások esetén a kritikus és a magas súlyosság a kártya Attention színét, a közepes a Warning színt, az alacsony pedig az alapértelmezett színt kapja; a jelentések és a tesztek az Accent színt használják.
- Összefoglaló: ugyanaz a mondat, amelyet a Slack-üzenet is tartalmaz, a dátumablakkal együtt.
- Adatok: legfeljebb 12 címkézett érték, például a kattintások és azok változása, vagy egy riasztás aktuális értéke az alapértékhez képest.
- Táblázat: jelentésekhez és jelentésösszegzésekhez, legfeljebb tíz sor, fix szélességű betűtípussal.
- Lábléc: a tulajdon, egy emlékeztető arról, hogy a Search Console adatai nagyjából egy napot késnek, és csak a lezárult napokat számítjuk, valamint a feladó.
- Jelentés megnyitása: egy gomb az AutoPSEO megfelelő jelentéséhez.
Miért nem érkezett meg a kártya
A Teszt küldése azonnal jelzi a hibát; az ütemezett üzeneteknél az Kézbesítési előzmények megőrzik a Teams válaszát.
| Amit lát | Valószínű ok | Megoldás |
|---|---|---|
| „That does not look like a Teams Workflows or Incoming Webhook URL” mentéskor | Az URL nem Workflows- vagy összekötő-hoszton van | Másolja ki újra a hivatkozást a munkafolyamatból |
| HTTP 400 a Teszt küldése után | Mégsem Teams-webhook: Slack URL, Zapier-hook vagy olyan munkafolyamat, amelyet másik törzsformátumra szerkesztettek át | Hozzon létre új munkafolyamatot a sablonból, és adja hozzá annak URL-jét |
| Időtúllépés 10 másodperc után | A Teams nem válaszolt időben | Próbálja újra később |
| Az átirányításokat nem követi | Az URL máshová továbbít | Adja hozzá inkább a végső URL-t |
| A kártyák leálltak, miután egy munkatárs távozott | A Microsoft minden munkafolyamatot a tulajdonosaihoz köt, és a tulajdonos nélküli munkafolyamat leállhat | Adjon társtulajdonosokat a munkafolyamathoz, vagy hozza létre újra |
Az sikertelen ütemezett jelentést az adott időszakban nem küldi el újra a rendszer: hárítsa el az okot, és használja a Küldés most gombot.
Mikor érdemes inkább webhookot használni
A Teams és a kimenő webhookok ugyanazokat a szabályokat szolgálhatják ki, de más olvasóknak szólnak. A Teams-csatorna embereknek készült: formázott kártya, amelyhez nem kell semmit építeni. A webhook szoftvereknek való: a nyers esemény aláírt JSON-ként a Zapier, a Make, az n8n vagy a saját szolgáltatása számára. A Teams kártyát vár, nem az AutoPSEO esemény-JSON-ját, ezért a Teams URL mindig a Microsoft Teams alá tartozik.
A Teams-felhasználók számára elérhető lehetőségek áttekintése a Microsoft Teams oldalon található.