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, akses, dan jam live chat. Gunakan panduan ini saat Anda memerlukan jawaban tamu yang konsisten dan penanganan di luar jam operasional.

Buka: 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	Tamu mendapat respons saat tidak ada kecocokan
Tentukan nada bot	Bot Configuration → Bot Instruction	Chatbot mengikuti arahan 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 Vertex ADK yang dikonfigurasi untuk balasan GenAI 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	Widget & Access → Operating Hours	Staf membalas hanya selama jendela buka
Buat landing page	Widget & Access → Create Landing Page	Tautan tamu dan opsi QR muncul
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.
• 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 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 akan muncul.

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 dan digunakan oleh chatbot.

Contoh instruction 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.

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. Pengaturan ini memengaruhi balasan chatbot dan alur voice yang terhubung.

Gunakan Skill Mode

Gunakan Skill Mode saat setup GenAI Anda harus men-stream respons melalui Vertex ADK. Streamliner menyinkronkan skill yang terpasang saat service 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). AVA tetap menggunakan skill Vertex ADK Anda di belakang layar.

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. Field ini wajib diisi saat Use Skill Mode aktif. Vertex ADK menjalankan skill 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.

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.

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.

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 konfirmasi jelas berikutnya; tamu tidak perlu mengisi bidang permintaan internal
Memeriksa permintaan	Chat menampilkan status permintaan yang dibuat dalam chat tersebut

Konfirmasi diperlukan

Chat tidak pernah membuat atau membatalkan permintaan layanan hanya dari pesan pertama. Tamu harus mengonfirmasi pratinjau yang tepat dalam pesan berikutnya. Tamu tidak perlu memberikan pengenal permintaan yang telah disiapkan atau bidang internal lainnya. AVA mengikat konfirmasi ke pratinjau tertunda yang disimpan server.

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

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.

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.

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.

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 atau fitur voice. 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 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 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

Tombol Save dinonaktifkan

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

Perbaikan:

1. Pastikan field 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.

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.

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

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 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 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 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 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 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.

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 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