M365Con 2027 – бесплатная онлайн-конференция · 11–22 Jan 2027 · 120 sessions m365con.net

Блог · Mirko Peters

Коннекторы Teams и веб-хуки: статус выведения из эксплуатации и замена на рабочие процессы

By ·

Коннекторы Office 365 и входящие веб-хуки на основе коннекторов в Teams были выведены из эксплуатации в мае 2026 года. В этом руководстве рассказывается, что перестало работать, что пришло на смену, как выполнить миграцию и в чём рабочие процессы всё ещё отличаются.

Automatically translated with AI from the original post. Read the English original

Коннекторы Teams, включая коннектор Incoming Webhook, больше не работают. В документации Microsoft Learn указано, что коннекторы Office 365 в Teams выведены из эксплуатации в мае 2026 года, а получать запросы веб-хуков и публиковать сообщения в Teams теперь нужно с помощью приложения Workflows. Рабочий процесс с триггером When a Teams webhook request is received заменяет старый URL коннектора.

Ключевые выводы

  • По данным Microsoft Learn, коннекторы Office 365 в Teams, включая входящие веб-хуки на основе коннекторов, были выведены из эксплуатации в мае 2026 года. Последнее окно развёртывания, указанное в блоге для разработчиков, — с 18 по 22 мая 2026 года.
  • Заменой служит приложение Workflows в Teams, которое работает на базе Power Automate. Используйте триггер «When a Teams webhook request is received» или готовый шаблон.
  • У рабочего процесса собственный URL веб-хука, поэтому каждую отправляющую систему нужно переключить на него, так как старый URL коннектора больше не работает.
  • Полезные нагрузки MessageCard отображаются, но их кнопки HttpPost не работают. Для интерактивного содержимого используйте Adaptive Cards.
  • Рабочие процессы принадлежат владельцу, а не каналу. Добавьте соавторов, чтобы рабочий процесс не остался без владельца, когда тот покинет организацию.

В этой статье объясняется, что было выведено из эксплуатации, что пришло на замену, как перейти на новое решение и какие отличия всё ещё могут создать проблемы.

Что было выведено из эксплуатации и когда

Вывод из эксплуатации растянулся почти на два года, а сроки несколько раз переносились. Блог для разработчиков Microsoft 365 фиксирует последовательность событий:

  • Июль 2024 года: первоначальный план предусматривал блокировку новых коннекторов с 15 августа 2024 года и прекращение работы всех коннекторов 1 октября 2024 года.
  • Июль 2024 года: вывод из эксплуатации перенесён на декабрь 2025 года.
  • Октябрь 2025 года: срок миграции перенесён на 31 марта 2026 года.
  • Февраль 2026 года: в Workflows добавлена поддержка Message Card, а бот Workflows получил возможность публиковать сообщения в общих каналах. Срок перенесён на 30 апреля 2026 года.
  • 14 апреля 2026 года (последнее обновление): развёртывание начинается 18 мая 2026 года и завершается 22 мая 2026 года. После этого коннекторы перестают работать.

Затронутые элементы — коннекторы Office 365 в Teams, включая коннекторы на основе веб-хуков, такие как Incoming Webhook, и сторонние коннекторы, которые публикуют сообщения на URL. В блоге отмечается, что изменение URL веб-хука относится к коннекторам на основе веб-хуков, а не к коннекторам с опросом, таким как RSS.

Если что-то всё ещё публикует сообщения через старый коннектор, считайте это сломанным или близким к поломке и планируйте миграцию уже сейчас.

Что заменяет коннекторы

Microsoft на Learn называет три пути:

  1. Приложение Workflows (Power Automate) для входящих веб-хуков. Используйте готовый шаблон или триггер When a Teams webhook request is received.
  2. Коннектор Power Automate для ISV и продуктовых команд. В Learn его называют масштабируемым и безопасным способом программно передавать данные в Teams и из Teams.
  3. Приложение Teams с проактивными сообщениями, которое позволяет пользователям настраивать сообщения по триггерным событиям в вашей системе.

Для большинства администраторов и скриптовых специалистов путь 1 — это прямая замена.

Как перенести webhook на Workflows

Страница поддержки Microsoft по входящим webhook не открывалась во время подготовки этой статьи, поэтому приведённые ниже шаги основаны на блоге для разработчиков и справочнике по коннектору в Learn.

  1. Составьте список всех используемых коннекторов. Проверьте каналы, где использовался пункт Управление каналом > Коннекторы, а также системы, которые отправляют оповещения, например инструменты мониторинга, сборки или заявок.
  2. В Teams откройте приложение Workflows. Блог для разработчиков сообщает, что его также можно открыть из чата или канала через Дополнительные параметры (...).
  3. Выберите готовый шаблон webhook или начните с нуля с триггера When a Teams webhook request is received.
  4. Выберите команду и канал, сохраните настройки и скопируйте URL триггера из рабочего процесса в Power Automate.
  5. Замените старый URL коннектора в отправляющей системе на новый.
  6. Задайте имя, описание и протестируйте рабочий процесс, а также добавьте соавторов.
  7. Отправьте тестовый POST-запрос и убедитесь, что сообщение появилось.

Триггер принимает только POST-запросы. В справочнике по коннектору в Learn указано, что GET-запросы не поддерживаются.

Формат данных и карточки

Тело триггера может содержать массив адаптивных карточек. В справочнике приведено сообщение с массивом attachments, у которого contentType равен application/vnd.microsoft.card.adaptive. Принимается также отдельное тело Message Card.

Имейте в виду следующие моменты:

  • Адаптивные карточки — поддерживаемый способ создавать интерактивное содержимое.
  • Полезные нагрузки MessageCard отображаются, но кнопки с HttpPost не работают. В блоге для разработчиков рекомендуется перейти на адаптивные карточки, если вы используете интерактивные элементы карточек.

Контроль доступа

Одно реальное улучшение: у триггера есть настройка аутентификации. В Learn перечислены три варианта.

| Настройка | Что должен сделать отправитель | |---|---| | Anyone | Не отправлять заголовок с токеном аутентификации, иначе запрос завершится с ошибкой | | Any user in my tenant | Отправить токен аутентификации | | Specific users in my tenant | Отправить токен аутентификации, и пользователь должен быть в списке разрешённых |

Для вариантов в пределах клиента Learn отсылает к руководству по аутентификации OAuth для триггеров HTTP-запросов. Если инструмент умеет только отправлять простой POST на URL, ему нужна настройка Anyone. В этом случае относитесь к URL как к секрету.

Отличия от старого коннектора

Учтите эти моменты до переключения.

  • Идентичность отправителя. Обновление блога для разработчиков от апреля 2026 года сообщает, что изменение значка и имени бота для сообщений webhook недоступно. Сообщения показываются с идентичностью бота Workflows по умолчанию.
  • Владение. В Learn указано, что рабочие процессы привязаны к владельцам, а не к команде или каналу. Если владелец уходит и соавтора нет, поток может остаться без владельца. Добавьте соавторов с полным контролем.
  • Ограничения. В справочнике Learn указано около 1 000 одновременных входящих вызовов для триггера и лимит 28 КБ для действия Post adaptive card in a chat or channel. Более крупные полезные нагрузки возвращают ошибку "Request Entity too large".
  • Приватные каналы. Источники расходятся. В блоге для разработчиков сказано, что выбор приватных каналов в приложении Workflows должен был полностью появиться к 20 апреля 2026 года. Одна страница Learn указывает, что webhook в Workflows поддерживают приватные каналы, а на другой странице поддержка приватных каналов названа находящейся в разработке. В справочнике по коннектору Microsoft Teams по-прежнему написано, что отправка сообщения или карточки в приватный канал сейчас не поддерживается. Прежде чем полагаться на целевой канал, проверьте его.

Распространённые ошибки

  • Перенос только канала без изменения URL в отправляющей системе.
  • Оставление одного человека единственным владельцем рабочего процесса.
  • Отправка токена на триггер с настройкой Anyone.
  • Сохранение кнопок MessageCard в расчёте на то, что обратные вызовы будут работать.
  • Предположение, что старые имя и значок бота перенесутся автоматически.

Связанное

Источники

Подписаться на подкастApple PodcastsSpotify

FAQ

Коннекторы Teams ещё работают?

Нет. В документации Microsoft Learn указано, что коннекторы Office 365 в Teams, включая входящие веб-хуки на основе коннекторов, были выведены из эксплуатации в мае 2026 года. В блоге для разработчиков Microsoft 365 последним окном развёртывания названы период с 18 по 22 мая 2026 года, а также указано, что веб-хуки нужно было перевести до его начала.

Что заменяет коннектор Incoming Webhook в Teams?

Приложение Workflows, которое работает на базе Power Automate. По данным Microsoft Learn, можно либо использовать готовый шаблон, который публикует сообщение в чат или канал при получении запроса веб-хука, либо создать поток с нуля с триггером «When a Teams webhook request is received» («Получен запрос веб-хука Teams»).

Нужен ли новый URL для моего средства мониторинга или скрипта?

Да. У рабочего процесса собственный URL триггера, а в справочнике по коннекторам сказано, что триггер запускается запросом POST к этой конечной точке. В прочитанных мной материалах не указано, где отображается этот URL, поэтому откройте триггер рабочего процесса в Power Automate и скопируйте его. Вставьте его в систему, которая отправляет запрос POST.

Может ли веб-хук Workflows выводить кнопки, которые вызывают мою систему обратно?

Не с MessageCard. В блоге для разработчиков указано, что MessageCard отображает содержимое, но не поддерживает кнопки действий HttpPost. Для интерактивных элементов Microsoft рекомендует Adaptive Cards, а в Learn сказано, что рабочий процесс нужно настроить на обработку ответов.

Кто может отправлять запросы на веб-хук рабочего процесса?

Это вы выбираете. В справочнике по коннектору Microsoft Teams на Learn перечислены три варианта: любой пользователь, любой пользователь вашего клиента или конкретные пользователи вашего клиента. Для вариантов с клиентом запросы должны содержать токен аутентификации. Для варианта «Anyone» (Любой) отправлять токен не нужно.

Entities in this article

Темы этой статьи:

Microsoft Teams – Инструмент для совместной работы от Microsoft Power Automate – Инструмент low-code от Microsoft Соединитель – Понятие Adaptive Cards – Продукт

Related articles

Другие статьи на тему Microsoft Teams:

RSS