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 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:
Contoh dialog
Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Contoh dialog ini 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 | |
| Oke, kode negara Anda plus 1. Harap sebutkan nomor telepon Anda. | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah itu benar? | |
| Ya, sudah benar | |
| Bagus, saya selesai mengumpulkan nomor telepon. |
Nomor telepon yang valid dalam satu giliran
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? | |
| +1 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah itu benar? | |
| Ya, sudah benar | |
| Bagus, saya selesai mengumpulkan nomor telepon. |
Nomor telepon tidak valid
Pengguna akhir memberikan kode negara dan nomor telepon secara bergantian; agen memeriksa dan menemukan bahwa nomor telepon yang diberikan memiliki panjang yang valid (dalam 16 digit), tetapi bukan nomor telepon yang valid. Kemudian, agen akan meminta ulang pengguna akhir untuk memberikan nomor telepon.
| Input pengguna | Respons agen |
|---|---|
| Apa nama atau kode negara Anda? | |
| +1 6502530001 | |
| Maaf, nomor telepon ini tidak dapat dikenali. Saya telah mengumpulkan kode negara plus 1. Berikan nomor telepon yang valid. | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah itu benar? | |
| Ya, sudah benar | |
| Bagus, saya selesai mengumpulkan nomor telepon. |
Kode negara dan nomor telepon tidak valid
Pengguna akhir memberikan kode negara dan nomor telepon secara bergantian; agen memeriksa dan mendapati bahwa kode negara dan nomor telepon yang diberikan tidak valid. Agen kemudian meminta 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. Harap sebutkan nama atau kode negara Anda. | |
| 1 | |
| Oke, kode negara Anda plus 1 . Berapa nomor telepon Anda? | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah itu benar? | |
| Ya, sudah benar | |
| Bagus, saya selesai mengumpulkan nomor telepon. |
Masukan tidak dikenal
Komponen keluar dari flow setelah pengguna akhir memberikan input yang tidak dikenal sebanyak tiga kali.
| Input pengguna | Respons agen |
|---|---|
| Apa nama atau kode negara Anda? | |
| Tidak apa-apa | |
| Maaf, saya tidak mengerti. Dapatkah Anda mengucapkan atau memasukkan kode negara lagi? | |
| nyaman | |
| Hmm, saya masih belum bisa memahaminya. Pastikan Anda menyebutkan kode negara. Jika saya kesulitan mendengar ucapan Anda, Anda juga dapat menggunakan keypad untuk memasukkan kode negara. | |
| good | |
| Maaf, saya kesulitan memahami jawaban 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 | [Nama Komponen] | 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 mengembalikan nomor telepon yang diambil komponen | string |
| telephone_number_collection_country_code | Parameter ini menampilkan kode negara yang diambil oleh komponen | string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
Selesai
Agen Anda sekarang seharusnya sudah siap dan dapat melakukan pengujian.