Integrasi Cloudbeds PMS

Penyiapan Cepat

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

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

Lokasinya

Settings → Essentials → Property Management System (PMS) Integration

Sebelum Memulai

Anda membutuhkan:

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

peringatan

Hanya satu akun Cloudbeds yang bisa terhubung pada satu waktu untuk tiap 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 terbuka ke Cloudbeds

Langkah 3: Otorisasi Akses

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

AVA sekarang meminta izin berikut:

Izin	Fungsi di AVA
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 katalog item
write:item	Memperbarui katalog item
read:addon	Melihat katalog add-on

Koneksi lama

Jika Anda menghubungkan Cloudbeds sebelum pembaruan ini, sambungkan ulang untuk memperbarui scope baca yang 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 umum.

Yang terlihat	Artinya	Yang harus dilakukan
Cloudbeds did not return the OAuth state parameter.	Callback Cloudbeds tidak menyertakan 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 bisa 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 bisa memetakan error backend.	Salin pesan lengkap dan hubungi support.

Apa yang Disinkronkan Otomatis

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

Event	Yang Terjadi
Reservation created	AVA menerima notifikasi dan bisa menjadwalkan pesan pre-arrival
Reservation dates changed	AVA memperbarui pesan yang sudah 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

Data terutama mengalir dari Cloudbeds → AVA. Pembaruan tamu yang dibuat di AVA (seperti penyelesaian check-in) dikirim kembali ke Cloudbeds.

Perlindungan baca Cloudbeds

Jika beberapa staf meminta data Cloudbeds yang sama pada saat bersamaan, AVA berbagi satu permintaan baca. Jika Cloudbeds mengembalikan error akses yang sama atau success:false lagi, AVA menunda percobaan ulang berulang untuk sementara.

Dampak untuk Tamu & Staf

• Form tamu menyesuaikan aturan Cloudbeds. Field wajib dan field tersembunyi berubah sesuai konfigurasi Cloudbeds, jadi tamu hanya melihat yang diperlukan.
• Lookup reservasi memakai Cloudbeds. Jika Cloudbeds tidak terhubung, langkah lookup tamu akan gagal.
• Label sumber pemesanan dapat memakai metadata sumber Cloudbeds. Jika sebuah reservasi tidak punya sourceName, AVA kembali ke nama sumber Cloudbeds yang terhubung.
• Source collect berasal dari record sumber yang terhubung bila tersedia. Itu menjaga perilaku sumber hotel dan channel tetap konsisten dengan pengaturan Cloudbeds.
• Pengaturan room condition hanya memengaruhi sinkron housekeeping. Pengaturan ini mengendalikan apakah AVA mengirim status Clean atau Inspected ke Cloudbeds saat 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 diperbarui saat reconnect. Sambungkan ulang jika Anda butuh data hotel, rate, atau taxes/fees pada grant lama.

Memutus Cloudbeds

Putuskan hanya jika Anda:

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

Untuk memutus:

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

waspada

Memutus koneksi menghentikan semua sinkronisasi segera. Data yang ada tetap ada tetapi tidak akan diperbarui.

Pemecahan Masalah

Koneksi macet di "Connecting..."

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

Pesan error OAuth Cloudbeds

Yang terlihat: Pesan OAuth Cloudbeds muncul di banner.

Perbaikan:

1. Baca pesan 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 asli dari Cloudbeds jika tersedia. Ini memberi Anda titik awal yang lebih jelas untuk support.

Reservasi tidak tersinkron

1. Tunggu 15 menit untuk sinkron awal
2. Periksa status koneksi (harus hijau)
3. Coba putuskan lalu sambungkan kembali
4. Verifikasi reservasi memang ada di Cloudbeds

Error akses atau properti Cloudbeds

Yang terlihat: Pesan seperti You don't have access to property ID, atau error Cloudbeds yang sama muncul lagi segera.

Mengapa ini terjadi: Akun Cloudbeds yang terhubung tidak bisa membaca properti tersebut. AVA juga menunda percobaan ulang berulang untuk waktu singkat.

Perbaikan:

1. Pastikan Anda login ke properti Cloudbeds yang benar.

2. Minta admin Cloudbeds memeriksa akses dan izin properti.

3. Tunggu sebentar sebelum menekan Refresh lagi.

4. Hubungi support jika pesan terus muncul.

   ✓ Refresh berikutnya seharusnya berhasil setelah masalah akses Cloudbeds diperbaiki.

Tab katalog tidak muncul

Yang terlihat: Tab Items atau Add-ons hilang.

Perbaikan:

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

Jendela popup tidak terbuka

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

Keamanan

• Koneksi memakai 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

Bisa hubungkan beberapa properti Cloudbeds? Tidak, satu properti per akun AVA.

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

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

Masih Buntu?

Hubungi success@vouch-technologies.com jika:

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

Sebaiknya sertakan:

• Tangkapan layar banner error
• Waktu masalah mulai terjadi
• Pesan persis yang tampil di AVA

Panduan Terkait

• PMS Connection
• PMS Options
• PMS Connection Errors