Документація
Сповіщення та звіти в Microsoft Teams
Створіть вебхук Workflows у каналі Teams, додайте його до AutoPSEO і отримуйте сповіщення та регулярні звіти у вигляді Adaptive Cards із кольором за рівнем серйозності.
AutoPSEO надсилає повідомлення в Microsoft Teams через вебхук Workflows. Teams дає вам URL, який публікує повідомлення в один канал, а ви додаєте цей URL в AutoPSEO як канал Teams. Після цього сповіщення, регулярні звіти, тестові повідомлення та підсумки одноразових звітів надходять у вигляді Adaptive Cards: заголовок має колір за рівнем серйозності, а кнопка веде назад до звіту. Робочий простір Slack не потрібен, і встановлювати в Teams застосунок AutoPSEO теж не потрібно.
Отримайте URL вебхука в Teams
У посібнику Microsoft з вхідних вебхуків URL створюється за допомогою застосунку Workflows:
- У Teams відкрийте канал, який має отримувати картки, і виберіть поруч із ним Додаткові параметри (...).
- Виберіть Workflows і оберіть шаблон вебхука. Зараз Microsoft називає його Send webhook alerts to a channel; підказка AutoPSEO на сторінці налаштувань досі використовує стару назву, Post to a channel when a webhook request is received.
- Перевірте команду й канал, які шаблон підставив автоматично, і натисніть Зберегти.
- Скопіюйте посилання на вебхук, яке показує робочий процес.
URL зі старого конектора Incoming Webhook (на webhook.office.com) і досі приймається. Microsoft виводить з експлуатації конектори Microsoft 365 і блокуватиме створення нових, тож для всього, що ви налаштовуєте зараз, користуйтеся Workflows.
Додайте канал в AutoPSEO
- У розділі Microsoft Teams сторінки Slack, Teams & Webhooks натисніть New Teams channel. Форма відкриється з Microsoft Teams як місцем призначення.
- Введіть Name, за яким ви легко впізнаєте канал, і вставте URL. Для запису Teams AutoPSEO приймає адреси Workflows і конекторів (хости на кшталт
logic.azure.com,powerautomate.com,azure-api.netіwebhook.office.com), а інші хости відхиляє. - Натисніть Add channel, а потім Send test у його рядку. У каналі має з'явитися картка із заголовком, що збігається з назвою запису.
- Створіть регулярний звіт або сповіщення і виберіть цей канал.
Правило надсилає повідомлення в один канал. Щоб одне й те саме сповіщення приходило і в Slack, і в Teams, створіть правило двічі: окремо для кожного.
Як побудована картка
Кожне повідомлення стає однією Adaptive Card (версії 1.4, на всю ширину), загорнутою в обгортку message із вкладенням application/vnd.microsoft.card.adaptive, яку використовують і власні приклади Microsoft.
- Заголовок великим жирним шрифтом. Для сповіщень картка бере колір Attention для критичного та високого рівнів, Warning для середнього й типовий колір для низького; звіти й тести використовують колір Accent.
- Підсумок: те саме речення, що й у повідомленні Slack, із зазначенням періоду дат.
- Показники: до 12 підписаних значень, наприклад кліки та їхня зміна або поточне значення сповіщення порівняно з базовим.
- Таблиця: для звітів і підсумків звітів, до десяти рядків моноширинним шрифтом.
- Нижній колонтитул: ресурс, нагадування, що дані Search Console відстають приблизно на добу і що враховуються лише завершені дні, а також відправник.
- Open report: кнопка, що веде до відповідного звіту в AutoPSEO.
Чому картка не надійшла
Send test одразу повідомляє про помилку; для запланованих повідомлень Delivery history зберігає відповідь, яку дав Teams.
| Що ви бачите | Імовірна причина | Що робити |
|---|---|---|
| «That does not look like a Teams Workflows or Incoming Webhook URL» під час збереження | URL не належить до хоста Workflows або конектора | Ще раз скопіюйте посилання з робочого процесу |
| HTTP 400 після Send test | Це все-таки не вебхук Teams: URL Slack, хук Zapier або робочий процес, змінений так, що очікує інше тіло запиту | Створіть новий робочий процес із шаблону й додайте його URL |
| Тайм-аут через 10 секунд | Teams не відповів вчасно | Спробуйте пізніше |
| Перенаправлення не відстежуються | URL переадресовує кудись інде | Додайте кінцевий URL |
| Картки перестали надходити після того, як колега залишив команду | Microsoft прив'язує кожен робочий процес до його власників, і процес без власника може зупинитися | Додайте співвласників до робочого процесу або створіть його заново |
Невдалий запланований звіт не надсилається повторно в тому самому періоді: усуньте причину й скористайтеся Send now.
Коли замість цього використовувати вебхук
Teams і вихідні вебхуки можуть обслуговувати одні й ті самі правила, але призначені для різних одержувачів. Канал Teams призначений для людей: це відформатована картка, і нічого не треба розробляти. Вебхук призначений для програмного забезпечення: сира подія у вигляді підписаного JSON для Zapier, Make, n8n або вашого власного сервісу. Teams очікує картку, а не JSON події AutoPSEO, тому URL Teams завжди належить до розділу Microsoft Teams.
Огляд можливостей для користувачів Teams є на сторінці Microsoft Teams.