Dokumentasyon
Mga alerto at ulat sa Microsoft Teams
Gumawa ng Workflows webhook sa isang Teams channel, idagdag ito sa AutoPSEO, at tumanggap ng mga alerto at naka-iskedyul na ulat bilang Adaptive Cards na may kulay ayon sa tindi ng severity.
Nagpo-post ang AutoPSEO sa Microsoft Teams sa pamamagitan ng Workflows webhook. Magbibigay ang Teams ng URL na nagpo-post sa isang channel, at idaragdag mo ang URL na iyon sa AutoPSEO bilang Teams channel. Darating na bilang Adaptive Cards ang mga alerto, naka-iskedyul na ulat, test message at buod ng isahang ulat, na may titulong may kulay ayon sa severity at button pabalik sa ulat. Hindi mo kailangan ng Slack workspace, at walang AutoPSEO app na ii-install sa Teams.
Kumuha ng webhook URL mula sa Teams
Binubuo ng gabay ng Microsoft sa incoming webhook ang URL gamit ang Workflows app:
- Sa Teams, pumunta sa channel na tatanggap ng mga card at piliin ang More options (...) sa tabi nito.
- Piliin ang Workflows at pumili ng webhook template. Sa kasalukuyan, tinatawag ito ng Microsoft na Send webhook alerts to a channel; ang hint ng AutoPSEO sa pahina ng settings ay gumagamit pa ng mas lumang pangalan, Post to a channel when a webhook request is received.
- Tingnan kung tama ang team at channel na inilagay ng template, pagkatapos ay i-click ang Save.
- Kopyahin ang webhook link na ipinapakita ng workflow.
Tinatanggap pa rin ang URL mula sa lumang Incoming Webhook connector (sa webhook.office.com). Ihihinto na ng Microsoft ang Microsoft 365 Connectors at haharangin ang mga bago, kaya gamitin ang Workflows para sa anumang ise-set up mo ngayon.
Idagdag ang channel sa AutoPSEO
- Sa seksyong Microsoft Teams ng Slack, Teams & Webhooks, i-click ang New Teams channel. Magbubukas ang form na may Microsoft Teams bilang destinasyon.
- Maglagay ng Name na madali mong makikilala at i-paste ang URL. Para sa Teams entry, tumatanggap ang AutoPSEO ng mga address ng Workflows at connector (mga host gaya ng
logic.azure.com,powerautomate.com,azure-api.netatwebhook.office.com) at tumatanggi sa iba pang host. - I-click ang Add channel, pagkatapos ay Send test sa row nito. Dapat lumabas sa channel ang isang card na ang titulo ay ang pangalan ng entry.
- Gumawa ng naka-iskedyul na ulat o alerto at piliin ang channel na ito.
Isang channel lang ang pinapadalhan ng bawat rule. Kung gusto mong makatanggap ng iisang alerto sa Slack at sa Teams, gawin ang rule nang dalawang beses, isa para sa bawat isa.
Ayos ng card
Nagiging isang Adaptive Card (bersyon 1.4, buong lapad) ang bawat mensahe, na nakabalot sa message envelope na may application/vnd.microsoft.card.adaptive attachment na ginagamit din sa mga halimbawa ng Microsoft.
- Titulo sa malaki at bold na letra. Sa mga alerto, ang kulay na Attention ng card ang ginagamit para sa critical at high, Warning para sa medium, at ang default na kulay para sa low; ang mga ulat at test ay gumagamit ng kulay na Accent.
- Buod: ang parehong pangungusap na dala ng mensahe sa Slack, kasama ang saklaw ng petsa.
- Facts: hanggang 12 may-label na value, gaya ng mga click at ang pagbabago nito, o ang kasalukuyang value ng alerto kumpara sa baseline nito.
- Table: para sa mga ulat at buod ng ulat, hanggang sampung row sa fixed-width na font.
- Footer: ang property, paalala na may pagkaantala nang mga isang araw ang data ng Search Console at mga naayos na araw lang ang binibilang, at ang nagpadala.
- Open report: button papunta sa katugmang ulat sa AutoPSEO.
Bakit hindi dumating ang card
Agad na iuulat ng Send test ang pagkabigo; para sa mga naka-iskedyul na mensahe, itinatago ng Delivery history ang sagot na ibinigay ng Teams.
| Ang nakikita mo | Posibleng dahilan | Solusyon |
|---|---|---|
| "That does not look like a Teams Workflows or Incoming Webhook URL" sa pag-save | Wala sa host ng Workflows o connector ang URL | Kopyahing muli ang link mula sa workflow |
| HTTP 400 sa Send test | Hindi pala ito Teams webhook: Slack URL, Zapier hook, o workflow na binago para umasa ng ibang body | Gumawa ng bagong workflow mula sa template at idagdag ang URL nito |
| Nag-time out pagkalipas ng 10 segundo | Hindi sumagot ang Teams sa tamang oras | Subukang muli mamaya |
| Hindi sinusundan ang mga redirect | Nagpapasa ang URL sa ibang lugar | Idagdag na lang ang pinal na URL |
| Tumigil ang mga card matapos umalis ang isang kasamahan | Iniuugnay ng Microsoft ang bawat workflow sa mga taong may-ari nito, at maaaring huminto ang workflow na walang may-ari | Magdagdag ng mga co-owner sa workflow, o gumawa ng bago |
Hindi na muling ipinapadala ang isang bigong naka-iskedyul na ulat sa parehong period: ayusin ang sanhi at gamitin ang Send now.
Kailan gagamit ng webhook sa halip
Maaaring magdala ng parehong mga rule ang Teams at ang mga outbound webhook, pero magkaiba ang mambabasa nila. Ang Teams channel ay para sa mga tao: isang naka-format na card at walang kailangang buuin. Ang webhook ay para sa software: ang hilaw na event bilang signed JSON para sa Zapier, Make, n8n o sarili mong serbisyo. Card ang inaasahan ng Teams, hindi ang event JSON ng AutoPSEO, kaya laging nasa ilalim ng Microsoft Teams ang Teams URL.
May pangkalahatang-ideya kung ano ang makukuha ng mga gumagamit ng Teams sa pahina ng Microsoft Teams.