Siapkan Integrasi PMS Cloudbeds

Penyiapan Cepat

Menghubungkan Cloudbeds biasanya memakan waktu sekitar 10 menit. Cloudbeds sekarang meminta akses item, akses add-on read-only, serta akses baca untuk hotel, rate, dan taxes/fees.

Panduan ini membantu Anda menghubungkan Cloudbeds. Panduan ini menjaga data reservasi, tamu, housekeeping, pembayaran, kamar, mata uang, hotel, rate, dan pajak tetap tersinkron. Jika Cloudbeds menolak koneksi, AVA sekarang menampilkan alasan yang tepat di banner error.

Lokasinya

Settings → Essentials → Property Management System (PMS) Integration

Sebelum Mulai

Anda memerlukan:

• Akun Cloudbeds dengan akses admin
• Kredensial login Cloudbeds
• Izin untuk mengotorisasi aplikasi pihak ketiga

peringatan

Hanya satu akun Cloudbeds yang dapat terhubung pada satu waktu untuk setiap properti.

Menghubungkan ke Cloudbeds

Langkah 1: Pilih Cloudbeds sebagai PMS Anda

1. Buka Settings → Essentials
2. Gulir ke Property Management System (PMS) Integration
3. Klik kartu Cloudbeds
4. Tanda centang (✓) muncul untuk mengonfirmasi pilihan

Langkah 2: Mulai Koneksi

1. Klik tombol Connect to Cloudbeds
2. Jendela baru akan terbuka ke Cloudbeds

Langkah 3: Otorisasi Akses

1. Login ke akun Cloudbeds Anda
2. Tinjau izin yang diminta AVA
3. Klik Authorize atau Allow
4. Jendela akan tertutup otomatis

AVA sekarang meminta izin berikut:

Izin	Untuk apa AVA menggunakannya
read:hotel	Melihat metadata hotel
read:guest	Melihat detail tamu
write:guest	Memperbarui detail tamu
read:housekeeping	Melihat data housekeeping
write:housekeeping	Memperbarui data housekeeping
read:rate	Melihat data rate plan
read:payment	Melihat data pembayaran
write:payment	Memperbarui data pembayaran
read:reservation	Melihat data reservasi
write:reservation	Memperbarui data reservasi
read:room	Melihat data kamar
write:room	Memperbarui data kamar
read:currency	Membaca pengaturan mata uang properti
read:taxesAndFees	Melihat data pajak dan biaya
read:item	Melihat data katalog item
write:item	Memperbarui data katalog item
read:addon	Melihat data katalog add-on

Koneksi lama

Jika Anda menghubungkan Cloudbeds sebelum pembaruan ini, hubungkan ulang untuk menyegarkan scope baca yang telah diberikan.

Langkah 4: Verifikasi Koneksi

1. Kembali ke pengaturan AVA
2. Tunggu "Finalizing connection..." (5-10 detik)
3. Status menampilkan tanda centang hijau
4. Pesan menampilkan: "Cloudbeds Account Linked"

Koneksi selesai! 🎉

Error OAuth Cloudbeds

Saat Cloudbeds memblokir koneksi, AVA menampilkan pesan yang mudah dibaca. Anda tidak perlu lagi menebak dari kegagalan generik.

Yang Anda lihat	Artinya	Yang harus dilakukan
Cloudbeds did not return the OAuth state parameter.	Callback Cloudbeds tidak memiliki data state.	Mulai koneksi lagi.
Cloudbeds did not return an authorization code.	Cloudbeds tidak menyelesaikan otorisasi.	Sambungkan ulang dari Settings → Essentials.
Cloudbeds OAuth state verification failed.	State callback tidak valid atau kedaluwarsa.	Sambungkan ulang Cloudbeds.
Could not identify the merchant for this Cloudbeds link.	AVA tidak dapat mencocokkan callback dengan hotel Anda.	Pastikan Anda login ke properti yang benar.
Cloudbeds rejected the authorization code exchange.	Cloudbeds memblokir pertukaran token.	Periksa scope dan redirect URI, lalu coba lagi.
Failed to link Cloudbeds account.	AVA tidak dapat memetakan error backend.	Salin pesan lengkap dan hubungi support.

Apa yang Disinkronkan Otomatis

Cloudbeds menggunakan webhook untuk pembaruan real-time. Saat ada perubahan di Cloudbeds, AVA langsung diberi tahu:

Peristiwa	Yang terjadi
Reservation created	AVA menerima notifikasi dan dapat menjadwalkan pesan pra-kedatangan
Reservation dates changed	AVA memperbarui pesan yang dijadwalkan
Check-in/out status	Status tersinkron secara real-time

Saat Anda melihat reservasi di AVA, sistem mengambil data terbaru langsung dari Cloudbeds. Ini memastikan Anda selalu melihat informasi terkini.

info

Aliran data terutama dari Cloudbeds → AVA. Pembaruan tamu yang dilakukan di AVA (seperti penyelesaian check-in) dikirim kembali ke Cloudbeds.

Dampak ke Tamu & Staf

• Formulir tamu menyesuaikan aturan Cloudbeds. Field wajib dan field tersembunyi berubah berdasarkan konfigurasi Cloudbeds, sehingga tamu hanya melihat yang diperlukan.
• Pencarian reservasi menggunakan Cloudbeds. Jika Cloudbeds tidak terhubung, langkah pencarian tamu akan gagal.
• Pengaturan room condition hanya memengaruhi sinkronisasi housekeeping. Pengaturan ini mengatur apakah AVA mengirim status Clean atau Inspected ke Cloudbeds ketika kamar ditandai bersih di AVA. Ini tidak mengubah UI tamu.
• AVA meminta akses item dan akses add-on read-only. write:addon sengaja tidak disertakan.
• Scope baca Cloudbeds disegarkan saat reconnect. Hubungkan ulang jika Anda memerlukan data hotel, rate, atau taxes/fees dari grant lama.

Memutus Koneksi Cloudbeds

Putuskan koneksi hanya jika Anda:

• Beralih ke PMS lain
• Mengganti akun Cloudbeds
• Menangani masalah sinkronisasi

Untuk memutus koneksi:

1. Buka Settings → Essentials
2. Klik Disconnect from Cloudbeds
3. Konfirmasi saat diminta

waspada

Memutus koneksi akan menghentikan semua sinkronisasi secara langsung. Data yang sudah ada tetap ada tetapi tidak akan diperbarui.

Pemecahan Masalah

Koneksi berhenti di "Connecting..."

1. Tunggu 30 detik
2. Muat ulang halaman
3. Periksa koneksi internet Anda
4. Coba browser lain
5. Nonaktifkan pemblokir popup

Pesan error OAuth Cloudbeds

Yang Anda lihat: Pesan OAuth Cloudbeds muncul di banner.

Perbaikan:

1. Baca pesan tersebut terlebih dahulu.
2. Cocokkan dengan tabel di atas.
3. Sambungkan ulang Cloudbeds jika pesan menyebut state, code, atau token exchange.
4. Pastikan Anda memakai akun admin Cloudbeds.
5. Periksa redirect URI jika token exchange terus gagal.

info

Banner sekarang menampilkan detail error milik Cloudbeds jika tersedia. Ini memberi titik awal yang lebih jelas untuk dukungan.

Reservasi tidak tersinkron

1. Tunggu 15 menit untuk sinkronisasi awal
2. Periksa status koneksi (seharusnya hijau)
3. Coba putuskan lalu sambungkan ulang
4. Pastikan reservasi memang ada di Cloudbeds

Tab katalog tidak muncul

Yang Anda lihat: Tab Items atau Add-ons tidak ada.

Perbaikan:

1. Buka ulang halaman Rooms.
2. Periksa prompt izin Cloudbeds.
3. Pastikan prompt menyertakan read:item, write:item, dan read:addon.
4. Hubungi support jika tab katalog masih tidak muncul.

Jendela popup tidak terbuka

1. Periksa pengaturan pemblokir popup di browser Anda
2. Izinkan popup dari domain AVA
3. Coba browser lain atau mode incognito

Keamanan

• Koneksi menggunakan OAuth 2.0 yang aman
• Kata sandi Anda tidak pernah disimpan di AVA
• Cabut akses kapan saja dari Cloudbeds
• Koneksi kedaluwarsa setelah 90 hari tidak aktif

Pertanyaan yang Sering Diajukan

Bisakah saya menghubungkan beberapa properti Cloudbeds? Tidak, satu properti per akun AVA.

Apakah memutus koneksi akan menghapus data saya? Tidak, data yang sudah ada tetap ada tetapi tidak akan diperbarui.

Bisakah staf menghubungkan Cloudbeds? Tidak, hanya administrator yang dapat mengelola koneksi PMS.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Error OAuth yang sama muncul lagi setelah reconnect.
• ❌ Cloudbeds terus menolak pertukaran authorization code.
• ❌ Anda tidak dapat memastikan akun atau properti Cloudbeds yang benar.

Sebaiknya sertakan:

• Screenshot banner error