Konektory Teams i webhooki: status wycofania i sposób zastąpienia ich przepływami pracy
By Mirko Peters ·
Konektory Office 365 i przychodzące webhooki oparte na konektorach w usłudze Teams zostały wycofane w maju 2026 r. Ten przewodnik opisuje, co przestało działać, co je zastępuje, jak przeprowadzić migrację i w czym przepływy pracy nadal się różnią.
Automatically translated with AI from the original post. Read the English original
Konektory Teams, w tym konektor Incoming Webhook, przestały istnieć. Microsoft Learn podaje, że konektory Office 365 w usłudze Teams zostały wycofane w maju 2026 r., a sposobem na odbieranie żądań webhooków i publikowanie wiadomości w Teams jest teraz aplikacja Workflows. Przepływ pracy oparty na wyzwalaczu Po odebraniu żądania webhooka Teams zastępuje stary adres URL konektora.
Najważniejsze wnioski
- Według Microsoft Learn konektory Office 365 w usłudze Teams, w tym przychodzące webhooki oparte na konektorach, zostały wycofane w maju 2026 r. Ostatni okres wdrażania podany na blogu dla deweloperów to od 18 do 22 maja 2026 r.
- Zamiennikiem jest aplikacja Workflows w Teams, czyli Power Automate. Użyj wyzwalacza When a Teams webhook request is received lub gotowego szablonu.
- Przepływ pracy ma własny adres URL webhooka, dlatego każdy system wysyłający żądania musi zostać przełączony na niego, ponieważ stary adres URL konektora przestał działać.
- Ładunki MessageCard są renderowane, ale ich przyciski HttpPost nie działają. Do treści interaktywnych używaj kart adaptacyjnych (Adaptive Cards).
- Przepływy pracy należą do właściciela, a nie do kanału. Dodaj współwłaścicieli, aby przepływ nie został bez opiekuna, gdy jego właściciel odejdzie z organizacji.
Ten artykuł wyjaśnia, co zostało wycofane, co to zastępuje, jak przejść na nowe rozwiązanie i jakie różnice nadal mogą sprawić kłopot.
Co zostało wycofane i kiedy
Wycofywanie trwało prawie dwa lata, a termin przesuwano kilkukrotnie. Blog dla deweloperów Microsoft 365 dokumentuje tę sekwencję:
- Lipiec 2024: pierwotny plan zakładał blokadę nowych konektorów od 15 sierpnia 2024 r. i zatrzymanie wszystkich konektorów 1 października 2024 r.
- Lipiec 2024: wycofanie przesunięto na grudzień 2025 r.
- Październik 2025: termin migracji przesunięto na 31 marca 2026 r.
- Luty 2026: dodano obsługę Message Card w usłudze Workflows, a bot Workflows mógł publikować w kanałach udostępnionych. Termin przesunięto na 30 kwietnia 2026 r.
- 14 kwietnia 2026 r. (ostatnia aktualizacja): wdrażanie rozpocznie się 18 maja 2026 r. i zakończy 22 maja 2026 r. Po tym terminie konektory przestają działać.
Dotknięte elementy to konektory Office 365 w usłudze Teams, w tym konektory oparte na webhookach, takie jak Incoming Webhook, oraz konektory zewnętrzne, które publikują wiadomości pod adresem URL. Blog zauważa, że zmiana adresu URL webhooka dotyczy konektorów opartych na webhookach, a nie konektorów pobierających dane cyklicznie, takich jak RSS.
Jeśli coś nadal publikuje wiadomości przez stary konektor, traktuj to jako uszkodzone lub bliskie awarii i zaplanuj migrację już teraz.
Co zastępuje konektory
Microsoft na Learn wskazuje trzy ścieżki:
- Aplikacja Workflows (Power Automate) dla przychodzących webhooków. Użyj gotowego szablonu lub wyzwalacza Po odebraniu żądania webhooka Teams.
- Łącznik Power Automate dla ISV i zespołów produktowych. Learn opisuje go jako skalowalny i bezpieczny sposób programowego przenoszenia danych do usługi Teams i z niej.
- Aplikacja Teams z wiadomościami proaktywnymi, dzięki której użytkownicy mogą konfigurować wiadomości uruchamiane zdarzeniami wyzwalającymi w Twoim systemie.
Dla większości administratorów i autorów skryptów ścieżka 1 jest bezpośrednim zamiennikiem.
Jak przenieść webhook do usługi Workflows
Strona pomocy technicznej Microsoft dotycząca przychodzących webhooków była niedostępna w chwili przygotowywania tego artykułu, więc poniższe kroki opierają się na blogu deweloperskim i na dokumentacji łącznika w Learn.
- Wypisz wszystkie używane łączniki. Sprawdź kanały, w których użyto opcji Zarządzaj kanałem > Łączniki, oraz systemy wysyłające alerty, takie jak narzędzia do monitoringu, budowania lub obsługi zgłoszeń.
- W usłudze Teams otwórz aplikację Workflows. Blog deweloperski wskazuje, że można ją też otworzyć z czatu lub kanału za pomocą opcji Więcej opcji (...).
- Wybierz gotowy szablon webhooka albo zacznij od zera, używając wyzwalacza Gdy zostanie odebrane żądanie webhooka usługi Teams.
- Wybierz zespół i kanał, a następnie zapisz przepływ i skopiuj adres URL wyzwalacza z przepływu w usłudze Power Automate.
- W systemie wysyłającym zastąp stary adres URL łącznika nowym.
- Nazwij i opisz przepływ, przetestuj go i dodaj współwłaścicieli.
- Wyślij testowe żądanie POST i sprawdź, czy wiadomość się pojawiła.
Wyzwalacz akceptuje wyłącznie żądania POST. Dokumentacja łącznika w Learn stwierdza, że żądania GET nie są obsługiwane.
Format ładunku i karty
Treść wyzwalacza może zawierać tablicę kart adaptacyjnych. Dokumentacja pokazuje wiadomość z tablicą attachments, w której contentType ma wartość application/vnd.microsoft.card.adaptive. Akceptowana jest też pojedyncza treść Message Card.
Miej na uwadze te kwestie:
- Karty adaptacyjne to obsługiwany sposób tworzenia treści interaktywnych.
- Ładunki MessageCard są wyświetlane, ale przyciski korzystające z HttpPost nie działają. Blog deweloperski zaleca przejście na karty adaptacyjne, jeśli używasz interaktywnych elementów kart.
Kontrola dostępu
Jedna realna poprawa: wyzwalacz ma ustawienie uwierzytelniania. Learn wymienia trzy opcje.
| Ustawienie | Co musi zrobić nadawca | |---|---| | Każdy | Nie wysyłać nagłówka tokenu uwierzytelniania, inaczej żądanie się nie powiedzie | | Dowolny użytkownik w mojej dzierżawie | Wysłać token uwierzytelniania | | Określeni użytkownicy w mojej dzierżawie | Wysłać token uwierzytelniania, a użytkownik musi znajdować się na liście dozwolonych |
Opcje dla dzierżawy Learn odsyła do przewodnika o uwierzytelnianiu OAuth dla wyzwalaczy żądań HTTP. Jeśli narzędzie potrafi wysłać wyłącznie zwykłe żądanie POST na adres URL, potrzebuje ustawienia Każdy. Wtedy traktuj adres URL jak sekret.
Różnice w porównaniu z dotychczasowym łącznikiem
Uwzględnij poniższe kwestie przed przełączeniem.
- Tożsamość nadawcy. Aktualizacja blogu deweloperskiego z kwietnia 2026 r. informuje, że nie można dostosowywać ikony ani nazwy bota w wiadomościach webhook. Wiadomości pokazują domyślną tożsamość bota Workflows.
- Własność. Learn podaje, że przepływy są powiązane z właścicielami, a nie z zespołem czy kanałem. Jeśli właściciel odejdzie, a nie będzie współwłaściciela, przepływ może zostać osierocony. Dodaj współwłaścicieli z pełnymi uprawnieniami.
- Limity. Dokumentacja Learn podaje około 1 000 jednoczesnych połączeń przychodzących dla wyzwalacza oraz limit 28 KB dla akcji Opublikuj kartę adaptacyjną na czacie lub w kanale. Większe ładunki zwracają błąd „Request Entity too large”.
- Kanały prywatne. Źródła są sprzeczne. Blog deweloperski podaje, że wybór kanałów prywatnych w aplikacji Workflows miał zostać w pełni wdrożony do 20 kwietnia 2026 r. Jedna ze stron Learn stwierdza, że webhooki Workflows obsługują kanały prywatne, a inna opisuje obsługę kanałów prywatnych jako będącą w fazie opracowywania. Dokumentacja łącznika Microsoft Teams nadal mówi, że publikowanie wiadomości lub kart w kanale prywatnym nie jest obecnie obsługiwane. Przed poleganiem na docelowym kanale go przetestuj.
Częste błędy
- Przeniesienie samego kanału i zapomnienie o zmianie adresu URL w systemie wysyłającym.
- Pozostawienie jednej osoby jako jedynego właściciela przepływu.
- Wysyłanie tokenu do wyzwalacza ustawionego na Każdy.
- Pozostawienie przycisków w MessageCard i oczekiwanie, że wywołania zwrotne będą działać.
- Zakładanie, że stara nazwa i ikona bota zostaną przeniesione.
Powiązane
Źródła
- Wycofanie łączników Office 365 w usłudze Microsoft Teams (blog deweloperski Microsoft 365)
- Tworzenie Office 365 Connectors dla Microsoft Teams (Microsoft Learn)
- Wycofanie Microsoft 365 Connectors i Custom Connectors w Microsoft Teams (Microsoft Learn)
- Dokumentacja łącznika Microsoft Teams dla Power Automate (Microsoft Learn)
FAQ
Czy konektory Teams nadal działają?
Nie. Microsoft Learn podaje, że konektory Office 365 w usłudze Teams, w tym przychodzące webhooki oparte na konektorach, zostały wycofane w maju 2026 r. Blog dla deweloperów Microsoft 365 wskazuje od 18 do 22 maja 2026 r. jako ostatni okres wdrażania i informuje, że webhooki musiały zostać przeniesione, zanim wdrażanie się rozpocznie.
Co zastępuje konektor Incoming Webhook w usłudze Teams?
Aplikacja Workflows, która działa w oparciu o Power Automate. Zgodnie z Microsoft Learn możesz użyć gotowego szablonu, który publikuje wiadomości w czacie lub kanale po otrzymaniu żądania webhook, albo zbudować przepływ od podstaw, używając wyzwalacza When a Teams webhook request is received.
Czy do narzędzia monitorującego lub skryptu potrzebuję nowego adresu URL?
Tak. Przepływ pracy ma własny adres URL wyzwalacza, a dokumentacja konektora opisuje wyzwalacz jako uruchamiany żądaniem POST wysłanym do tego punktu końcowego. Przeczytane przeze mnie strony nie wskazują, gdzie wyświetlany jest ten adres, dlatego otwórz wyzwalacz przepływu pracy w Power Automate, aby go skopiować. Wklej go w systemie, który wysyła żądanie POST.
Czy webhook przepływu pracy może wyświetlać przyciski wywołujące zwrotnie mój system?
Nie w przypadku MessageCard. Blog dla deweloperów podaje, że MessageCard renderuje treść, ale nie obsługuje przycisków akcji HttpPost. W przypadku elementów interaktywnych Microsoft wskazuje karty adaptacyjne (Adaptive Cards), a Learn podaje, że przepływ pracy trzeba skonfigurować tak, aby obsługiwał odpowiedzi.
Kto może wysyłać żądania do webhooka przepływu pracy?
Wybierasz to Ty. Dokumentacja konektora Microsoft Teams na Learn wymienia trzy opcje: każdy, dowolny użytkownik w Twojej dzierżawie lub wybrani użytkownicy w Twojej dzierżawie. W przypadku opcji dotyczących dzierżawy żądania muszą zawierać token uwierzytelniający. W przypadku opcji Każdy nie wolno go wysyłać.