Panduan RoomX

"Belum terhubung" atau tombol "Pilih dari M365" kosong

Kenali penyebab integrasi Microsoft 365 tidak jalan — izin kurang, jeda cache, atau satu pengikatan ruangan yang gagal.

Gejala

Salah satu dari ini terjadi setelah menghubungkan Microsoft 365:

  • Kartu Microsoft 365 tetap menampilkan chip Belum terhubung, atau berubah jadi Error (mode bahasa Indonesia: Kesalahan).
  • Tombol Pilih dari M365 ditekan tapi tidak memunculkan daftar apa pun.
  • Panel menampilkan sibuk/kosong, tapi judul acara tidak pernah muncul dan perubahan di Outlook baru terlihat lama kemudian.

Yang seharusnya terlihat

Kartu menampilkan chip Terhubung dengan "Terakhir sinkron" yang bergerak sendiri. Tombol pemilih memunculkan daftar ruangan atau kalender. Acara yang dibuat di Outlook muncul di panel dalam hitungan detik.

Ketiga gejala di atas punya penyebab berbeda. Kenali dulu yang mana.

Penyebab 1 — izin Place.Read.All belum diberikan

Ini penyebab paling sering kalau tombol pemilih kosong. Tanpa izin itu, Microsoft menolak permintaan daftar ruangan, dan konsol menyembunyikan pemilihnya tanpa pesan error.

Cara memperbaiki

  1. Buka App registration di Azure → API permissions.
  2. Pastikan Place.Read.All ada, dan berada di kolom Application — bukan Delegated.
  3. Klik Grant admin consent, lalu pastikan kolom Status berubah hijau menjadi Granted for ….

Menambahkan izin tanpa menekan Grant admin consent tidak berefek apa pun. Ini kekeliruan yang paling sering terjadi.

Sementara menunggu, alamat ruangan tetap bisa diketik manual — pemilih hanya alat bantu.

Penyebab 2 — izin sudah benar, tapi belum berlaku

Ada dua lapis penyimpanan sementara, dan keduanya normal:

  • Sisi RoomX menyegarkan izinnya sendiri sampai sekitar satu jam.
  • Perubahan pembatasan di Exchange butuh 30 menit sampai 2 jam.

Selama jendela itu, gejalanya persis sama dengan izin yang gagal.

Cara memperbaiki

Tunggu. Jangan mengubah-ubah pengaturan Azure di rentang itu — perubahan berulang justru membuat sulit mengetahui mana yang akhirnya berlaku. Kalau ingin lebih cepat, minta tim RoomX me-restart layanan API; itu langsung membuang penyimpanan sementara di sisi kami.

Penyebab 3 — chip berubah jadi "Error" dan menetap

Artinya ada satu pengikatan ruangan yang gagal dibaca — biasanya kalender atau mailbox yang alamatnya salah ketik, sudah dihapus, atau tidak ada di tenant.

Selama status Error, tombol pemilih juga ikut menolak bekerja. Ini membingungkan karena alat yang Anda butuhkan untuk memperbaiki justru ikut mati.

Cara memperbaiki

  1. Buka menu Ruang dan periksa ruangan yang baru saja diikat.
  2. Kosongkan pengikatan yang mencurigakan, atau perbaiki alamatnya.
  3. Tunggu satu siklus sinkron. Satu siklus yang berhasil mengembalikan status ke Terhubung dengan sendirinya — tidak perlu menghubungkan ulang.

Penyebab 4 — judul acara tidak pernah muncul dan pembaruan lambat

Aplikasinya hanya diberi izin Calendars.ReadBasic. Izin itu cukup untuk sibuk/kosong, tetapi tidak cukup untuk judul acara maupun notifikasi realtime.

Cara memperbaiki

Naikkan izin aplikasi ke Calendars.Read di Azure, lalu berikan admin consent lagi. Lihat Menghubungkan Microsoft 365 untuk matriks izin lengkapnya.

Penyebab 5 — daftar ruangan Microsoft kosong padahal ruangannya ada

Dua kemungkinan, dan keduanya di sisi Microsoft:

  • Direktori ruangan di tenant belum diaktifkan. Setelah diaktifkan, penyebarannya bisa sampai 12 jam.
  • Alamat ruangan tidak punya isian Country/Region. Ruangan tanpa isian itu kadang tidak pernah muncul di direktori.

Cara memperbaiki

Minta admin Microsoft sekolah mengaktifkan direktori ruangan dan melengkapi alamat tiap ruangan, lalu coba lagi keesokan harinya.

Penyebab 6 — persetujuan ditolak dengan kode AADSTS50011

Alamat pengembalian (redirect URI) yang terdaftar di Azure tidak persis sama dengan yang dipakai RoomX. Beda satu karakter, termasuk garis miring di akhir, sudah cukup untuk ditolak.

Cara memperbaiki

Salin alamat redirect dari halaman Menghubungkan Microsoft 365 dan tempelkan apa adanya ke Authentication → Web → Redirect URIs di Azure. Jangan diketik ulang.

Kalau chip berbunyi "Kredensial aplikasi tidak valid"

Client Secret sudah kedaluwarsa atau salah. Secret punya masa berlaku maksimal 24 bulan dan berhenti tanpa peringatan saat habis.

Buat Client Secret baru di Azure, masukkan nilainya di Pengaturan → Konfigurasi Microsoft, lalu Simpan konfigurasi M365. Tekan Uji koneksi untuk memastikan pasangan ID + secret diterima Microsoft. Pada keadaan ini tombol Hubungkan M365 tidak ditampilkan dan consent tidak perlu diulang — sinkronisasi pulih sendiri pada siklus berikutnya.

Izin ditarik di sisi Microsoft (service principal dihapus, atau grant dicabut oleh admin tenant). Tekan Hubungkan M365 sekali lagi dan berikan persetujuan ulang sebagai Global Admin.

Kalau semuanya sudah dicoba

Hubungi tim RoomX. Sertakan: nama sekolah, chip yang tertera di kartu, pesan error persis kalau ada, daftar izin yang tampak di Azure beserta status consent-nya, jam kejadian, dan foto layar halaman API permissions.

Selama masalah ini berlangsung, panel tetap benar terhadap jadwal dan pemesanan manual — kegagalan M365 berarti data kalender Outlook menjadi basi, bukan panel mati.

Terakhir diverifikasi: 18 Agustus 2026

On this page