Документация

Оповещения и отчёты в Microsoft Teams

Создайте веб-хук Workflows в канале Teams, добавьте его в AutoPSEO и получайте оповещения и отчёты по расписанию в виде Adaptive Cards, цвет которых зависит от важности.

Аккаунт → Slack, Teams и вебхуки → Microsoft TeamsНужна подписка или пробный период3 мин чтения

AutoPSEO отправляет сообщения в Microsoft Teams через веб-хук Workflows. Teams выдаёт URL, который публикует сообщения в один канал, а вы добавляете этот URL в AutoPSEO как канал Teams. После этого оповещения, отчёты по расписанию, тестовые сообщения и сводки по разовым отчётам приходят в виде Adaptive Cards: цвет заголовка зависит от важности, а кнопка ведёт обратно к отчёту. Рабочее пространство Slack не требуется, и устанавливать приложение AutoPSEO в Teams тоже не нужно.

Получение URL веб-хука в Teams

В руководстве Microsoft по входящим веб-хукам URL создаётся в приложении Workflows:

В Teams откройте канал, в который должны приходить карточки, и выберите рядом с ним More options (...).
Выберите Workflows и найдите шаблон веб-хука. Сейчас Microsoft называет его Send webhook alerts to a channel; подсказка AutoPSEO на странице настроек пока использует прежнее название: Post to a channel when a webhook request is received.
Проверьте команду и канал, которые шаблон подставил автоматически, и нажмите Save.
Скопируйте ссылку на веб-хук, которую покажет workflow.

URL от прежнего коннектора Incoming Webhook (на webhook.office.com) по-прежнему принимается. Однако Microsoft выводит из эксплуатации Microsoft 365 Connectors и заблокирует создание новых, поэтому для всего, что вы настраиваете сейчас, используйте 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 сообщает об ошибке сразу, а для сообщений по расписанию ответ Teams сохраняется в разделе Delivery history.

Что вы видите	Вероятная причина	Что делать
При сохранении появляется «That does not look like a Teams Workflows or Incoming Webhook URL»	URL указывает не на хост Workflows или коннектора	Скопируйте ссылку из workflow ещё раз
HTTP 400 при Send test	Это всё-таки не веб-хук Teams: URL Slack, хук Zapier или workflow, изменённый так, что ожидает другое тело запроса	Создайте новый workflow из шаблона и добавьте его URL
Тайм-аут через 10 секунд	Teams не ответил вовремя	Повторите попытку позже
Редиректы не отслеживаются	URL перенаправляет на другой адрес	Добавьте конечный URL
Карточки перестали приходить после ухода коллеги	Microsoft привязывает каждый workflow к его владельцам, и workflow без владельца может перестать работать	Добавьте соавторов в workflow или создайте его заново

Неудавшийся отчёт по расписанию не отправляется повторно в том же периоде: устраните причину и нажмите Send now.

Когда лучше использовать веб-хук

Teams и исходящие веб-хуки могут работать с одними и теми же правилами, но рассчитаны на разных получателей. Канал Teams предназначен для людей: готовая отформатированная карточка, ничего разрабатывать не нужно. Веб-хук предназначен для программ: исходное событие в виде подписанного JSON для Zapier, Make, n8n или вашего собственного сервиса. Teams ожидает карточку, а не JSON событий AutoPSEO, поэтому URL Teams всегда нужно добавлять в раздел Microsoft Teams.

Обзор возможностей для пользователей Teams — на странице Microsoft Teams.