Komponen bawaan ini menangkap 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 mengizinkan 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 menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.
Nomor telepon yang valid dalam dua giliran
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 adalah plus 1. Sebutkan nomor telepon Anda. | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah benar? | |
| Ya, sudah benar | |
| Bagus, saya sudah 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 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 akan meminta pengguna akhir untuk memberikan nomor telepon lagi.
| Input pengguna | Respons agen |
|---|---|
| Apa nama atau kode negara Anda? | |
| +1 6502530001 | |
| Maaf, nomor telepon ini tidak dapat dikenali. Saya telah mengumpulkan kode negara sebagai plus 1. Berikan nomor telepon yang valid. | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah 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 menemukan bahwa kode negara dan nomor telepon yang diberikan tidak valid. Agen kemudian meminta kembali 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 | |
| Oke, kode negara Anda adalah plus 1 . Berapa nomor telepon Anda? | |
| 6502530000 | |
| Oke. Nomor yang Anda sebutkan adalah plus 1 6502530000, apakah 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 dikenali sebanyak tiga kali.
| Input pengguna | Respons agen |
|---|---|
| Apa nama atau kode negara Anda? | |
| Tidak apa-apa | |
| Maaf, saya tidak mengerti. Bisakah Anda mengucapkan atau memasukkan kode negara lagi? | |
| bagus | |
| Hmm, saya masih belum bisa memahaminya. Pastikan Anda mengucapkan kode negara. Jika Anda kesulitan mendengar saya, 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 | [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 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:
Selesai
Agen Anda sekarang sudah disiapkan dan siap diuji.