Menyiapkan Phone AI untuk Panggilan Masuk

Penyiapan Cepat

Hubungkan satu nomor Twilio, uji webhook-nya, lalu aktifkan Phone AI. Proses ini biasanya memerlukan waktu sekitar 10 menit.

Panduan ini membantu Anda menjawab panggilan masuk hotel dengan AVA dan meninjau transkrip setiap panggilan.

Buka: Settings → Communications → Phone AI

Aktivasi khusus hotel

Pengaturan Phone AI berlaku untuk hotel yang dipilih. Setiap hotel memerlukan nomor Twilio sendiri, kredensial tersimpan, dan aktivasi.

Referensi Cepat

Pengaturan	Yang Dikendalikan	Yang Anda Lihat
Twilio Account SID	Memilih akun Twilio	Pengenal yang diawali AC
Twilio phone number	Menerima panggilan tamu	Nomor dengan + dan kode negara
Twilio Auth Token	Mengizinkan AVA memverifikasi dan menangani panggilan	Rahasia terlindungi yang tidak pernah ditampilkan lagi
Purpose	Mencatat catatan opsional untuk nomor ini	Deskripsi Anda di halaman penyiapan
Incoming-call webhook	Merutekan panggilan dari Twilio ke AVA	URL yang dapat disalin dan tindakan Test webhook
Sakelar Phone AI	Mengaktifkan atau menjeda penanganan panggilan AI	Active atau Not active
Call Activity	Mencantumkan panggilan dan statusnya	Nomor penelepon, waktu mulai, status, dan transkrip

Sebelum Memulai

Pastikan persyaratan berikut terpenuhi:

• Anda memiliki akses Settings read untuk meninjau aktivitas Phone AI
• Anda memiliki akses Settings write untuk mengonfigurasi Phone AI
• Anda memiliki nomor telepon Twilio khusus
• Anda memiliki Account SID dan Auth Token Twilio
• Nomor telepon ditulis dalam format E.164

Memeriksa Izin Settings

Izin Anda menentukan tindakan Phone AI yang dapat digunakan:

Izin	Tindakan yang tersedia
Settings read	Membuka Phone AI serta meninjau Call Activity dan transkrip
Settings write	Menyimpan pengaturan, menguji webhook, dan mengaktifkan Phone AI

Minta administrator memperbarui peran Anda jika suatu tindakan tidak tersedia.

Persyaratan deployment

Twilio harus dapat menjangkau AVA melalui alamat HTTPS publik yang mendukung koneksi WebSocket. Minta administrator AVA mengonfirmasi persyaratan ini untuk deployment pribadi atau terbatas.

Memverifikasi URL Phone AI Publik

AVA membuat URL webhook Twilio dan URL aliran media dari alamat Core publik.

Lingkungan	Perilaku URL	Hal yang perlu diperiksa
Produksi	Menggunakan VOUCH_CORE_URL HTTPS publik	URL menyertakan /core jika deployment Anda menggunakan awalan tersebut
Docker lokal	Menggunakan alamat SERVICE_HOME publik dan PUBLIC_PATH	Alamat mengarah ke tunnel ngrok publik Anda

URL aliran media

AVA membuat URL aliran media wss:// yang aman secara otomatis. Anda hanya perlu mengonfigurasi webhook panggilan masuk yang disalin di Twilio. Jangan menambahkan parameter kueri ke URL aliran media yang dibuat.

Minta administrator deployment memperbaiki nilai-nilai ini jika webhook yang disalin menggunakan hostname internal.

Menghubungkan Layanan Phone AI

Minta tim deployment menyelesaikan pemeriksaan berikut sebelum mengaktifkan Phone AI:

• Jaga agar rute realtime Core-ke-Chat tetap privat. Rute ini hanya untuk lalu lintas layanan internal.
• Atur INTER_SERVICE_SECRET di Chat Microservice agar sesuai dengan CHAT_MICROSERVICE_SECRET milik Core.
• Deploy Chat Microservice sebelum Core. Streamliner dapat menyusul setelah Core aktif.
• Jika diperlukan, lakukan rollback dalam urutan terbalik: Streamliner, Core, lalu Chat Microservice.

Jaga rute realtime tetap privat

Jangan mengekspos rute realtime internal ke internet publik. Twilio harus terhubung melalui webhook AVA publik, bukan langsung ke Chat Microservice.

Lindungi Auth Token

Perlakukan Twilio Auth Token seperti kata sandi. AVA melindunginya setelah disimpan dan tidak pernah menampilkannya lagi.

Menyimpan Koneksi Twilio

1. Buka Settings → Communications → Phone AI.

2. Tetap di Setup.

3. Masukkan Twilio Account SID.

4. Masukkan Twilio phone number dengan + dan kode negara.

5. Masukkan Twilio Auth Token.

6. Tambahkan Purpose opsional.

7. Klik Save settings.

   ✓ Anda akan melihat "Phone AI settings saved." ✓ Kolom Auth Token berubah menjadi placeholder terlindungi.

Mengganti token

Biarkan Auth Token kosong untuk mempertahankan token yang tersimpan. Masukkan token baru hanya jika Anda perlu menggantinya.

Merutekan Panggilan Masuk dari Twilio

1. Di Setup, cari Incoming-call webhook.

2. Klik Copy.

3. Buka Twilio Console.

4. Buka Phone Numbers dan pilih nomor hotel.

5. Di bagian Voice configuration, atur A call comes in ke Webhook.

6. Tempel URL yang disalin.

7. Pilih POST, lalu simpan konfigurasi Twilio.

   ✓ Twilio kini mengirimkan panggilan masuk ke webhook AVA.

Validasi webhook

AVA memeriksa permintaan Twilio dan nomor telepon yang dikonfigurasi sebelum menerima panggilan. Gunakan nomor yang persis sama dengan yang disimpan di AVA saat mengonfigurasi Twilio.

Menguji dan Mengaktifkan Phone AI

1. Kembali ke Settings → Communications → Phone AI.

2. Simpan perubahan yang belum disimpan.

3. Klik Test webhook.

4. Konfirmasikan pesan berhasil.

5. Aktifkan Enable Phone AI.

6. Klik Save settings.

7. Hubungi nomor Twilio dari telepon lain.

   ✓ Phone AI menjawab panggilan masuk. ✓ Setelah panggilan berakhir, panggilan muncul di Call Activity dengan status tersimpannya. ✓ Pilih View transcript untuk meninjau pesan penelepon dan AI yang tersimpan.

Persyaratan aktivasi

Anda harus menyimpan Account SID, nomor telepon, dan Auth Token sebelum aktivasi. Pengujian webhook juga tetap dinonaktifkan selama ada perubahan yang belum disimpan.

Meninjau Aktivitas Panggilan

1. Buka Call Activity.

2. Cari panggilan berdasarkan nomor penelepon dan waktu mulai.

3. Tinjau status panggilan.

4. Klik View transcript.

5. Tutup transkrip setelah selesai.

   ✓ Anda dapat meninjau pesan penelepon dan asisten untuk panggilan tersebut.

Penyegaran aktivitas

Call Activity dimuat saat halaman dibuka. Buka kembali atau muat ulang halaman setelah panggilan baru berakhir.

Menangani Permintaan Layanan Tamu

Phone AI dapat menjawab pertanyaan umum tentang hotel selama panggilan. Tindakan layanan tamu yang didukung memerlukan transkrip panggilan yang andal dan konfirmasi tamu yang jelas.

Permintaan tamu	Perilaku Phone AI
Mengajukan pertanyaan umum tentang hotel	Menjawab menggunakan informasi hotel yang tersedia
Meminta, membatalkan, atau mengubah layanan tamu	Menerima konfirmasi yang jelas, termasuk “I confirm” atau “I confirm it”
Meminta tindakan tanpa transkrip yang dapat digunakan	Mengarahkan tamu ke resepsionis

Tidak ada tindakan yang dikirim tanpa konfirmasi

Jika transkripsi tidak tersedia, Phone AI tidak mengirim, membatalkan, atau mengubah permintaan layanan tamu. Sebagai gantinya, tamu diarahkan ke resepsionis. Phone AI menolak konfirmasi yang mengubah permintaan yang telah disiapkan.

Beri tahu tamu untuk menghubungi resepsionis ketika mereka memerlukan tindakan diselesaikan selama panggilan tanpa transkripsi.

Pemecahan Masalah

Nomor telepon ditolak

Yang terlihat: "Enter the Twilio phone number in E.164 format, including + and country code."

Perbaikan:

1. Awali nomor dengan +.
2. Tambahkan kode negara.
3. Hapus spasi, tanda kurung, dan tanda hubung.
4. Klik Save settings lagi.

Pengujian webhook dinonaktifkan

Yang terlihat: Anda tidak dapat memilih Test webhook.

Perbaikan:

1. Lengkapi Account SID, nomor telepon, dan Auth Token.
2. Klik Save settings.
3. Tunggu konfirmasi penyimpanan.
4. Klik Test webhook lagi.

Pengujian webhook gagal

Yang terlihat: "Unable to verify the Twilio webhook configuration."

Perbaikan:

1. Salin kembali Incoming-call webhook saat ini.
2. Pastikan Twilio menggunakan URL tersebut untuk A call comes in.
3. Pastikan metodenya POST.
4. Simpan di Twilio, lalu uji lagi di AVA.

Webhook yang disalin menggunakan URL internal

Yang terlihat: URL yang disalin berisi hostname internal atau diawali http://.

Perbaikan:

1. Minta administrator deployment mengatur VOUCH_CORE_URL produksi ke alamat Core HTTPS publik.

2. Pastikan nilainya menyertakan /core jika deployment publik Anda menggunakan awalan tersebut.

3. Untuk Docker lokal, pastikan alamat ngrok publik dikonfigurasi melalui SERVICE_HOME dan PUBLIC_PATH.

4. Buka kembali Settings → Communications → Phone AI.

5. Salin kembali Incoming-call webhook, lalu perbarui Twilio.

   ✓ Webhook yang disalin diawali https:// dan menggunakan alamat publik.

Panggilan tidak muncul di Call Activity

Yang terlihat: Panggilan uji berakhir, tetapi tidak ada panggilan yang muncul untuk hotel yang dipilih.

Perbaikan:

1. Pastikan Anda memilih hotel tempat Phone AI aktif.
2. Pastikan nomor Twilio sama persis dengan Twilio phone number.
3. Buka kembali atau muat ulang halaman Phone AI setelah panggilan berakhir.
4. Jalankan kembali Test webhook setelah menyimpan pengaturan.
5. Minta administrator AVA mengonfirmasi bahwa alamat HTTPS publik mendukung koneksi WebSocket.

Phone AI tidak dapat diaktifkan

Yang terlihat: Tombol Enable Phone AI tetap dinonaktifkan.

Perbaikan:

1. Pastikan Anda memiliki akses Settings write.
2. Simpan semua pengaturan Twilio yang diperlukan.
3. Periksa apakah nomor telepon menyertakan + dan kode negara.
4. Muat ulang halaman dan coba lagi.

Transkrip tidak dapat dibuka

Yang terlihat: "Unable to load this transcript."

Perbaikan:

1. Tutup panel transkrip.
2. Muat ulang Call Activity.
3. Buka kembali panggilan tersebut.
4. Hubungi dukungan jika transkrip lain juga gagal.

Panggilan tidak memiliki transkrip

Yang terlihat: "No transcript was saved for this call."

Perbaikan:

1. Periksa panggilan lain yang telah selesai di Call Activity.

2. Lanjutkan menggunakan Phone AI untuk pertanyaan umum tentang hotel.

3. Beri tahu tamu untuk menghubungi resepsionis jika memiliki permintaan, pembatalan, atau perubahan.

4. Hubungi administrator AVA jika deployment Anda seharusnya menyimpan transkrip panggilan.

   ✓ Phone AI dapat terus menjawab pertanyaan tanpa transkrip yang tersimpan. ✓ Tindakan tamu yang memerlukan konfirmasi akan dialihkan ke resepsionis.

Masih Mengalami Masalah?

Hubungi success@vouch-technologies.com jika:

• ❌ Webhook yang tersimpan terus gagal diuji
• ❌ Panggilan tidak muncul di Call Activity
• ❌ Phone AI tidak menjawab setelah diaktifkan

Sebaiknya sertakan:

• Tangkapan layar status penyiapan tanpa nilai rahasia
• Nomor telepon Twilio
• Waktu salah satu panggilan uji
• Pesan kesalahan yang persis

Panduan Terkait

• Menyiapkan Prompt Asisten Suara
• Menyiapkan Panggilan Video
• Menyiapkan Chatbot