Dokumentacja
Alerty i raporty w Microsoft Teams
Utwórz webhook Workflows na kanale Teams, dodaj go w AutoPSEO i otrzymuj alerty oraz raporty cykliczne jako karty Adaptive Cards w kolorze odpowiadającym ważności.
AutoPSEO wysyła wiadomości do Microsoft Teams przez webhook Workflows. Teams udostępnia adres URL, który publikuje wpisy na jednym kanale, a Ty dodajesz go w AutoPSEO jako kanał Teams. Alerty, raporty cykliczne, wiadomości testowe i jednorazowe podsumowania raportów trafiają wtedy na kanał jako karty Adaptive Cards z tytułem w kolorze zależnym od ważności i przyciskiem prowadzącym do raportu. Nie potrzebujesz przestrzeni roboczej Slack, a w Teams nie trzeba instalować żadnej aplikacji AutoPSEO.
Pobierz adres URL webhooka z Teams
Przewodnik po webhookach przychodzących firmy Microsoft opisuje tworzenie adresu URL za pomocą aplikacji Workflows:
- W Teams przejdź do kanału, który ma otrzymywać karty, i wybierz obok niego Więcej opcji (...).
- Wybierz Workflows i wskaż szablon webhooka. Microsoft nazywa go obecnie Send webhook alerts to a channel; podpowiedź AutoPSEO na stronie ustawień używa jeszcze starszej nazwy: Post to a channel when a webhook request is received.
- Sprawdź zespół i kanał, które szablon uzupełnił automatycznie, a następnie kliknij Zapisz.
- Skopiuj link do webhooka wyświetlony przez przepływ pracy.
Adres URL ze starszego konektora Incoming Webhook (na webhook.office.com) nadal jest akceptowany. Microsoft wycofuje konektory Microsoft 365 i zablokuje tworzenie nowych, dlatego do wszystkiego, co konfigurujesz teraz, używaj Workflows.
Dodaj kanał w AutoPSEO
- W sekcji Microsoft Teams na stronie Slack, Teams & Webhooks kliknij New Teams channel. Formularz otworzy się z Microsoft Teams jako miejscem docelowym.
- Wpisz Nazwę, po której łatwo rozpoznasz kanał, i wklej adres URL. Dla wpisu Teams AutoPSEO akceptuje adresy Workflows i konektorów (hosty takie jak
logic.azure.com,powerautomate.com,azure-api.netiwebhook.office.com), a inne hosty odrzuca. - Kliknij Add channel, a następnie Send test w jego wierszu. Na kanale powinna pojawić się karta z tytułem równym nazwie wpisu.
- Utwórz raport cykliczny lub alert i wybierz ten kanał.
Reguła wysyła wiadomości na jeden kanał. Aby ten sam alert trafiał zarówno do Slack, jak i do Teams, utwórz regułę dwukrotnie, osobno dla każdego z nich.
Jak wygląda karta
Każda wiadomość staje się jedną kartą Adaptive Card (wersja 1.4, pełna szerokość), umieszczoną w obiekcie message z załącznikiem application/vnd.microsoft.card.adaptive, zgodnie z przykładami samego Microsoftu.
- Tytuł wyświetlany dużą, pogrubioną czcionką. W alertach karta używa koloru Attention dla poziomów krytycznego i wysokiego, Warning dla średniego i koloru domyślnego dla niskiego; raporty i testy mają kolor Accent.
- Podsumowanie: to samo zdanie, które zawiera wiadomość w Slack, wraz z zakresem dat.
- Fakty: do 12 opisanych wartości, na przykład kliknięcia i ich zmiana albo bieżąca wartość alertu w porównaniu z wartością bazową.
- Tabela: w raportach i podsumowaniach raportów do dziesięciu wierszy czcionką o stałej szerokości.
- Stopka: witryna, przypomnienie, że dane z Search Console są opóźnione o około jeden dzień i że liczone są tylko dni z ustabilizowanymi danymi, oraz nadawca.
- Open report: przycisk prowadzący do odpowiedniego raportu w AutoPSEO.
Dlaczego karta nie dotarła
Send test zgłasza błąd od razu; w przypadku wiadomości cyklicznych Delivery history przechowuje odpowiedź, jakiej udzielił Teams.
| Co widzisz | Prawdopodobna przyczyna | Rozwiązanie |
|---|---|---|
| Komunikat „That does not look like a Teams Workflows or Incoming Webhook URL” przy zapisie | Adres URL nie wskazuje hosta Workflows ani konektora | Skopiuj link z przepływu pracy jeszcze raz |
| HTTP 400 po Send test | To jednak nie jest webhook Teams: adres URL ze Slack, hak Zapier albo przepływ pracy zmodyfikowany tak, że oczekuje innej treści żądania | Utwórz nowy przepływ pracy z szablonu i dodaj jego adres URL |
| Przekroczono limit 10 sekund | Teams nie odpowiedział na czas | Spróbuj ponownie później |
| Przekierowania nie są obsługiwane | Adres URL przekierowuje gdzie indziej | Dodaj docelowy adres URL |
| Karty przestały przychodzić po odejściu współpracownika | Microsoft wiąże każdy przepływ pracy z jego właścicielami, a przepływ bez właściciela może przestać działać | Dodaj współwłaścicieli do przepływu pracy albo utwórz go od nowa |
Nieudany raport cykliczny nie jest wysyłany ponownie w tym samym okresie: usuń przyczynę i użyj Send now.
Kiedy zamiast tego użyć webhooka
Teams i webhooki wychodzące mogą obsługiwać te same reguły, ale służą różnym odbiorcom. Kanał Teams jest dla ludzi: sformatowana karta i nic do budowania. Webhook jest dla oprogramowania: surowe zdarzenie jako podpisany JSON dla Zapier, Make, n8n lub Twojej własnej usługi. Teams oczekuje karty, a nie zdarzenia JSON z AutoPSEO, dlatego adres URL Teams zawsze należy dodawać w sekcji Microsoft Teams.
Przegląd tego, co dostają użytkownicy Teams, znajdziesz na stronie Microsoft Teams.