M365Con 2027 – безкоштовна онлайн-конференція · 11–22 Jan 2027 · 120 sessions m365con.net

Блог · Mirko Peters

Конектори Teams та вебхуки: статус відмови і заміна робочими процесами

By ·

Конектори Office 365 та вхідні вебхуки на основі конекторів у Teams були вилучені у травні 2026 року. У цьому посібнику описано, що перестало працювати, чим це замінити, як виконати міграцію і в яких аспектах Workflows досі відрізняється.

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 і з нього.
  3. Застосунок Teams з проактивними повідомленнями, щоб користувачі могли налаштовувати повідомлення на основі подій-тригерів у вашій системі.

Для більшості адміністраторів і скриптерів шлях 1 є прямою заміною.

Як мігрувати вебхук до Workflows

Сторінка підтримки Microsoft щодо вхідних вебхуків була недоступна під час підготовки цієї статті, тому наведені нижче кроки ґрунтуються на блозі для розробників і довідці з конектора Learn.

  1. Складіть перелік усіх конекторів, що використовуються. Перевірте канали, де застосовувалося Керувати каналом > Конектори, а також системи, які надсилають сповіщення, зокрема інструменти моніторингу, збірки чи трекери завдань.
  2. У Teams відкрийте застосунок Workflows. За даними блогу для розробників, його також можна відкрити з чату або каналу через Додаткові параметри (...).
  3. Виберіть готовий шаблон вебхука або почніть з нуля з тригера 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 року повідомляє, що налаштування значка та назви бота для вебхук-повідомлень недоступне. Повідомлення відображаються з типовою ідентичністю бота Workflows.
  • Власність. Learn зазначає, що робочі процеси прив'язані до власників, а не до команди чи каналу. Якщо власник піде, а співвласника немає, потік може залишитися без керівника. Додайте співвласників з повним контролем.
  • Обмеження. Довідка Learn вказує приблизно 1 000 одночасних вхідних викликів для тригера та ліміт 28 КБ для дії Post adaptive card in a chat or channel. Більші корисні навантаження повертають помилку «Request Entity too large».
  • Приватні канали. Джерела суперечать одне одному. Блог для розробників повідомляє, що вибір приватних каналів у застосунку Workflows мав повністю з'явитися до 20 квітня 2026 року; одна сторінка Learn каже, що вебхуки 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.

Чи потрібна нова URL-адреса для моєї системи моніторингу чи скрипта?

Так. Робочий процес має власну URL-адресу тригера, а довідка з конекторів описує тригер як запуск POST-запитом на цю кінцеву точку. У сторінках, які я переглядав, не сказано, де відображається ця URL-адреса, тому відкрийте тригер робочого процесу в Power Automate, щоб її скопіювати. Вставте її в систему, яка надсилає POST-запит.

Чи може вебхук Workflows публікувати кнопки, які викликають мою систему у відповідь?

Не через MessageCard. Блог для розробників зазначає, що MessageCard відображає вміст, але не підтримує кнопки дій HttpPost. Для інтерактивних елементів Microsoft рекомендує Adaptive Cards, а Learn пояснює, що відповіді потрібно обробляти, налаштувавши робочий процес.

Хто може надсилати запити на вебхук робочого процесу?

Ви обираєте. Довідка з конектора Microsoft Teams на Learn пропонує три варіанти: будь-хто, будь-який користувач у вашому клієнті або конкретні користувачі у вашому клієнті. Для варіантів у межах клієнта запити мають містити токен автентифікації. Для варіанта «Будь-хто» токен надсилати не слід.

Entities in this article

Теми цієї статті:

Microsoft Teams – Інструмент для спільної роботи від Microsoft Power Automate – Інструмент low-code від Microsoft З’єднувач – Поняття Adaptive Cards – Продукт

Related articles

Інші статті на тему Microsoft Teams:

RSS