Konektor Teams dan Webhook: Status Penghentian dan Cara Menggantinya dengan Workflows
By Mirko Peters ·
Konektor Office 365 dan webhook masuk berbasis konektor di Teams dihentikan pada Mei 2026. Panduan ini membahas apa yang berhenti berfungsi, apa penggantinya, cara bermigrasi, dan di bagian mana Workflows masih berbeda.
Automatically translated with AI from the original post. Read the English original
Konektor Teams, termasuk konektor Incoming Webhook, sudah tidak tersedia. Microsoft Learn menyatakan bahwa konektor Office 365 di Teams dihentikan pada Mei 2026, dan cara untuk menerima permintaan webhook dan memposting ke Teams kini adalah aplikasi Workflows. Workflow yang dibangun dengan pemicu When a Teams webhook request is received menggantikan URL konektor lama.
Poin Penting
- Menurut Microsoft Learn, konektor Office 365 di Teams, termasuk webhook masuk berbasis konektor, dihentikan pada Mei 2026. Periode peluncuran akhir menurut blog pengembang adalah 18 hingga 22 Mei 2026.
- Penggantinya adalah aplikasi Workflows di Teams, yang berjalan di atas Power Automate. Gunakan pemicu When a Teams webhook request is received atau templat siap pakai.
- Workflow memiliki URL webhook sendiri, sehingga setiap sistem pengirim harus dialihkan ke URL tersebut, karena URL konektor lama tidak lagi berfungsi.
- Payload MessageCard tetap dapat ditampilkan, tetapi tombol HttpPost-nya tidak berfungsi. Gunakan Adaptive Cards untuk konten interaktif.
- Workflow dimiliki oleh pemilik, bukan oleh saluran. Tambahkan pemilik bersama agar workflow tidak terbengkalai ketika pemiliknya keluar.
Artikel ini menjelaskan apa yang dihentikan, apa penggantinya, cara berpindah, dan perbedaan mana yang masih dapat menimbulkan masalah.
Apa yang dihentikan dan kapan
Proses penghentian berlangsung hampir dua tahun dan tanggalnya berubah beberapa kali. Blog pengembang Microsoft 365 mendokumentasikan urutannya:
- Juli 2024: rencana awal untuk memblokir konektor baru mulai 15 Agustus 2024 dan menghentikan semua konektor pada 1 Oktober 2024.
- Juli 2024: penghentian diundur hingga Desember 2025.
- Oktober 2025: tenggat migrasi dipindahkan ke 31 Maret 2026.
- Februari 2026: dukungan Message Card ditambahkan ke Workflows, dan bot Workflows dapat memposting di saluran bersama. Tenggat dipindahkan ke 30 April 2026.
- 14 April 2026 (pembaruan akhir): peluncuran dimulai pada 18 Mei 2026 dan selesai pada 22 Mei 2026. Setelah itu, konektor tidak lagi berfungsi.
Item yang terdampak adalah konektor Office 365 di Teams, termasuk konektor berbasis webhook seperti Incoming Webhook dan konektor pihak ketiga yang memposting ke URL. Blog tersebut mencatat bahwa perubahan URL webhook berlaku untuk konektor berbasis webhook, bukan untuk konektor polling seperti RSS.
Jika ada yang masih memposting melalui konektor lama, anggap sudah rusak atau akan segera rusak, dan rencanakan migrasinya sekarang.
Apa yang menggantikan konektor
Microsoft menyebutkan tiga jalur di Learn:
- Aplikasi Workflows (Power Automate) untuk webhook masuk. Gunakan templat siap pakai atau pemicu When a Teams webhook request is received.
- Konektor Power Automate untuk ISV dan tim produk. Learn menyebutnya sebagai cara yang dapat diskalakan dan aman untuk memindahkan data ke dan dari Teams secara terprogram.
- Aplikasi Teams dengan pesan proaktif, sehingga pengguna dapat menyiapkan pesan berdasarkan peristiwa pemicu di sistem Anda.
Bagi sebagian besar admin dan penulis skrip, jalur 1 adalah penggantian langsung.
Cara memigrasikan webhook ke Workflows
Halaman dukungan Microsoft untuk webhook masuk tidak dapat dibaca saat artikel ini disiapkan, sehingga langkah-langkah di bawah ini mengikuti blog pengembang dan referensi konektor Learn.
- Daftarkan setiap konektor yang digunakan. Periksa saluran yang menggunakan Kelola saluran > Konektor, serta sistem yang mengirim peringatan, seperti alat pemantauan, build, atau tiket.
- Di Teams, buka aplikasi Workflows. Blog pengembang menyebutkan Anda juga dapat membukanya dari obrolan atau saluran melalui Opsi lainnya (...).
- Pilih templat webhook yang sudah disediakan, atau mulai dari awal dengan pemicu Saat permintaan webhook Teams diterima.
- Pilih tim dan saluran, lalu simpan, dan salin URL pemicu dari alur kerja di Power Automate.
- Ganti URL konektor lama di sistem pengirim dengan URL yang baru.
- Beri nama, deskripsikan, dan uji alur kerja, lalu tambahkan co-owner.
- Kirim POST uji dan periksa apakah pesan muncul.
Pemicu hanya menerima permintaan POST. Referensi konektor Learn menyebutkan bahwa permintaan GET tidak didukung.
Format payload dan kartu
Isi pemicu dapat berisi larik kartu adaptif. Referensi menunjukkan pesan dengan larik attachments yang contentType-nya adalah application/vnd.microsoft.card.adaptive. Satu isi Message Card tunggal juga diterima.
Perhatikan poin-poin berikut:
- Kartu Adaptif adalah cara yang didukung untuk membuat konten interaktif.
- Payload MessageCard dapat ditampilkan, tetapi tombol yang menggunakan HttpPost tidak berfungsi. Blog pengembang menyarankan beralih ke Kartu Adaptif jika Anda menggunakan elemen kartu interaktif.
Kontrol akses
Satu peningkatan nyata: pemicu memiliki pengaturan autentikasi. Learn mencantumkan tiga pilihan.
| Pengaturan | Yang harus dilakukan pengirim | |---|---| | Siapa saja | Jangan kirim header token autentikasi, atau permintaan akan gagal | | Pengguna mana pun di penyewa saya | Kirim token autentikasi | | Pengguna tertentu di penyewa saya | Kirim token autentikasi, dan pengguna harus ada dalam daftar izin |
Untuk opsi penyewa, Learn merujuk ke panduannya tentang autentikasi OAuth untuk pemicu permintaan HTTP. Jika sebuah alat hanya dapat mengirim POST biasa ke URL, alat tersebut memerlukan pengaturan Siapa saja. Dalam kasus itu, perlakukan URL sebagai rahasia.
Perbedaan dengan konektor lama
Rencanakan hal-hal berikut sebelum Anda beralih.
- Identitas pengirim. Pembaruan blog pengembang April 2026 menyebutkan bahwa kustomisasi ikon dan nama bot tidak tersedia untuk posting webhook. Pesan akan menampilkan identitas bot Workflows default.
- Kepemilikan. Learn menyebutkan bahwa alur kerja terikat pada pemilik, bukan pada tim atau saluran. Jika pemilik keluar dan tidak ada co-owner, alur kerja dapat menjadi yatim. Tambahkan co-owner dengan kontrol penuh.
- Batas. Referensi Learn mencantumkan sekitar 1.000 panggilan masuk bersamaan untuk pemicu, dan batas 28 KB untuk aksi Posting kartu adaptif dalam obrolan atau saluran. Payload yang lebih besar akan mengembalikan galat "Request Entity too large".
- Saluran privat. Sumber-sumbernya tidak sejalan. Blog pengembang menyebutkan bahwa pemilihan saluran privat di aplikasi Workflows dijadwalkan untuk dirilis sepenuhnya pada 20 April 2026. Salah satu halaman Learn menyatakan bahwa webhook Workflows mendukung saluran privat, sementara halaman Learn lainnya menyebut dukungan saluran privat sedang dikembangkan. Referensi konektor Microsoft Teams masih menyatakan bahwa pengiriman pesan atau kartu ke saluran privat saat ini tidak didukung. Uji saluran target Anda sebelum mengandalkannya.
Kesalahan umum
- Hanya memigrasikan saluran dan lupa mengubah URL di sistem pengirim.
- Membiarkan satu orang sebagai satu-satunya pemilik alur kerja.
- Mengirim token ke pemicu yang diatur ke Siapa saja.
- Mempertahankan tombol MessageCard dan berharap callback-nya berfungsi.
- Menganggap nama dan ikon bot lama akan ikut terbawa.
Terkait
Sumber
- Penghentian Office 365 connector di dalam Microsoft Teams (blog developer Microsoft 365)
- Membuat Office 365 Connectors untuk Teams (Microsoft Learn)
- Penghentian Microsoft 365 Connectors dan Custom Connectors di Teams (Microsoft Learn)
- Referensi konektor Microsoft Teams untuk Power Automate (Microsoft Learn)
FAQ
Apakah konektor Teams masih berfungsi?
Tidak. Microsoft Learn menyatakan bahwa konektor Office 365 di Teams, termasuk webhook masuk berbasis konektor, dihentikan pada Mei 2026. Blog pengembang Microsoft 365 menyebutkan periode peluncuran akhir pada 18 hingga 22 Mei 2026 dan menyatakan bahwa webhook harus sudah dimigrasikan sebelum periode tersebut dimulai.
Apa yang menggantikan konektor Incoming Webhook di Teams?
Aplikasi Workflows, yang berjalan di atas Power Automate. Menurut Microsoft Learn, Anda dapat menggunakan templat siap pakai yang memposting ke obrolan atau saluran saat permintaan webhook diterima, atau membangun alur dari awal dengan pemicu When a Teams webhook request is received.
Apakah saya memerlukan URL baru untuk alat pemantauan atau skrip saya?
Ya. Workflow memiliki URL pemicu sendiri, dan referensi konektor menjelaskan bahwa pemicu dijalankan oleh permintaan POST ke endpoint tersebut. Halaman yang saya baca tidak menjelaskan di mana URL itu ditampilkan, jadi buka pemicu workflow di Power Automate untuk menyalinnya. Tempelkan URL tersebut ke sistem yang mengirim permintaan POST.
Apakah webhook Workflows dapat memposting tombol yang memanggil kembali sistem saya?
Tidak dengan MessageCard. Blog pengembang menyebutkan bahwa MessageCard menampilkan konten tetapi tidak mendukung tombol aksi HttpPost. Untuk elemen interaktif, Microsoft merekomendasikan Adaptive Cards, dan Learn menyatakan bahwa Anda harus mengonfigurasi workflow untuk menangani respons tersebut.
Siapa yang dapat mengirim permintaan ke webhook workflow?
Anda yang menentukan. Referensi konektor Microsoft Teams di Learn mencantumkan tiga opsi: siapa saja, pengguna mana pun di penyewa Anda, atau pengguna tertentu di penyewa Anda. Untuk opsi penyewa, permintaan harus menyertakan token autentikasi. Untuk opsi Siapa saja, Anda tidak boleh mengirimkan token.