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 ini saat Anda perlu menjaga jawaban tamu tetap konsisten dan menangani pertanyaan di luar jam operasional.

Buka: Chatbot → Setup

---

Referensi Cepat

Tugas	Klik di mana	Hasil
Atur welcome message	Bot Configuration → Welcome Message	Tamu melihat sapaan Anda terlebih dahulu
Atur fallback reply	Bot Configuration → Default Answer	Tamu mendapat respons saat tidak ada kecocokan
Tentukan nada bot	Bot Configuration → Bot Instruction	Chatbot mengikuti arahan Anda
Pilih answer engine	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	Memakai skill Vertex ADK yang Anda konfigurasi untuk balasan GenAI yang di-stream
Jalankan Quick Setup	Quick Setup	Mengisi pesan dan tone otomatis
Pilih mode chat	Widget & Access → Chat mode	AI, live chat, atau hybrid
Atur jam live chat	Widget & Access → Operating Hours	Staf membalas hanya pada jam buka
Buat landing page	Widget & Access → Create Landing Page	Tautan tamu dan opsi QR muncul
Izinkan domain widget	Widget & Access → Whitelisted Domains	Widget dimuat di situs Anda

Akses Paket

• Penyiapan chatbot memerlukan paket berbayar.
• Akun 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 fallback reply 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. Klik Save

   ✓ Instruksi tersimpan dan digunakan oleh chatbot.

Contoh instruction yang baik

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

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 memakai dokumen chatbot dan pengaturan retrieval Anda. Agent (Pi) menyembunyikan kontrol khusus RAG di modal. Mengaktifkan Disable grounding RAG engine melakukan prefetch konteks langsung sebelum menjawab. Ini memakai 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.

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.

Gunakan Quick Setup (Opsional)

1. Klik Quick Setup di header halaman
2. Ikuti wizard untuk menghasilkan pesan dan tone
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.

Atur Jam Live Chat

Gunakan jam live chat saat tamu hanya boleh menghubungi staf dalam jam cakupan. Jadwal memakai timezone hotel Anda. Tamu melihat pesan away di luar jam buka. Anda bisa 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 jam buka. ✓ Di luar jam tersebut, tamu melihat pesan away Anda. ✓ Balasan memakai jadwal terbaru. ✓ Waktu yang tidak valid ditandai border merah dan helper text.

Fallback jadwal aman

Jika data jadwal tidak lengkap atau rusak, Streamliner memuat jadwal fallback yang aman. Anda tetap bisa membuka halaman, meninjau editor, dan menyimpan jadwal yang sudah diperbaiki.

Timezone hanya baca

Timezone pada halaman ini selalu cocok 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.

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 memang harus berhenti berfungsi di sana

Pemecahan Masalah

Tombol Save dinonaktifkan

Yang Anda lihat: Anda tidak bisa menyimpan pesan atau instruction.

Perbaikan:

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

Advanced settings tidak tersimpan

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

Perbaikan:

1. Tunggu hingga nilai advanced saat ini dimuat
2. Periksa setiap pesan validasi berwarna merah
3. Jaga Max Output Tokens antara 500 dan 3024
4. Jaga Retrieval K antara 1 dan 7
5. Jika Disable grounding RAG engine aktif, jaga 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. Matikan Disable grounding RAG engine
2. Periksa ulang Retrieval K
3. Simpan pengaturan yang sudah 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

Landing page tidak bisa 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 yang lebih lama
3. Hubungi support jika 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 balasan live.

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:

• ❌ Save gagal setelah beberapa kali percobaan
• ❌ Landing page tidak berhasil dibuat
• ❌ Masalah berlangsung lebih dari 30 menit

Sebaiknya disertakan:

• Screenshot halaman Chatbot Setup
• Tindakan yang Anda coba dan pesan error
• Waktu masalah mulai terjadi

Panduan Terkait

• Gaya Widget Chatbot
• Buat Tautan Live Chat untuk Tamu
• Kelola Dokumen Chatbot