Komponen bawaan pengumpulan nomor telepon

Komponen bawaan ini mengambil dan memvalidasi kode negara dan nomor telepon.

Batasan

Selain batasan komponen bawaan umum, komponen bawaan ini memiliki batasan berikut:

• Nomor telepon yang panjangnya lebih dari 16 digit tidak diterima.

Setelan agen yang direkomendasikan

Aktifkan DTMF untuk memungkinkan pengguna memasukkan nilai numerik menggunakan keypad telepon.

Fitur tambahan

Fungsi tambahan berikut disediakan oleh komponen bawaan ini:

• Ulangi
• Ruang tunggu
• Pemutaran

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Contoh dialog menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.

Nomor telepon yang valid dalam dua putaran

Pengguna akhir memberikan kode negara terlebih dahulu, diikuti dengan nomor telepon; agen berhasil memvalidasi dan menerimanya.

Input pengguna	Respons agen
	Apa nama atau kode negara Anda?
+1
	Kami mengerti, kode negara Anda adalah plus 1. Sebutkan nomor telepon Anda.
6502530000
	Oke. Nomor yang Anda sebutkan adalah [phone], benar?
Ya, sudah benar
	Bagus, saya sudah selesai mengumpulkan nomor telepon.

Nomor telepon yang valid dalam satu belokan

Pengguna akhir memberikan kode negara dan nomor telepon secara bersamaan, agen berhasil memvalidasi dan menerimanya.

Input pengguna	Respons agen
	Apa nama atau kode negara Anda?
[phone]
	Oke. Nomor yang Anda sebutkan adalah [phone], benar?
Ya, sudah benar
	Bagus, saya sudah selesai mengumpulkan nomor telepon.

Nomor telepon tidak valid

Pengguna akhir memberikan kode negara dan nomor telepon dalam satu giliran; agen memeriksa dan menemukan bahwa nomor telepon yang diberikan memiliki panjang yang valid (dalam 16 digit), tetapi bukan nomor telepon yang valid. Kemudian, agen meminta kembali pengguna akhir untuk memberikan nomor telepon.

Input pengguna	Respons agen
	Apa nama atau kode negara Anda?
[phone]
	Maaf, nomor telepon ini tidak dapat dikenali. Saya telah mengumpulkan kode negara sebagai plus 1. Harap berikan nomor telepon yang valid.
6502530000
	Oke. Nomor yang Anda sebutkan adalah [phone], benar?
Ya, sudah benar
	Bagus, saya sudah selesai mengumpulkan nomor telepon.

Kode negara dan nomor telepon tidak valid

Pengguna akhir memberikan kode negara dan nomor telepon dalam satu giliran; agen memeriksa dan mendapati bahwa kode negara dan nomor telepon yang diberikan tidak valid. Agen kemudian meminta ulang pengguna akhir untuk memberikan kode negara dan nomor telepon.

Input pengguna	Respons agen
	Apa nama atau kode negara Anda?
+0080000000000
	Maaf, sepertinya kode negara atau nomor telepon yang diberikan tidak valid. Mari kita mulai lagi. Ucapkan nama atau kode negara Anda.
1
	Kami mengerti, kode negara Anda adalah plus 1 . Berapa nomor telepon Anda?
6502530000
	Oke. Nomor yang Anda sebutkan adalah [phone], benar?
Ya, sudah benar
	Bagus, saya sudah selesai mengumpulkan nomor telepon.

Input tidak dikenal

Komponen keluar dari alur setelah pengguna akhir memberikan input yang tidak dikenal tiga kali.

Input pengguna	Respons agen
	Apa nama atau kode negara Anda?
Tidak apa-apa
	Maaf, saya tidak mengerti. Bisa ucapkan atau masukkan kode negara lagi?
bagus
	Hmm, saya masih belum bisa mendapatkannya. Pastikan Anda mengucapkan kode negara. Jika saya mengalami masalah saat mendengar Anda, Anda juga dapat menggunakan keypad untuk memasukkan kode negara.
good
	Maaf, saya kesulitan memahami respons Anda.

Validasi nomor telepon

Komponen bawaan nomor telepon menggunakan fungsi sistem IS_PHONE_NUMBER untuk memvalidasi bahwa nomor telepon cocok dengan pola yang valid.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Component Name]	Pengumpulan Nomor Telepon
Intent Khusus Komponen	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_number_collection_incorrect_country_code
Parameter	[param_name]	telephone_number
Jenis Entitas	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_telephone_no_country_code

Parameter output

Parameter output adalah parameter sesi yang akan tetap aktif setelah keluar dari komponen. Parameter ini berisi informasi penting yang dikumpulkan oleh komponen. Komponen bawaan ini memberikan nilai untuk parameter output berikut:

Nama Parameter	Deskripsi	Format Output
telephone_number_collection_telephone_number	Parameter ini menampilkan nomor telepon yang diambil oleh komponen	string
telephone_number_collection_country_code	Parameter ini menampilkan kode negara yang diambil oleh komponen	string

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

1. Impor komponen bawaan.

Selesai

Agen Anda kini sudah siap dan dapat diuji.