Siapkan Chatbot Anda

Penyiapan Cepat

Sebagian besar hotel mengatur pesan, instruksi bot, dan jam live chat dalam waktu sekitar 7 menit.

Panduan ini membantu Anda mengonfigurasi pesan chatbot, perilaku balasan, dan akses tamu. Gunakan panduan ini saat Anda memerlukan jawaban tamu yang konsisten dan penanganan di luar jam operasional.

Buka: Communication Hub → Chatbot → Setup

---

Referensi Cepat

Tugas	Klik di mana	Hasil
Atur pesan sambutan	Bot Configuration → Welcome Message	Tamu melihat sapaan Anda terlebih dahulu
Atur balasan fallback	Bot Configuration → Default Answer	Agent (Pi) dapat menggunakannya saat tidak ada jawaban yang cocok
Tentukan nada bot	Bot Configuration → Bot Instruction	Agent (Pi) mengikuti panduan tersimpan Anda
Pilih mesin jawaban	Advanced Settings → Answer Engine	Beralih antara RAG dan Agent (Pi)
Sesuaikan gaya balasan	Advanced Settings	Mengontrol temperature, batas token, kedalaman retrieval, dan mode grounding
Aktifkan Skill Mode	Advanced Settings → Skill Mode	Menggunakan skill yang dikonfigurasi untuk balasan Agent (Pi) yang di-stream
Aktifkan verifikasi reservasi tamu	Widget & Access → Guest reservation verification	Tamu mengidentifikasi masa menginapnya sebelum chat dimulai
Jalankan Quick Setup	Quick Setup	Mengisi awal pesan dan nada
Pilih mode chat	Widget & Access → Chat mode	AI, live chat, atau hybrid
Atur jam live chat	Communication Hub → Livechat → Operating Hours	Staf membalas hanya selama jendela buka
Konfigurasikan feedback tamu	Communication Hub → Chatbot → Feedback Settings	Meminta rating chat 1–5 dari tamu
Buat landing page	Widget & Access → Create Landing Page	Tautan tamu dan opsi QR muncul
Perbarui nama landing page	Widget & Access → Sync Url Name	Menyesuaikan landing page dengan nama merchant Anda saat ini
Sesuaikan lembar cetak QR	Widget & Access → QR Print Template	Lembar kamar dan lokasi menggunakan desain Anda
Izinkan domain widget	Widget & Access → Whitelisted Domains	Widget dimuat di situs web Anda

Akses Paket

• Penyiapan chatbot memerlukan paket berbayar.
• Chatbot Setup memerlukan izin chatbot_setup:manage.
• Akun tingkat gratis menampilkan prompt upgrade dan tidak dapat menyimpan perubahan.

Untuk upgrade, buka Settings → Billing & Subscription.

Sebelum Memulai

Pastikan persyaratan berikut terpenuhi:

• Anda memiliki izin untuk mengelola pengaturan Chatbot
• Paket Anda mencakup fitur Chatbot
• Anda tahu nada yang ingin dipakai bot

Konfigurasikan Pesan Bot

1. Buka Communication Hub → Chatbot → Setup

2. Tetap di tab Bot Configuration

3. Perbarui Welcome Message dengan sapaan singkat

4. Perbarui Default Answer dengan balasan fallback yang membantu

5. Klik Save pada masing-masing kartu

   ✓ Pesan sukses muncul setelah setiap penyimpanan.

Atur Bot Instruction

1. Di Bot Instruction, jelaskan nada dan aturannya

2. Tekan Enter untuk menambahkan baris baru bagi aturan atau contoh terpisah

3. Klik Save

   ✓ Instruksi tersimpan untuk balasan chatbot baru.

Uji pengaturan chatbot yang tersimpan

Saat Anda menyimpan Default Answer, Bot Instruction, bahasa, atau pengaturan Skill Mode, AVA menggunakannya untuk permintaan chatbot baru. Beberapa alur AI yang terhubung mungkin masih menyiapkan konfigurasi di latar belakang.

1. Simpan satu perubahan konfigurasi.

2. Mulai chat baru saat menguji perilaku yang diperbarui.

3. Jika balasan masih menggunakan pengaturan lama, tunggu sebentar lalu coba lagi.

   ✓ Balasan baru menggunakan konfigurasi tersimpan terbaru.

Simpan perubahan satu per satu

Tunggu konfirmasi penyimpanan sebelum mengubah pengaturan AI lainnya. Ini membantu AVA menyiapkan konfigurasi terbaru tanpa perubahan yang tumpang tindih.

Contoh instruksi yang baik

“Bersikaplah singkat dan ramah. Ajukan pertanyaan lanjutan jika Anda tidak yakin.”

Instruksi multi-baris

Anda dapat menempelkan instruksi multi-baris dengan aturan, contoh, atau pengecualian yang terpisah.

Terapkan prompt penyiapan ke Agent (Pi)

Saat Answer Engine adalah Agent (Pi), Chat Widget mengirimkan Bot Instruction, bahasa, dan Default Answer yang tersimpan ke agent. Gunakan bidang ini untuk memandu nada agent dan respons cadangan.

Penerusan ini hanya berlaku untuk lalu lintas Chat Widget ke agent Pi. Perilaku Voice dan Request Support Chat tetap tidak berubah.

Pahami opsi pesan tamu bersama

Balasan Chat Widget dan WhatsApp Agent (Pi) mempertahankan jawaban kanonis lengkap. Teks pengiriman yang diterjemahkan tetap tersedia saat terjemahan diaktifkan. Selector presentasi adaptif yang sudah dihentikan tidak lagi memilih tombol, menu, atau gambar.

Yang dilihat tamu	Artinya
Jawaban lengkap	Respons agent lengkap tetap tersedia
Jawaban terjemahan	Teks yang dikirim menggunakan bahasa tamu jika dikonfigurasi
Pesan rich lama	Konten presentasi historis tetap dapat dibaca saat tersimpan

Balasan widget baru dan balasan WhatsApp agent diharapkan mempertahankan teks lengkap. Minta bantuan administrator AVA jika respons lengkap atau terjemahannya tidak tersedia.

Jawab pertanyaan pemesanan dengan skill yang dikonfigurasi

Agent (Pi) dapat menjawab pertanyaan pemesanan jika skill yang dipilih mendukung pencarian pemesanan. Ikuti detail wajib dan format jawaban yang ditetapkan skill tersebut.

Sebagai contoh, skill dapat meminta hotel, nomor konfirmasi, dan tanggal kedatangan.

Agent (Pi) menggunakan skill yang dipilih dan konteks tersimpannya untuk menjawab tamu. Tamu dapat mengajukan pertanyaan lanjutan yang spesifik jika skill menyimpan detail pemesanan yang diperlukan.

Minta pencarian baru jika detail berubah

Tamu harus memberikan hotel, nomor konfirmasi, dan tanggal kedatangan yang baru saat memeriksa pemesanan lain.

Gunakan format pemesanan lengkap

Minta tamu memberikan hotel, nomor konfirmasi, dan tanggal kedatangan dalam satu pesan. Gunakan format tanggal YYYY-MM-DD.

Batasi jawaban RAG pada hotel yang dipilih

Saat chatbot Anda memiliki dokumen untuk beberapa hotel, AVA mengidentifikasi hotel dalam pertanyaan jika memungkinkan. Kemudian AVA mempersempit jawaban ke sumber dokumen yang cocok.

Minta tamu menyebutkan nama hotel jika pertanyaan dapat berlaku untuk lebih dari satu properti. Jika AVA tidak dapat mengidentifikasi sumber yang cocok, AVA mempertahankan cakupan dokumen dan perilaku jawaban default yang telah dikonfigurasi.

Atur Pengaturan Balasan Lanjutan

1. Klik Advanced Settings di header halaman.

2. Di Answer Engine, pilih RAG atau Agent (Pi).

3. Tinjau bagian Generation untuk perilaku balasan.

4. Jika Anda memilih RAG, tinjau bagian Retrieval.

5. Di Retrieval, aktifkan atau nonaktifkan Disable grounding RAG engine.

6. Atur nilai dalam rentang berikut:

   • Temperature: 0 sampai 1
   • Top P: 0 sampai 1
   • Max Output Tokens: 500 sampai 3024
   • Retrieval K: 1 sampai 7

7. Jika Anda mengaktifkan Disable grounding RAG engine, pertahankan Retrieval K antara 1 dan 3.

8. Klik Save.

   ✓ Modal akan tertutup setelah penyimpanan berhasil.

Fungsi pengaturan ini

Nilai yang lebih rendah membuat balasan lebih fokus. Nilai yang lebih tinggi menambah variasi. RAG menggunakan dokumen chatbot dan pengaturan retrieval Anda. Agent (Pi) menyembunyikan kontrol khusus RAG di modal. Mengaktifkan Disable grounding RAG engine melakukan prefetch konteks secara langsung sebelum menjawab. Fitur ini menggunakan lebih banyak token, tetapi retrieval lebih andal. Jika tersedia beberapa sumber hotel, AVA dapat mempersempit retrieval RAG ke hotel yang disebutkan dalam pertanyaan. Chat Widget hanya mengirimkan Bot Instruction dan Default Answer ke Agent (Pi). Pengaturan ini memengaruhi balasan chatbot dan alur voice yang terhubung.

Gunakan Skill Mode

Gunakan Skill Mode saat penyiapan GenAI Anda harus men-stream respons melalui Agent (Pi). Streamliner menyinkronkan skill yang terpasang saat layanan dimulai. Skill baru atau yang diperbarui biasanya muncul setelah deployment berikutnya.

Perutean skill

Saat Use Skill Mode aktif, permintaan chat berbasis skill diarahkan ke Agent (Pi). Agent (Pi) memuat paket skill yang dipilih dan hanya menyediakan tool yang dikonfigurasi.

1. Klik Advanced Settings.

2. Aktifkan Use Skill Mode.

3. Isi Skill Name seperti booking-assistant.

4. Klik Save.

   ✓ Pengaturan tetap aktif setelah Anda membuka lagi Advanced Settings. ✓ Modal mempertahankan nama skill Anda.

Aturan nama skill

Skill Name harus memakai huruf kecil, angka, dan tanda hubung saja. Bidang ini wajib diisi saat Use Skill Mode aktif. Agent (Pi) menjalankan skill yang dipilih di belakang layar.

Jika skill tidak muncul

Minta admin Anda memulai ulang Streamliner setelah menambahkan atau memperbarui paket skill. Jika skill masih tidak dimuat, pastikan nama skill sama persis dengan nama paket.

Gunakan Quick Setup (Opsional)

1. Klik Quick Setup di header halaman
2. Ikuti wizard untuk membuat pesan dan nada
3. Tinjau hasilnya di field
4. Klik Save pada setiap bagian yang ingin Anda simpan

Pilih Mode Chat

1. Buka tab Widget & Access

2. Pilih satu mode:

   • AI only
   • Live chat only
   • Hybrid (AI + live chat)

   ✓ Mode yang dipilih akan disorot dan langsung berlaku.

Pahami Verifikasi Reservasi

Beberapa alur chatbot meminta tamu memverifikasi masa menginap sebelum membagikan bantuan khusus kamar. AVA menggunakan pencocokan yang selaras dengan Checkout dan menyimpan identitas reservasi tersebut untuk chat. Saat Anda mengaktifkan fitur ini, pratinjau widget menampilkan formulir identifikasi dan status terverifikasi.

Langkah	Yang diperiksa AVA	Hasil
Pencarian kamar	Nomor kamar tamu	AVA menemukan reservasi yang sudah check-in atau akan check-out untuk kamar tersebut
Pencocokan tamu	Nama tamu	AVA mengembalikan identitas kanonis yang cocok
Reservasi tertaut	Reservasi yang sudah ditautkan ke chat	AVA melewati prompt verifikasi tambahan dan mempertahankan kamar yang tersimpan
Validasi ulang	Identitas terverifikasi dari sebelumnya	AVA memeriksa identitas tersimpan tanpa fuzzy matching
Akses chat terverifikasi	Reservasi yang ditautkan selama percakapan ini	AVA mempertahankan bukti masa menginap terverifikasi untuk permintaan layanan tamu

1. Minta nomor kamar kepada tamu terlebih dahulu.

2. Kemudian minta nama tamu utama.

3. Gunakan ejaan yang sama seperti yang ditampilkan PMS.

4. Jika tamu sudah terverifikasi, periksa kembali identitas tersimpan alih-alih menanyakannya lagi.

5. Terus gunakan reservasi tertaut sampai tamu memulai chat baru.

   ✓ Jika tamu sudah menautkan reservasi, AVA menggunakan kembali identitas reservasi tersebut.

   ✓ Verifikasi mengikuti aturan kamar dan nama yang sama seperti Checkout.

   ✓ Setelah tamu menautkan reservasi, percakapan yang sama mempertahankan akses masa menginap terverifikasi untuk permintaan layanan tamu.

Perilaku pencocokan

Verifikasi reservasi menggunakan kembali pencocok tamu yang sama seperti Checkout. Fitur ini mempertahankan pengurutan kamar, penanganan nama asli, dan perilaku kecocokan pertama milik Checkout. AVA menautkan kamar hanya jika tepat satu reservasi aktif yang sudah check-in atau akan check-out cocok. Jika tidak ada kecocokan aktif atau ada beberapa kecocokan aktif, reservasi tetap tidak terverifikasi. Reservasi tertaut memungkinkan AVA melewati prompt kedua jika tamu sudah menautkan masa menginapnya. Jika tamu mengganti reservasi, AVA kembali menanyakan kamar dan nama.

Kompatibilitas PMS

AVA dapat memilih perilaku verifikasi reservasi dari konfigurasi PMS yang terhubung. Anda tidak perlu memasukkan atau memelihara versi PMS untuk alur ini.

Periksa pratinjau

Setelah menyimpan Guest reservation verification, buka pratinjau widget. Anda seharusnya melihat formulir identifikasi, bukan layar awal chat biasa.

Siapkan Feedback Tamu

Gunakan Feedback Settings untuk menanyakan pengalaman chat kepada tamu. Anda dapat menggunakan feedback setelah balasan bot yang tidak terjawab, setelah staf menutup Live Chat, atau keduanya.

Kedua pemicu feedback dinonaktifkan secara default. Pengaturan berlaku untuk hotel yang dipilih dan dapat diubah secara terpisah.

Buka: Communication Hub → Chatbot → Feedback Settings

Pengaturan	Yang dikontrol	Yang dilihat tamu
Rating style	Menggunakan wajah atau bintang	Lima pilihan dari 1 sampai 5
Rating question	Menetapkan pertanyaan rating	Pertanyaan Anda di atas pilihan
Ask when a guest goes quiet	Memulai tindak lanjut saat idle	Pertanyaan Ya atau Tidak setelah balasan bot
Minutes after bot reply	Menunda tindak lanjut saat idle	Waktu tunggu sebelum tindak lanjut muncul
Minutes to wait after follow-up	Menunda rating	Waktu tunggu sebelum rating muncul
Ask when staff closes a live chat	Memulai rating saat penutupan	Rating segera setelah tiket ditutup

Konfigurasikan rating

1. Buka Communication Hub → Chatbot → Feedback Settings.

2. Pilih Five faces atau Five stars.

3. Masukkan Rating question.

4. Tinjau pratinjau widget.

   ✓ Tamu dapat mengirimkan satu skor dari 1 sampai 5.

Minta feedback setelah tamu tidak merespons

1. Aktifkan Ask when a guest goes quiet.

2. Masukkan Follow-up question.

3. Atur Minutes after bot reply dari 1 sampai 60.

4. Atur Minutes to wait after follow-up dari 1 sampai 60.

5. Klik Save changes.

   ✓ AVA mengirimkan tindak lanjut setelah penundaan yang dikonfigurasi. ✓ Jawaban Yes menunggu pesan tamu berikutnya. ✓ Jawaban No menampilkan rating. ✓ Pesan baru dari tamu membatalkan prompt yang tertunda.

Minta feedback setelah staf menutup Live Chat

1. Aktifkan Ask when staff closes a live chat.

2. Klik Save changes.

   ✓ AVA menampilkan rating setelah staf menutup tiket. ✓ Aturan ini tidak mengirimkan pertanyaan tindak lanjut tambahan.

Waktu feedback

AVA menggunakan pengaturan tersimpan terbaru untuk prompt feedback baru. Tamu yang sudah menjawab prompt dapat menyelesaikan prompt tersebut menggunakan pilihan yang ditampilkan.

Simpan atau buang perubahan feedback

1. Tinjau pratinjau langsung sebelum menyimpan.

2. Klik Save changes untuk menerapkan pengaturan baru.

3. Klik Discard untuk memulihkan pengaturan yang terakhir disimpan.

   ✓ Halaman menampilkan Saving saat AVA memperbarui pengaturan. ✓ Pengeditan dinonaktifkan sementara selama penyimpanan. ✓ Pesan sukses mengonfirmasi pengaturan yang disimpan.

Konteks hotel

AVA memuat ulang pengaturan feedback saat Anda berpindah hotel. Selalu pastikan nama hotel sebelum menyimpan perubahan.

Tangani Permintaan Layanan Tamu

Tamu yang sedang menginap dan telah terverifikasi dapat menggunakan chat teks untuk meminta layanan yang dikonfigurasi hotel Anda. Jenis permintaan yang tersedia dapat mencakup amenitas, pembersihan, bagasi, panggilan bangun, masalah, masukan, dan layanan lainnya. Untuk permintaan yang sensitif terhadap tanggal, Agent (Pi) menggunakan tanggal, waktu, dan timezone hotel Anda saat ini. Timezone ini tetap digunakan meskipun perangkat tamu menggunakan timezone lain. Ini membantu tamu menggunakan frasa seperti “tujuh tiga puluh besok pagi.”

Tindakan tamu	Perilaku chat
Menanyakan layanan yang tersedia	Chat mencantumkan layanan yang diaktifkan untuk masa menginap terverifikasi
Meminta atau membatalkan layanan	Chat menampilkan pratinjau sebelum membuat atau membatalkan permintaan
Mengonfirmasi pratinjau	Permintaan dikirim hanya setelah pesan berikutnya yang menyatakan persetujuan jelas terhadap pratinjau yang tepat
Memeriksa permintaan	Chat menampilkan status permintaan yang dibuat dalam chat tersebut
Meminta item yang sudah aktif	Chat menjelaskan bahwa permintaan yang cocok sudah aktif
Meminta item baru dan item yang sudah aktif secara bersamaan	Chat menyebutkan permintaan baru dan item yang sudah aktif secara terpisah

Bantu tamu memilih layanan yang tersedia

Chat memeriksa permintaan amenitas, lain-lain, dan masalah terhadap katalog layanan hotel Anda. Jika tamu menggunakan nama persis salah satu entri katalog, chat mencocokkannya tanpa memerlukan kode. Pencocokan nama tidak membedakan huruf besar-kecil. Jika tamu melaporkan sesuatu yang rusak, bermasalah, atau tidak berfungsi, chat memperlakukannya sebagai permintaan masalah. Jika nama masalah pertama tidak tercantum, Live Chat mencoba lagi satu kali menggunakan nama masalah yang tersedia. Jika satu masalah cocok, chat menyiapkan nama persis yang tercantum. Jika tidak ada yang cocok, chat meminta tamu memilih dari masalah yang tercantum atau menjelaskan bahwa tidak ada yang cocok. Chat tidak menyiapkan nama masalah yang tidak tercantum. Jika permintaan tamu memerlukan klarifikasi, chat menampilkan layanan relevan yang tersedia berdasarkan nama. Jika satu layanan jelas sesuai, chat mencoba lagi dengan layanan tersebut. Jika beberapa layanan mungkin sesuai, chat meminta tamu memilih berdasarkan nama. Nama yang berulang diberi nomor, seperti “Hand Towel (1)” dan “Hand Towel (2)”. Tamu harus memilih nama bernomor tersebut saat entri duplikat muncul. Jika percobaan ulang tidak berhasil, chat menggunakan prompt pilihan yang sama ketika opsi tersedia.

Nama katalog voice langsung

Selama tindak lanjut voice langsung, assistant mempertahankan nama yang sudah ditampilkan kepada tamu. Nama masalah dan layanan lain-lain tetap terlihat, bukan berubah menjadi opsi bernomor kosong. Nama duplikat tetap menyertakan nomor agar tamu dapat memilih entri yang benar.

Tamu tidak perlu mengetahui kode atau pengenal layanan internal.

Pemeriksaan ini mencegah permintaan yang tidak valid diteruskan ke Housekeeping. Pastikan katalog layanan hotel Anda tetap mutakhir agar tamu melihat opsi yang akurat.

Yang dilihat tamu	Yang harus dilakukan
Satu layanan yang disarankan	Pastikan namanya sesuai dengan permintaan tamu
Beberapa nama layanan	Minta tamu memilih salah satu berdasarkan nama
Tidak ada nama layanan yang relevan	Tinjau katalog layanan dan tawarkan bantuan staf

Laporan kerusakan menggunakan nama masalah yang tercantum

Minta tamu memilih nama masalah yang ditampilkan chat ketika kata-kata mereka tidak cocok dengan katalog Anda. Tamu tidak perlu mengetahui kode masalah internal.

Nama layanan duplikat memerlukan klarifikasi

Jika beberapa entri katalog memiliki nama yang sama, chat menampilkan nama bernomor sesuai urutan katalog. Minta tamu memilih layanan bernomor yang sesuai dari nama-nama yang tersedia. Nama bersama tanpa nomor tetap ambigu, sehingga chat meminta tamu memilih.

Minta beberapa barang bagasi

Minta tamu menyertakan jumlah tas saat meminta pengambilan bagasi. AVA membawa jumlah tersebut ke pratinjau permintaan dan tugas bellboy yang dikirimkan.

Pesan tamu	Perilaku yang diharapkan
“Ambil dua tas dari kamar saya”	Pratinjau dan tugas menampilkan jumlah dua tas
“Ambil tas saya dari kamar saya”	Tinjau pratinjau dengan saksama sebelum mengonfirmasi permintaan

Minta tamu mengonfirmasi pratinjau lengkap setelah AVA mengidentifikasi jumlahnya.

Minta panggilan bangun

Minta tamu menyertakan waktu dan hari panggilan bangun jika memungkinkan. AVA menafsirkan tanggal relatif menggunakan timezone yang dikonfigurasi hotel.

Pesan tamu	Perilaku yang diharapkan
“Bangunkan saya pukul tujuh tiga puluh besok pagi”	AVA menyiapkan permintaan untuk hari kalender berikutnya di hotel
“Bangunkan saya pukul tujuh tiga puluh”	AVA menanyakan hari yang dimaksud tamu

Periksa timezone hotel sebelum menguji permintaan yang sensitif terhadap tanggal. Buka Settings → Essentials → Hotel Basic Details dan verifikasi Timezone.

Konfirmasi diperlukan

Chat tidak pernah membuat atau membatalkan permintaan layanan hanya dari pesan pertama. Satu pesan tamu tidak dapat sekaligus menyiapkan dan mengonfirmasi permintaan. Tamu harus mengonfirmasi pratinjau yang tepat dalam pesan berikutnya. Agent (Pi) menilai apakah pesan berikutnya benar-benar merupakan persetujuan, bukan mencocokkannya dengan frasa konfirmasi tetap. Pertanyaan, keraguan, koreksi, atau kata-kata yang tidak berkaitan tidak mengonfirmasi permintaan. Tamu tidak perlu memberikan pengenal permintaan yang telah disiapkan atau bidang internal lainnya. AVA mengikat konfirmasi ke pratinjau tertunda yang disimpan server. Jika balasan tamu tidak jelas, AVA membuang pratinjau tersebut sebelum bertanya lagi. Konfirmasi berikutnya tidak dapat mengirimkan pratinjau lama. AVA menyiapkan permintaan yang sama lagi, membacakannya, lalu meminta konfirmasi sekali lagi.

Konfirmasi dapat lebih lama saat layanan sibuk

AVA mencoba ulang konfirmasi ketika Housekeeping lambat atau jawaban pertama hilang. Tamu mungkin perlu menunggu sekitar 17 detik sebelum AVA melaporkan kegagalan. Percobaan ulang menggunakan detail permintaan yang sama, sehingga tidak membuat panggilan bangun duplikat. Minta tamu menunggu hasilnya alih-alih mengirimkan konfirmasi lain.

Jelaskan permintaan layanan yang sudah aktif

Chat memeriksa setiap item yang diminta terhadap permintaan aktif tamu. Chat tidak menggambarkan item yang sudah aktif sebagai permintaan yang gagal. Chat tidak membuat tugas lain untuk item tersebut.

Permintaan tamu	Yang didengar tamu
Hanya item yang sudah aktif	Item tersebut sudah aktif
Item baru dan item yang sudah aktif	Item mana yang baru diminta dan mana yang sudah aktif

Beri tahu tamu untuk menunggu permintaan yang sudah ada jika suatu item sudah aktif. Minta mereka menghubungi resepsionis jika permintaan aktif tersebut perlu diubah.

Tamu harus memiliki masa menginap saat ini yang terverifikasi dan nomor kamar. Tamu yang belum terverifikasi tetap dapat menanyakan pertanyaan umum tentang hotel, tetapi tidak dapat mengirimkan permintaan layanan. Setelah verifikasi reservasi, AVA mempertahankan bukti masa menginap terverifikasi untuk percakapan aktif. Tamu kemudian dapat melanjutkan permintaan layanan yang didukung tanpa memverifikasi reservasi lagi.

Jawab pertanyaan benefit tamu

Tamu terverifikasi dapat mengajukan pertanyaan melalui chat teks atau voice assistant tentang benefit yang termasuk. Contohnya adalah apakah sarapan termasuk, ketersediaan hari ini, dan tanggal tersedia berikutnya.

Assistant memeriksa masa menginap terverifikasi secara otomatis. Tamu tidak perlu memberikan pengenal reservasi atau kamar dalam pertanyaan mereka. Pastikan koneksi PMS, katalog benefit, dan penetapan rate plan Anda tetap mutakhir.

Pertanyaan tamu	Jawaban yang diharapkan
Apakah sarapan termasuk?	Termasuk atau tidak termasuk
Apakah saya dapat menggunakan sarapan hari ini?	Tersedia hari ini atau tidak tersedia hari ini
Kapan tersedia?	Tanggal tersedia berikutnya, jika diberikan

Penukaran benefit oleh staf tetap terpisah

Jawaban untuk tamu tidak menukarkan benefit. Staf tetap menggunakan Entitlements untuk memeriksa jatah dan mencatat penggunaan.

Uji Permintaan Layanan Tamu

1. Verifikasi tamu uji melalui kode QR kamar atau verifikasi reservasi.

2. Tanyakan layanan tamu yang tersedia.

3. Minta satu layanan yang diaktifkan.

4. Tinjau pratinjau dan konfirmasikan dalam pesan terpisah.

   ✓ Permintaan hanya muncul setelah tamu mengonfirmasi pratinjau yang tepat. ✓ Tamu mengonfirmasi permintaan yang ditampilkan tanpa memasukkan pengenal internal.

5. Uji nama layanan yang tidak didukung.

   ✓ Chat menampilkan layanan yang tersedia untuk masa menginap terverifikasi. ✓ Jika beberapa layanan mungkin sesuai, chat meminta tamu memilih berdasarkan nama. ✓ Chat tidak mengirimkan permintaan yang tidak valid ke Housekeeping.

6. Laporkan kerusakan menggunakan nama yang tidak ada dalam katalog masalah.

   ✓ Chat mencoba lagi satu kali dengan nama masalah yang tersedia. ✓ Masalah yang cocok menggunakan nama persis yang tercantum. ✓ Jika tidak ada masalah yang cocok, chat meminta tamu memilih atau menyatakan bahwa tidak ada yang cocok.

7. Beri balasan yang samar terhadap pratinjau, lalu konfirmasikan setelah chat bertanya lagi.

   ✓ Chat menyiapkan dan membacakan permintaan lagi sebelum menerima konfirmasi berikutnya.

Permintaan Layanan Tamu Tidak Muncul

Yang Anda lihat: Tamu terverifikasi meminta layanan, tetapi chat tidak dapat menawarkan alur permintaan.

Perbaikan:

1. Pastikan tamu sudah check-in dan memiliki kamar.
2. Pastikan tamu menyelesaikan verifikasi reservasi, atau menggunakan kode QR kamar yang benar.
3. Periksa bahwa layanan yang diminta diaktifkan untuk hotel.
4. Pastikan Answer Engine diatur ke Agent (Pi) saat menguji permintaan layanan.

Chat menyatakan layanan yang diminta tidak tersedia

Yang Anda lihat: Tamu menyebutkan suatu layanan, tetapi chat meminta mereka memilih dari layanan yang tersedia.

Perbaikan:

1. Minta tamu memilih salah satu layanan yang tersedia berdasarkan nama.
2. Periksa bahwa layanan tersebut diaktifkan di katalog layanan hotel Anda.
3. Pastikan tamu memiliki masa menginap saat ini yang terverifikasi dengan nomor kamar.
4. Coba lagi setelah katalog atau konfigurasi tamu diperbarui.
5. Hubungi support jika layanan yang diaktifkan tetap tidak tersedia.

Chat menolak laporan kerusakan tamu

Yang Anda lihat: Tamu melaporkan sesuatu yang rusak, tetapi chat langsung menolak.

Perbaikan:

1. Pastikan tamu memiliki masa menginap saat ini yang terverifikasi dengan nomor kamar.
2. Periksa bahwa masalah tersebut diaktifkan di katalog layanan hotel Anda.
3. Minta tamu menggunakan salah satu nama masalah yang tercantum.
4. Coba lagi dalam pesan baru jika respons pertama tidak menampilkan masalah yang tersedia.
5. Hubungi support jika chat masih menolak laporan kerusakan.

Chat meminta Anda menyiapkan permintaan lagi

Yang Anda lihat: Tamu menyetujui secara samar, lalu “ya” berikutnya tidak mengirimkan permintaan.

Perbaikan:

1. Biarkan chat menyiapkan dan membacakan permintaan lagi.
2. Minta tamu mengonfirmasi pratinjau lengkap yang tidak berubah.
3. Pertahankan nama layanan duplikat tetap berbeda dalam katalog hotel.
4. Hubungi support jika chat tidak menyiapkan permintaan lagi.

Permintaan panggilan bangun menanyakan tanggal

Yang Anda lihat: Tamu mengatakan “besok,” tetapi chat menanyakan hari yang dimaksud.

Perbaikan:

1. Verifikasi Timezone di Settings → Essentials → Hotel Basic Details.
2. Minta tamu memberikan hari dan waktu yang tepat.
3. Konfirmasikan pratinjau sebelum mengirimkan permintaan.

Panggilan bangun yang dikonfirmasi melaporkan kegagalan

Yang Anda lihat: Tamu mengonfirmasi panggilan bangun, tetapi chat melaporkan kegagalan.

Perbaikan:

1. Tunggu hingga respons konfirmasi selesai sebelum meminta tamu mencoba lagi.
2. Periksa Tasks atau Housekeeping untuk panggilan bangun tersebut.
3. Jangan membuat permintaan lain jika panggilan bangun asli sudah muncul.
4. Minta tamu mencoba lagi satu kali jika tidak ada permintaan yang muncul.
5. Hubungi support jika percobaan ulang juga gagal.

Reservasi Tertaut, tetapi Permintaan Layanan Tetap Tidak Tersedia

Yang Anda lihat: Tamu menautkan reservasi, tetapi chat yang sama tidak dapat menawarkan layanan tamu.

Perbaikan:

1. Minta tamu mengirim pesan baru dalam percakapan yang sama.
2. Pastikan reservasi sudah check-in dan memiliki nomor kamar.
3. Pastikan Answer Engine diatur ke Agent (Pi).
4. Mulai chat baru dan uji lagi jika masalah berlanjut.
5. Hubungi support jika tamu masih tidak dapat meminta layanan yang diaktifkan.

Atur Jam Live Chat

Gunakan jam live chat saat tamu hanya boleh menghubungi staf dalam jendela cakupan. Jadwal menggunakan timezone hotel Anda. Tamu melihat pesan away di luar jam buka. Anda dapat mengatur beberapa jendela untuk setiap hari kerja.

1. Buka tab Widget & Access.

2. Aktifkan Limit live chat to operating hours.

3. Periksa chip Timezone.

4. Jika salah, perbarui Timezone di Settings → Essentials → Hotel Basic Details.

5. Tambahkan periode buka untuk setiap hari kerja.

6. Gunakan Copy Mon → weekdays, Copy Mon → all days, Set 24/7, atau Clear all untuk mengisi lebih cepat.

7. Gunakan Open this day saat suatu hari tetap tutup.

8. Klik Save changes.

   ✓ Pill status menampilkan Open now atau Closed now. ✓ Tamu hanya bisa menghubungi staf saat jendela buka. ✓ Di luar jam tersebut, tamu melihat pesan away Anda. ✓ Balasan menggunakan jadwal terbaru. ✓ Waktu yang tidak valid ditandai border merah dan helper text.

Fallback jadwal aman

Jika data jadwal tidak lengkap atau formatnya tidak valid, Streamliner memuat jadwal fallback yang aman. Anda tetap dapat membuka halaman, meninjau editor, dan menyimpan jadwal yang telah diperbaiki.

Timezone hanya baca

Timezone pada halaman ini selalu sama dengan timezone hotel Anda. Gunakan tautan Change untuk membuka Settings → Essentials → Hotel Basic Details.

Buat Tautan Landing Page

1. Di Widget & Access, cari Landing Pages

2. Klik Create Landing Page

   ✓ Tautan baru muncul untuk akses tamu.

3. Gunakan View QR untuk melihat pratinjau kode tamu.

4. Klik Download chatbot QR jika Anda membutuhkan signage cetak untuk kamar atau area sambutan.

Sinkronkan nama landing page

Gunakan tindakan ini setelah Anda mengubah nama merchant. Tindakan ini memperbarui nama landing page chatbot agar sesuai dengan nama merchant saat ini. Halaman yang sudah ada tetap menggunakan page ID dan API key-nya sementara AVA memperbarui path URL-nya. Menghapus dan membuat ulang halaman juga menggunakan nama merchant saat ini.

1. Buka Communication Hub → Chatbot → Setup → Widget & Access.

2. Temukan landing page yang ingin Anda perbarui.

3. Klik Sync Url Name.

   ✓ Landing page menggunakan nama merchant Anda saat ini. ✓ Konten halaman dan API key tetap tersedia. ✓ Daftar landing page dimuat ulang, dan pratinjau QR yang terbuka ditutup.

4. Salin ulang tautan landing page jika URL yang ditampilkan berubah.

5. Ganti tanda QR yang dicetak jika masih menggunakan tautan lama.

Buat Kode QR Kamar yang Dicetak

Kode QR kamar yang dicetak membuka landing page chatbot bersama dan menyertakan kamar yang dipindai sebagai konteks. Jika tepat satu masa menginap aktif di dalam hotel cocok dengan kamar tersebut, AVA menautkan sesi chat ke masa menginap itu. Konteks masa menginap tertaut diperbarui sebelum tamu menggunakan chat teks, voice, atau fitur panggilan video. Jika tamu sudah memiliki percakapan, pemindaian ulang menambahkan konteks kamar terbaru ke percakapan tersebut. Pemindaian kamar terbaru menjadi prioritas saat kamar tamu berubah. AVA juga mencocokkan satu masa menginap native DUE_OUT jika kontrak kemampuan PMS Anda mendukung status tersebut. Jika tidak, pencarian QR kamar yang dicetak hanya mencocokkan masa menginap CHECKED_IN. AVA menggunakan nilai kamar persis seperti yang disandikan dalam kode QR. Jika AVA tidak dapat menemukan satu masa menginap aktif di dalam hotel yang unik, kamar tetap menjadi petunjuk yang belum terverifikasi. Tautan QR tetap tersedia jika CCI sementara tidak dapat menemukan masa menginap. Gelar tamu, seperti Mr atau Ms, dapat tetap berada dalam catatan PMS. AVA menggunakan nama depan dan nama belakang tamu saat menautkan sesi chat.

Akses kamar diperlukan

AVA memuat nomor kamar dari konfigurasi akses kamar Anda. Buat landing page chatbot terlebih dahulu.

1. Buka Widget & Access di Communication Hub → Chatbot → Setup.

2. Buat landing page jika Shared chatbot landing page tidak memiliki opsi.

3. Di Room QR Code, pilih landing page chatbot bersama.

4. Klik Generate.

   ✓ AVA membuat satu kode QR aktif untuk setiap kamar yang belum memiliki kode.

5. Pilih kamar, lalu klik Print selected.

   ✓ Jika tidak memilih kamar, AVA mencetak semua kode QR kamar aktif.

6. Cetak lembar tersebut dan letakkan setiap kode di kamar yang sesuai.

Kelola kode QR kamar yang dicetak

• Klik Print untuk mencetak satu kode kamar.
• Klik Regenerate setelah mengganti kode atau menduga kode tersebut telah dibagikan.
• Klik Disable saat kode yang dicetak harus berhenti berfungsi.
• Klik Enable untuk memulihkan kode yang dinonaktifkan.

Pembuatan ulang membatalkan kode lama

Cetak dan ganti tanda kamar segera setelah membuat ulang kode. Token QR sebelumnya berhenti berfungsi.

Buat Kode QR Lokasi yang Dicetak

Buat kode QR bernama untuk area bersama, seperti lobi atau kolam renang. Setiap kode membuka landing page chatbot bersama yang dipilih dengan konteks lokasi.

1. Buka Widget & Access di Communication Hub → Chatbot → Setup.

2. Buat landing page jika Shared chatbot landing page tidak memiliki opsi.

3. Di Location QR Code, pilih landing page chatbot bersama.

4. Masukkan Location name yang unik, seperti Main entrance.

5. Klik Add location.

   ✓ Lokasi baru muncul dalam daftar kode QR.

6. Pilih satu atau beberapa lokasi aktif, lalu klik Print selected.

7. Letakkan setiap kode yang dicetak di lokasi bernama tersebut.

Nama lokasi

Nama lokasi dapat berisi hingga 100 karakter. Nama dicocokkan tanpa membedakan huruf besar-kecil.

Kelola kode QR lokasi yang dicetak

• Klik Print untuk mencetak satu kode lokasi.
• Klik Regenerate setelah mengganti kode atau menduga kode tersebut telah dibagikan.
• Klik Disable saat kode yang dicetak harus berhenti berfungsi.
• Klik Enable untuk memulihkan kode yang dinonaktifkan.

Pembuatan ulang membatalkan kode lama

Cetak dan ganti tanda lokasi segera setelah membuat ulang kode. Token QR sebelumnya berhenti berfungsi.

Lindungi Privasi QR Lokasi

Kode QR lokasi memberikan konteks lokasi untuk bantuan tamu umum. Kode tersebut tidak pernah memverifikasi reservasi atau menautkan masa menginap ke sesi chat. Kode tersebut juga tidak meminta verifikasi reservasi, pencarian CCI, atau konteks masa menginap. Panggilan video dari sesi QR lokasi tidak menerima pengayaan berbasis reservasi.

Jenis QR	Perilaku reservasi dan masa menginap
Room QR	Dapat menautkan satu masa menginap CHECKED_IN yang unik, atau DUE_OUT native pada versi PMS yang didukung
Location QR	Hanya mempertahankan konteks lokasi dan tidak pernah menautkan reservasi

Tempatkan kode lokasi di area bersama

Gunakan kode QR lokasi di lobi, fasilitas, dan area bersama lainnya. Gunakan kode QR kamar hanya di tempat yang sesuai untuk penautan masa menginap khusus kamar.

Sesuaikan tata letak QR yang dicetak

Gunakan satu template untuk lembar cetak QR kamar dan lokasi. Kode QR tetap dapat dibaca dengan latar belakang putih di belakang kode.

Unggah latar belakang cetak

1. Di QR Print Template, klik Upload background image.

2. Pilih file PNG, JPG/JPEG, atau PDF satu halaman.

3. Pastikan ukuran file paling besar 10 MB.

   ✓ Template muncul di pratinjau.

File PDF harus memiliki satu halaman

AVA menolak file PDF yang tidak memiliki halaman atau memiliki beberapa halaman.

Posisikan bidang QR

1. Seret QR Code ke latar belakang, atau klik bidang tersebut lalu klik pratinjau.

2. Seret QR Label ke latar belakang jika Anda ingin menampilkan nama kamar atau lokasi.

3. Pilih bidang untuk mengedit nilai X, Y, Width, dan Height.

4. Pertahankan QR Code tetap persegi. AVA mengunci lebar dan tingginya pada rasio 1:1.

5. Untuk QR Label, atur ukuran font, warna teks, dan perataan.

6. Gunakan toggle pratinjau untuk memeriksa bidang template atau nilai cetak contoh.

7. Klik Save design.

   ✓ Tata letak diterapkan pada kode QR kamar dan lokasi yang dicetak.

QR Label berubah secara otomatis untuk setiap kamar atau lokasi. Hapus QR Print Template untuk memulihkan lembar cetak tiga-per-halaman default AVA.

Kelola Domain yang Diizinkan

1. Di Whitelisted Domains, masukkan domain seperti yourhotel.com
2. Klik Add Domain
3. Gunakan toggle untuk mengaktifkan atau menonaktifkan domain
4. Hapus domain hanya jika widget harus berhenti berfungsi di sana

Pemecahan Masalah

Chatbot Setup tidak ditemukan

Yang Anda lihat: Anda tidak dapat menemukan Chatbot → Setup di Communication Hub.

Perbaikan:

1. Pastikan paket Anda mencakup fitur Chatbot.
2. Minta administrator memberikan peran Anda izin chatbot_setup:manage.
3. Refresh AVA setelah akses Anda berubah.

Tautan langsung ke Chatbot Setup juga memerlukan izin ini.

Tombol Save dinonaktifkan

Yang Anda lihat: Anda tidak dapat menyimpan pesan atau instruksi.

Perbaikan:

1. Pastikan bidang tidak kosong
2. Hapus spasi ekstra lalu coba lagi
3. Pastikan paket Anda mencakup fitur Chatbot

Pengaturan lanjutan tidak tersimpan

Yang Anda lihat: Tombol Save tetap nonaktif atau menampilkan error validasi.

Perbaikan:

1. Tunggu hingga nilai lanjutan saat ini dimuat
2. Periksa setiap pesan validasi berwarna merah
3. Pertahankan Max Output Tokens antara 500 dan 3024
4. Pertahankan Retrieval K antara 1 dan 7
5. Jika Disable grounding RAG engine aktif, pertahankan Retrieval K antara 1 dan 3
6. Coba Save lagi

Kontrol RAG hilang

Yang Anda lihat: Anda tidak dapat menemukan Retrieval K atau Disable grounding RAG engine.

Perbaikan:

1. Buka Advanced Settings

2. Periksa Answer Engine yang aktif saat ini

3. Pilih RAG

4. Klik Save

   ✓ Kontrol khusus RAG akan muncul lagi.

Retrieval K terlihat terlalu rendah

Yang Anda lihat: Retrieval K hanya mengizinkan nilai dari 1 sampai 3.

Perbaikan:

1. Nonaktifkan Disable grounding RAG engine
2. Periksa ulang Retrieval K
3. Simpan pengaturan yang telah diperbarui

Skill Mode tidak tersimpan

Yang Anda lihat: Penyimpanan gagal setelah Anda mengaktifkan Use Skill Mode.

Perbaikan:

1. Pastikan Skill Name tidak kosong
2. Gunakan huruf kecil, angka, dan tanda hubung saja
3. Coba nama seperti booking-assistant
4. Klik Save lagi

Skill Mode tidak dapat menemukan skill

Yang Anda lihat: Skill tidak muncul setelah deployment.

Perbaikan:

1. Tunggu hingga deployment berikutnya selesai.
2. Pastikan nama paket skill sama dengan Skill Name.
3. Minta admin Anda memulai ulang Streamliner jika skill ditambahkan setelah startup.
4. Hubungi support jika skill masih tidak dimuat.

Chatbot masih menggunakan instruksi atau fallback sebelumnya

Yang Anda lihat: Balasan uji masih mengikuti instruksi atau jawaban fallback lama.

Perbaikan:

1. Pastikan notifikasi penyimpanan muncul.
2. Mulai chat baru dan uji lagi.
3. Tunggu sebentar jika balasan masih menggunakan pengaturan lama.
4. Hindari menguji dari sesi chat yang sudah ada.
5. Hubungi support jika chat baru masih menggunakan konfigurasi lama.

Agent (Pi) menampilkan error dari provider

Yang Anda lihat: Permintaan tamu menampilkan error provider Agent (Pi), bukan balasan.

Pesan ini dapat mengidentifikasi kegagalan provider dengan lebih jelas daripada error chatbot umum. Jika hotel Anda mengonfigurasi peringatan kegagalan Pi, AVA juga mengirimkan ringkasan Telegram kepada staf dukungan. Peringatan tersebut mencakup merchant, alasan, waktu, ID permintaan, dan ID percakapan. Peringatan tersebut tidak mencakup pesan tamu, prompt, kredensial, atau error provider mentah.

Perbaikan:

1. Simpan pesan error lengkap, termasuk detail provider atau permintaan apa pun.
2. Minta tamu mengirim permintaan itu sekali lagi.
3. Pastikan Answer Engine diatur ke Agent (Pi) hanya saat Anda memang mengharapkan perilaku Pi.
4. Periksa bahwa skill yang dipilih dan pengaturan chatbot masih tersimpan.
5. Hubungi support jika error provider muncul lagi.

Bagikan ID permintaan kepada support agar mereka dapat menemukan log layanan yang sesuai.

Jangan bagikan kredensial provider atau kunci API dalam permintaan dukungan.

Konfigurasi AI berubah saat menyimpan

Yang Anda lihat: Penyimpanan gagal dengan pesan "GenAI configuration changed while saving. Please retry."

Pesan ini dapat muncul pada catatan hotel lama yang tidak memiliki bidang Skill Mode terbaru. Setelah pembaruan layanan, konfigurasi lama tersebut dapat disimpan secara normal.

Perbaikan:

1. Tunggu sebentar jika penyimpanan lain masih diproses.
2. Muat ulang Communication Hub → Chatbot → Setup.
3. Pastikan nilai terbaru Anda masih ada.
4. Klik Save lagi.
5. Ulangi tindakan persiapan jika AVA meminta Anda menyiapkan konfigurasi lagi.
6. Hubungi support jika pesan tersebut terus muncul setelah percobaan ulang.

Perubahan bersamaan yang sebenarnya

AVA tetap menolak penyimpanan jika orang lain lebih dahulu mengubah konfigurasi. Muat ulang halaman, tinjau nilai terbaru, lalu simpan perubahan Anda lagi. Konfigurasi lama tidak memerlukan pengisian ulang database.

Verifikasi reservasi tidak menemukan masa menginap

Yang Anda lihat: Chatbot tidak dapat mencocokkan tamu dengan reservasi.

Perbaikan:

1. Pastikan tamu memasukkan nomor kamar yang benar.
2. Minta nama tamu utama pada reservasi.
3. Periksa bahwa tepat satu reservasi sudah check-in untuk kamar tersebut. Jika PMS Anda secara native mendukung DUE_OUT, masa menginap pada hari keberangkatan juga dapat cocok.
4. Jika beberapa masa menginap aktif berbagi kamar, minta staf front desk memperbaiki data PMS.
5. Ulangi alur verifikasi.

Jawaban benefit tamu tidak muncul atau ditolak

Yang Anda lihat: Tamu terverifikasi menanyakan benefit, tetapi assistant menolak atau tidak dapat menjawab.

Jika tamu tidak memiliki benefit, assistant seharusnya mengatakan bahwa benefit tersebut tidak termasuk. Jawaban itu diharapkan ketika Entitlements mengembalikan hasil kosong.

Perbaikan:

1. Pastikan tamu memiliki masa menginap saat ini yang terverifikasi.
2. Pastikan koneksi PMS aktif.
3. Pastikan benefit ditetapkan ke rate plan tamu.
4. Periksa Entitlements untuk reservasi yang sama.
5. Minta tamu mengirimkan pertanyaan tersebut lagi.

Jika Entitlements tidak menampilkan benefit, assistant seharusnya mengatakan bahwa benefit tersebut tidak termasuk. Jika assistant menolak menjawab, hubungi support dengan detail percakapan.

Pratinjau verifikasi masih menampilkan chat biasa

Yang Anda lihat: Pratinjau widget tidak menampilkan formulir identifikasi.

Perbaikan:

1. Buka Widget & Access.
2. Aktifkan Guest reservation verification.
3. Klik Save.
4. Refresh panel pratinjau.
5. Pastikan mode pratinjau tidak menyembunyikan layar verifikasi.

Verifikasi berhasil sekali, lalu gagal lagi

Yang Anda lihat: Tamu berhasil diverifikasi, lalu gagal saat pemeriksaan berikutnya.

Perbaikan:

1. Minta tamu menggunakan nomor kamar dan nama tamu yang sama lagi.
2. Pastikan tamu masih menggunakan reservasi yang sama.
3. Mulai chat baru jika tamu berganti reservasi.
4. Refresh percakapan lalu ulangi.

Landing page tidak dapat dibuat

Yang Anda lihat: Anda mendapat error saat membuat landing page.

Perbaikan:

1. Refresh halaman dan coba lagi
2. Ikuti prompt apa pun untuk mengganti halaman lama
3. Hubungi support jika masih gagal

Nama landing page sudah usang

Yang Anda lihat: Landing page chatbot masih menampilkan nama merchant lama Anda.

Perbaikan:

1. Buka Communication Hub → Chatbot → Setup → Widget & Access.
2. Pastikan Anda melihat hotel yang benar.
3. Klik Sync Url Name untuk landing page yang terdampak.
4. Muat ulang daftar landing page.
5. Salin ulang tautan dan ganti tanda QR yang dicetak jika diperlukan.
6. Hubungi support jika nama tetap tidak berubah.

Kode QR kamar tidak dapat dibuat

Yang Anda lihat: Generate tetap dinonaktifkan, atau AVA tidak dapat memuat kamar.

Perbaikan:

1. Buat setidaknya satu landing page chatbot.
2. Pastikan akses kamar telah dikonfigurasi untuk hotel.
3. Refresh Communication Hub → Chatbot → Setup.
4. Pilih landing page, lalu klik Generate lagi.

Kode QR lokasi tidak dapat dibuat

Yang Anda lihat: Add location tetap dinonaktifkan, atau penyimpanan gagal.

Perbaikan:

1. Buat setidaknya satu landing page chatbot.

2. Pilih landing page di Location QR Code.

3. Masukkan nama lokasi antara 1 dan 100 karakter.

4. Pastikan tidak ada lokasi lain yang menggunakan nama sama.

5. Klik Add location lagi.

   ✓ Nama yang hanya berbeda dalam penggunaan huruf besar-kecil tetap dihitung sebagai duplikat.

Kode QR lokasi tidak tersedia

Yang Anda lihat: Tamu memindai kode lokasi, tetapi chat tidak terbuka.

Perbaikan:

1. Buka Location QR Code di Communication Hub → Chatbot → Setup.
2. Periksa apakah kode dinonaktifkan.
3. Klik Enable, atau klik Regenerate dan cetak pengganti.
4. Pastikan landing page yang dipilih masih ada.

Kode QR kamar yang dicetak tidak lagi berfungsi

Yang Anda lihat: Tamu memindai kode kamar, tetapi chatbot tidak terbuka.

Perbaikan:

1. Buka Room QR Code di Communication Hub → Chatbot → Setup.
2. Periksa apakah kode dinonaktifkan.
3. Klik Enable, atau klik Regenerate dan cetak pengganti.
4. Pastikan landing page masih ada.

Pengunggahan template cetak QR gagal

Yang Anda lihat: AVA menolak file latar belakang atau menampilkan error pengunggahan.

Perbaikan:

1. Gunakan file PNG, JPG/JPEG, atau PDF.
2. Pastikan ukuran file paling besar 10 MB.
3. Jika menggunakan PDF, hapus halaman tambahan dan unggah satu halaman saja.
4. Refresh Communication Hub → Chatbot → Setup, lalu unggah file lagi.

Desain cetak QR tidak tersimpan

Yang Anda lihat: Save design gagal, atau posisi Anda hilang setelah refresh.

Perbaikan:

1. Pastikan pratinjau latar belakang masih dimuat.
2. Tempatkan bidang QR Code yang diperlukan di pratinjau.
3. Pertahankan lebar dan tinggi QR Code tetap sama.
4. Klik Save design lagi.

Lembar QR yang dicetak menggunakan tata letak default

Yang Anda lihat: Lembar cetak menggunakan tata letak standar tiga-per-halaman AVA.

Perbaikan:

1. Kembali ke Communication Hub → Chatbot → Setup → Widget & Access.
2. Pastikan QR Print Template masih menampilkan latar belakang yang disimpan.
3. Jika template hilang, unggah lagi lalu klik Save design.
4. Cetak ulang kode QR setelah template muncul.

Registrasi QR kamar gagal

Yang Anda lihat: Tamu memindai kode QR kamar, tetapi registrasi gagal. Anda mungkin melihat error yang menyebutkan guest.property title should not exist.

Perbaikan:

1. Minta tamu me-refresh landing page QR.
2. Minta tamu memindai lagi kode QR kamar.
3. Pastikan masa menginap tamu berstatus CHECKED_IN. Masa menginap DUE_OUT hanya cocok jika PMS Anda secara native mendukung status tersebut.
4. Pastikan nilai kamar yang disandikan sama persis dengan nilai kamar di PMS.
5. Pastikan tepat satu masa menginap aktif cocok dengan kamar tersebut.
6. Biarkan gelar tamu tetap dalam catatan PMS; Anda tidak perlu menghapusnya.
7. Gunakan verifikasi tamu manual jika pencarian QR masih gagal.
8. Hubungi support jika registrasi masih gagal.

Toggle domain tidak berfungsi

Yang Anda lihat: Switch berubah tetapi kembali lagi.

Perbaikan:

1. Refresh halaman
2. Hapus domain lalu tambahkan lagi
3. Coba toggle sekali lagi

Tamu melihat pesan away di luar jam

Yang Anda lihat: Tamu mendapat pesan away pada waktu yang Anda harapkan untuk menerima balasan langsung.

Perbaikan:

1. Buka Widget & Access.
2. Periksa Limit live chat to operating hours.
3. Pastikan hari ini sedang terbuka.
4. Periksa apakah chip Timezone cocok dengan Settings → Essentials → Hotel Basic Details.
5. Simpan lagi setelah perubahan apa pun.
6. Jika jadwal baru saja berubah, refresh widget dan tunggu transisi berikutnya.

Pengaturan feedback tidak dapat disimpan

Yang Anda lihat: Save changes tetap nonaktif, atau AVA menolak pengaturan tersebut.

Perbaikan:

1. Masukkan Rating question.
2. Masukkan Follow-up question.
3. Atur kedua bidang penundaan antara 1 dan 60 menit.
4. Pastikan akun Anda memiliki izin chatbot_setup:manage.
5. Klik Save changes lagi.

Pengaturan feedback tidak dimuat

Yang Anda lihat: Halaman menampilkan error, bukan kontrol feedback.

Perbaikan:

1. Pastikan paket Anda mencakup fitur Chatbot.
2. Pastikan peran Anda memiliki izin chatbot_setup:manage.
3. Klik Try again.
4. Refresh AVA setelah berpindah hotel.
5. Hubungi support jika halaman masih tidak dapat dimuat.

Discard tidak memulihkan perubahan saya

Yang Anda lihat: Pratinjau atau bidang masih menampilkan nilai yang belum disimpan.

Perbaikan:

1. Tunggu hingga halaman selesai dimuat.
2. Pastikan AVA tidak menampilkan Saving.
3. Klik Discard lagi.
4. Refresh halaman jika konteks hotel baru saja berubah.
5. Hubungi support jika nilai yang tersimpan tetap salah.

Tamu tidak melihat prompt feedback

Yang Anda lihat: Widget tidak menampilkan tindak lanjut atau rating.

Perbaikan:

1. Buka Communication Hub → Chatbot → Feedback Settings.
2. Pastikan Ask when a guest goes quiet atau Ask when staff closes a live chat aktif.
3. Pastikan tamu menggunakan widget chat situs web.
4. Untuk feedback idle, tunggu hingga kedua penundaan yang dikonfigurasi selesai.
5. Minta tamu mengirim pesan baru jika percakapan berubah.

Masih Terkendala?

Hubungi success@vouch-technologies.com jika:

• ❌ Verifikasi reservasi masih gagal setelah Anda memastikan nomor kamar dan nama tamu
• ❌ Landing page tidak dibuat
• ❌ Masalah berlangsung lebih dari 30 menit

Sebaiknya sertakan:

• Screenshot halaman Communication Hub → Chatbot → Setup atau percakapan
• Tindakan yang Anda coba dan pesan error
• Nomor kamar dan nama tamu, jika verifikasi gagal
• Waktu masalah mulai terjadi

Panduan Terkait

• Atur Gaya Widget Chatbot
• Buat Tautan Live Chat untuk Tamu
• Kelola Tiket Live Chat