Menyiapkan Integrasi Mews PMS

Penyiapan Cepat

Sebagian besar hotel hanya membutuhkan Access Token. Ini memakan waktu sekitar 10 menit.

Panduan ini membantu Anda menghubungkan AVA ke Mews agar reservasi dan detail tamu tersinkron dengan benar.

Di Mana Menemukannya

Settings → Essentials → Property Management System (PMS) Integration

Referensi Cepat

Setting	Yang dikendalikan	Kapan digunakan
Access Token	Menghubungkan AVA ke Mews	Selalu
Advanced → Client Token	Kredensial koneksi lanjutan	Hanya jika support meminta
Advanced → Client ID	Identitas properti Anda di Mews	Hanya jika support meminta
Advanced → Demo Mode	Menggunakan endpoint sandbox untuk pengujian	Hanya untuk lingkungan uji
Reservation comments	Mengambil catatan service order Mews ke AVA	Saat AVA membaca reservasi
Room payment waiver	Menggunakan invoice yang dikembalikan untuk menentukan waiver	Saat invoice menandai room payment sebagai waived
Payment waiver keywords	Menampilkan field kata kunci waiver di pengaturan pembayaran AVA	Hanya saat koneksi Mews Anda menyediakan dukungan waiver berbasis keyword

Sebelum Memulai

Anda perlu:

• Akses ke area admin Mews
• Access Token / Token ID untuk integrasi AVA
• Izin admin untuk memperbarui pengaturan PMS di AVA

info

Jika Anda tidak punya Access Token, hubungi admin Mews atau support AVA.

Cara Mendapatkan Access Token Mews Anda

Ikuti langkah berikut di Mews:

1. Log in ke Mews PMS

2. Klik Marketplace di sidebar

   

3. Klik My Subscriptions

   

4. Temukan Vouch AVA Front Desk Agent

5. Klik Edit

6. Buka bagian Access Token

7. Salin Token ID

   

tip

Tempel token ke AVA segera supaya tidak hilang.

Langkah Konfigurasi

Langkah 1: Pilih Mews

1. Buka Settings → Essentials → PMS Integration
2. Klik kartu Mews
3. Form konfigurasi Mews muncul

Langkah 2: Masukkan Access Token

1. Tempel Token ID dari Mews ke field Access Token
2. Token disembunyikan setelah disimpan demi keamanan

Nilai yang disamarkan aman

Jika Anda kembali nanti dan melihat karakter yang disamarkan, biarkan apa adanya lalu klik Save. AVA menyimpan Access Token, Client Token, dan Client ID yang telah disimpan.

Jika Anda membutuhkan pengaturan Mews Advanced (khusus support)

1. Klik Advanced
2. Masukkan nilai yang diberikan support:
   • Client Token
   • Client ID
3. Opsional: Nyalakan Demo Mode jika Anda menguji dengan endpoint sandbox

peringatan

Jangan ubah nilai Advanced kecuali support menyuruh Anda. Nilai yang salah bisa menghentikan sinkron.

Langkah 3: Simpan

1. Klik Save di bagian bawah halaman
2. Cari pesan sukses
3. Field Access Token menampilkan placeholder untuk melindungi secret

Yang Terjadi Setelah Tersambung

• ✅ AVA mulai memakai data Mews untuk reservasi dan detail tamu
• ✅ Field Access Token menampilkan karakter yang disamarkan
• ✅ Gunakan Edit Token jika Anda perlu memperbarui token nanti
• ℹ️ AVA mempertahankan nilai Demo Mode saat Anda menyimpan field Mews lainnya.
• ℹ️ Produksi tidak memaksa Demo Mode menjadi OFF.
• ✅ Nama perusahaan Mews kini mengisi label sumber reservasi saat AVA bisa menyelesaikannya.
• ✅ Reservasi Mews diperlakukan sebagai hotel collect di AVA.
• ✅ Status room-lock Do Not Move tetap sinkron dengan Mews.
• ✅ AVA melewati kamar Mews yang diblokir saat penugasan otomatis dan mencoba kamar bersih lain jika memungkinkan.
• ✅ AVA mengambil catatan service order Mews ke komentar reservasi.
• ✅ Catatan yang cocok dapat me-waive pembayaran kamar saat invoice mengembalikan flag waiver.
• ✅ AVA memuat detail invoice lengkap sebelum memeriksa waiver pada pembacaan reservasi tunggal.
• ✅ AVA menjaga kamar Mews yang belum ditetapkan tetap terlihat dalam booking multi-room.

Dampak untuk Tamu & Staf

• Form tamu menyesuaikan aturan Mews. Field wajib dan field tersembunyi berubah berdasarkan konfigurasi Mews, jadi tamu hanya melihat yang diperlukan.
• Lookup reservasi memakai Mews. Jika Mews tidak dikonfigurasi, langkah lookup tamu akan gagal.
• Label sumber booking dapat menampilkan nama perusahaan Mews. Jika AVA bisa menyelesaikan nama perusahaan, AVA memakai nama itu alih-alih ID perusahaan mentah.
• Mews source collect sekarang default ke hotel collect. Ini menjaga label sumber selaras dengan kontrak reservasi yang diterima AVA.
• Kamar yang terkunci tetap terkunci di AVA. Jika Mews menandai reservasi sebagai terkunci, Streamliner menampilkan ikon lock di tampilan room-change.
• Catatan service order menjadi komentar reservasi. Staf dapat meninjau teks catatan saat lookup reservasi.
• Pembayaran kamar yang di-waive tetap bisa dijelaskan. Saat Mews menandai invoice sebagai waived, AVA menampilkan teks catatan sebagai alasan waiver.
• Kata kunci waiver pembayaran bergantung pada kemampuan. Jika Mews mengeksposnya, AVA menampilkan field kata kunci waiver di pengaturan pembayaran.

Booking Multi-Room Tetap Lengkap

AVA menjaga setiap kamar Mews yang sudah dipesan tetap terlihat, bahkan sebelum Mews menetapkan kamar fisik. Kamar utama tetap berada di urutan pertama daftar. Ini membantu staf melihat keseluruhan booking saat lookup dan check-in.

Booking Email Bersama Membuat Tamu Terpisah

Jika dua tamu berbagi email booking yang sama, AVA membuat customer Mews terpisah. AVA hanya memakai ulang customer ketika nomor dokumen cocok dengan record yang sudah ada. Jika AVA sudah punya referensi guest Mews langsung, AVA akan terus memperbarui guest itu.

Pencocokan tepat

AVA mencocokkan keyword waiver sebagai satu kata utuh. PAID tidak cocok dengan UNPAID.

Pemecahan Masalah

Error "Access Token is required"

Yang Anda lihat: "Access Token is required"

Perbaikan:

1. Tempel Token ID dari Mews
2. Klik Save lagi
3. ✓ Error hilang setelah disimpan

Token Tersimpan Tetapi Tidak Ada Sinkron Data

Yang Anda lihat: Anda menyimpan token, tetapi reservasi tidak muncul

Perbaikan:

1. Tunggu 10-15 menit untuk sinkron pertama
2. Muat ulang halaman dan pastikan Mews masih dipilih
3. Minta admin Mews memastikan subscription AVA aktif
4. Hubungi support AVA jika masalah berlanjut

Field yang Disamarkan Muncul Lagi Setelah Reload

Yang Anda lihat: Access Token atau field advanced menampilkan karakter yang disamarkan setelah Anda me-reload halaman.

Perbaikan:

1. Biarkan nilai yang disamarkan tetap ada.
2. Klik Save lagi.
3. ✓ AVA mempertahankan kredensial Mews yang tersimpan.

Anda Tidak Dapat Menemukan Client Token, Client ID, atau Demo Mode

Yang Anda lihat: Anda tidak melihat field Client Token, Client ID, atau Demo Mode

Perbaikan:

1. Klik Advanced
2. ✓ Field advanced muncul di dalam bagian Advanced

Demo Mode Aktif, Tetapi Sinkron Terlihat Salah

Yang Anda lihat: Reservasi hilang atau data uji yang tidak terduga

Perbaikan:

1. Matikan Demo Mode
2. Klik Save
3. Muat ulang halaman dan periksa status koneksi Anda
4. Hubungi support jika masalah berlanjut

Demo Mode Tidak Cocok Setelah Disimpan

Yang Anda lihat: Checkbox Demo Mode berubah setelah refresh, atau tidak cocok dengan pengaturan Mews yang tersimpan.

Perbaikan:

1. Buka Advanced.
2. Periksa nilai Demo Mode.
3. Simpan hanya perubahan yang Anda inginkan.
4. Muat ulang halaman.
5. Hubungi support jika checkbox masih tidak sesuai dengan config Mews yang tersimpan.

Sebuah Kamar Tidak Muncul di Room Changes

Yang Anda lihat: Kamar hilang dari Allow move room.

Perbaikan:

1. Periksa reservasi di Mews.
2. Hapus room lock jika kamar seharusnya bisa dipindah.
3. Muat ulang reservasi di AVA.
4. Coba room change lagi.

Mews Blocked Room Assignment

Yang Anda lihat: Check-in atau room change menampilkan "space is blocked" atau "room unavailable".

Perbaikan:

1. Tunggu AVA mencoba kamar bersih lain.
2. Tetapkan kamar berbeda di Mews jika tidak ada kamar bersih yang tersedia.
3. Muat ulang AVA dan coba lagi.

Pembayaran Kamar Masih Ditagih

Yang Anda lihat: Reservasi Mews masih meminta pembayaran kamar.

Perbaikan:

1. Buka reservasi di Mews.
2. Periksa catatan service order.
3. Pastikan catatan memakai wording waiver yang tepat.
4. Muat ulang reservasi di AVA.
5. Hubungi support jika pembayaran masih muncul.

Alasan Waiver Terlihat Salah

Yang Anda lihat: AVA me-waive pembayaran kamar, tetapi teks alasannya tidak sesuai.

Perbaikan:

1. Periksa catatan service order Mews yang cocok.
2. Pastikan teks catatan itu memang yang Anda harapkan.
3. Ingat bahwa AVA hanya mencocokkan whole word.
4. Hubungi support jika alasan waiver masih terlihat salah.

Daftar Verifikasi

• Mews dipilih di Select PMS Provider
• Access Token dimasukkan dan disimpan tanpa error
• Field Access Token menampilkan karakter yang disamarkan setelah refresh
• Reservasi mulai tersinkron dari Mews

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Sinkron tidak dimulai setelah 15 menit
• ❌ Anda melihat error penyimpanan yang tidak bisa diselesaikan
• ❌ Anda membutuhkan pengaturan Advanced tetapi tidak punya nilainya

Yang sebaiknya disertakan:

• Screenshot bagian PMS Integration
• Provider PMS Anda (Mews)
• Teks error yang persis, jika ada

Panduan Terkait

• PMS Connection
• Manage Reservation Payments
• PMS Connection Errors