Documentație
Alerte și rapoarte în Microsoft Teams
Creați un webhook Workflows într-un canal Teams, adăugați-l în AutoPSEO și primiți alerte și rapoarte programate sub formă de Adaptive Cards colorate în funcție de severitate.
AutoPSEO publică mesaje în Microsoft Teams printr-un webhook Workflows. Teams vă oferă un URL care postează într-un singur canal, iar dumneavoastră adăugați acest URL în AutoPSEO caISSUE canal Teams. Alertele, rapoartele programate, mesajele de test și rezumatele punctuale ale rapoartelor ajung apoi sub formă de Adaptive Cards, cu titlul colorat în funcție de severitate și cu un buton care duce înapoi la raport. Nu aveți nevoie de un workspace Slack și nu trebuie instalată nicio aplicație AutoPSEO în Teams.
Obțineți un URL de webhook din Teams
Ghidul Microsoft pentru webhook-uri de intrare construiește URL-ul cu ajutorul aplicației Workflows:
- În Teams, deschideți canalul care trebuie să primească cardurile și alegeți Mai multe opțiuni (...) lângă el.
- Alegeți Workflows și selectați un șablon de webhook. În prezent, Microsoft îl numește Send webhook alerts to a channel; indicația AutoPSEO din pagina de setări folosește încă denumirea mai veche, Post to a channel when a webhook request is received.
- Verificați echipa și canalul completate de șablon, apoi faceți clic pe Salvați.
- Copiați linkul webhook afișat de workflow.
Un URL de la vechiul conector Incoming Webhook (pe webhook.office.com) este în continuare acceptat. Microsoft retrage Microsoft 365 Connectors și va bloca crearea unora noi, așa că pentru tot ce configurați acum folosiți Workflows.
Adăugați canalul în AutoPSEO
- În secțiunea Microsoft Teams din Slack, Teams & Webhooks, faceți clic pe Canal Teams nou. Formularul se deschide cu Microsoft Teams ca destinație.
- Introduceți un Nume pe care îl veți recunoaște și lipiți URL-ul. Pentru o intrare Teams, AutoPSEO acceptă adrese Workflows și de conector (gazde precum
logic.azure.com,powerautomate.com,azure-api.netșiwebhook.office.com) și le respinge pe celelalte. - Faceți clic pe Adăugați canalul, apoi pe Trimiteți test în rândul acestuia. În canal ar trebui să apară un card cu numele intrării ca titlu.
- Creați un raport programat sau o alertă și alegeți acest canal.
O regulă trimite către un singur canal. Dacă doriți aceeași alertă și în Slack, și în Teams, creați regula de două ori, câte una pentru fiecare.
Cum este structurat cardul
Fiecare mesaj devine un singur Adaptive Card (versiunea 1.4, lățime completă), încadrat în plicul message cu un atașament application/vnd.microsoft.card.adaptive, așa cum apare în exemplele Microsoft.
- Titlul este afișat cu caractere mari, aldine. În cazul alertelor, cardul folosește culoarea Attention pentru severitate critică și ridicată, Warning pentru medie și culoarea implicită pentru scăzută; rapoartele și testele folosesc culoarea Accent.
- Rezumatul: aceeași propoziție pe care o conține un mesaj Slack, cu intervalul de date.
- Fapte: până la 12 valori etichetate, de exemplu clicurile și variația lor sau, pentru o alertă, valoarea curentă față de valoarea de referință.
- Tabelul: pentru rapoarte și rezumate de raport, până la zece rânduri, într-un font cu lățime fixă.
- Subsolul: proprietatea, o notă care amintește că datele din Search Console au o întârziere de aproximativ o zi și că sunt luate în calcul doar zilele stabilizate, precum și expeditorul.
- Deschideți raportul: un buton către raportul corespunzător din AutoPSEO.
De ce nu a ajuns un card
Trimiteți test raportează imediat un eșec; pentru mesajele programate, Istoricul livrărilor păstrează răspunsul primit de la Teams.
| Ce vedeți | Cauză probabilă | Remediere |
|---|---|---|
| „That does not look like a Teams Workflows or Incoming Webhook URL” la salvare | URL-ul nu aparține unei gazde Workflows sau de conector | Copiați din nou linkul din workflow |
| HTTP 400 la Trimiteți test | De fapt, nu este un webhook Teams: un URL Slack, un hook Zapier sau un workflow modificat să aștepte un alt corp de cerere | Creați un workflow nou pornind de la șablon și adăugați URL-ul acestuia |
| Expirare după 10 secunde | Teams nu a răspuns la timp | Încercați din nou mai târziu |
| Redirecționările nu sunt urmate | URL-ul trimite în altă parte | Adăugați URL-ul final |
| Cardurile s-au oprit după plecarea unui coleg | Microsoft leagă fiecare workflow de persoanele care îl dețin, iar un workflow fără proprietar se poate opri | Adăugați coproprietari la workflow sau recreați-l |
Un raport programat eșuat nu este retrimis în aceeași perioadă: remediați cauza și folosiți Trimiteți acum.
Când să folosiți în schimb un webhook
Teams și webhook-urile de ieșire pot transporta aceleași reguli, dar se adresează unor cititori diferiți. Un canal Teams este pentru oameni: un card formatat și nimic de construit. Un webhook este pentru software: evenimentul brut, ca JSON semnat, pentru Zapier, Make, n8n sau propriul serviciu. Teams așteaptă un card, nu JSON-ul de eveniment AutoPSEO, așa că un URL Teams aparține întotdeauna secțiunii Microsoft Teams.
O prezentare a ceea ce primesc utilizatorii Teams se găsește pe pagina Microsoft Teams.