Komponen bawaan pengumpulan tanggal lahir

Komponen bawaan ini mengambil dan memvalidasi tanggal lahir dengan mengumpulkan bulan, tanggal, dan tahun.

Batasan

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

  • Komponen ini tidak mendukung verifikasi tanggal lahir pengguna akhir melalui verifikasi tanda pengenal.

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

Fungsi 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 Selamat Datang Default dan respons agen pertama di awal percakapan.

Tanggal lahir lengkap

Pengguna akhir memberikan tanggal lahir lengkap dalam satu giliran; agen berhasil menerimanya.

Input pengguna Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
9 September 1995
Oke, tanggal lahir Anda adalah 9 September 1995. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.

Tanggal lahir sebagian

Pengguna akhir memberikan tanggal lahir dengan mengucapkan bulan terlebih dahulu, diikuti dengan tanggal dan tahun; agen berhasil menerimanya.

Input pengguna Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.

Validasi tanggal mendatang

Skenario ini mengasumsikan bahwa tanggal saat ini adalah 22 Maret 2023. Pengguna akhir memberikan tanggal lahir di masa mendatang; agen memvalidasinya dan meminta ulang pengguna akhir untuk memberikan tanggal lahir yang benar.

Input pengguna Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
9 September 2023
Kamu lahir tahun berapa?
2023
Oke, tanggal lahir Anda adalah 9 September 2023. Apakah itu benar?
ya
Maaf, Anda telah memberikan tanggal mendatang. Mari kita mulai lagi.
Bulan apa Anda lahir?
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.

Tanggal tidak valid

Pengguna akhir memberikan tanggal lahir yang tidak valid seperti 30 Februari 1999 atau 31 April 1999; agen memvalidasinya dan meminta ulang pengguna akhir untuk memberikan tanggal lahir yang benar.

Input pengguna Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
30 Februari 1999
Baik, tanggal lahir Anda adalah 30 Februari 1999. Apakah itu benar?
ya
Tanggal yang Anda berikan tidak valid. Mari kita mulai lagi.
Bulan apa Anda lahir?
Maret
Tanggal berapa Anda lahir?
12
Kamu lahir tahun berapa?
1999
Oke, tanggal lahir Anda adalah 12 Maret 1999. Apakah itu benar?
ya
Baik, kami telah mengumpulkan tanggal lahir Anda.

Input tidak dikenal

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

Input pengguna Respons agen
Harap berikan tanggal lahir Anda. Sebutkan bulan lahir Anda, diikuti dengan tanggal lahir, lalu tahun lahir Anda.
Tidak apa-apa
Maaf, saya tidak mengerti. Bisakah Anda mengucapkan atau memasukkan tanggal lahir Anda lagi?
bagus
Maaf, kami tidak mendapatkan tanggal lahir Anda. Mari kita mulai dengan bulan. Katakan bulan lahir Anda?
good
Maaf, saya tidak mengerti. Bisa ucapkan atau masukkan nomor bulannya lagi?
bagus
Hmm, saya masih belum bisa mendapatkannya. Pastikan Anda mengucapkan bulan. Jika saya mengalami masalah saat mendengar Anda, Anda juga dapat menggunakan keypad untuk memasukkan nomor bulan.
bagus
Maaf, saya kesulitan memahami respons Anda.

Validasi tanggal lahir

Komponen bawaan ini menggunakan fungsi sistem IS_DATE dan IS_FUTURE_DATE untuk memeriksa apakah tanggal yang dikumpulkan valid dan sudah berlalu. Selain itu:

  • Input seperti "bulan ini", "bulan depan", atau "bulan lalu" akan dikonversi menjadi bulan yang sesuai. Misalnya, jika pengguna akhir berinteraksi dengan agen pada bulan Maret, "bulan ini", "bulan depan", dan "bulan lalu" akan dikonversi menjadi "Maret", "April", dan "Februari".
  • Memvalidasi bahwa tahun harus terdiri dari empat digit. Jika input tahun hanya berisi dua digit, komponen akan mengonversinya menjadi tahun empat digit. Misalnya, "98" dikonversi menjadi "1998".
  • Input seperti "Kamis ini", "Kamis lalu", dan "Kamis depan" akan dicatat sebagai bulan dan hari yang sesuai, lalu agen akan meminta Anda untuk memberikan tahunnya. Misalnya, jika pengguna akhir berinteraksi dengan agen pada 22 Maret 2023, yang merupakan hari Rabu, maka "Kamis ini", "Kamis lalu", dan "Kamis depan" akan dikonversi menjadi "23 Maret", "16 Maret", dan "30 Maret".

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Flow [Component Name] Pengumpulan Tanggal Lahir
Intent Khusus Komponen prebuilt_components_[component_name]_[intent_name] prebuilt_components_dob_collection_collect_month
Parameter [param_name] tgl_lahir
Jenis Entitas prebuilt_components_[component_name]_[entity_type] prebuilt_components_dob_collection_dob_day

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
dob_collection_dob Parameter ini menampilkan objek yang berisi elemen tanggal lahir: hari, bulan, dan tahun 
{
  "year": bilangan bulat,
  "month": bilangan bulat,
  "day": bilangan bulat
}

Penyiapan dasar

Untuk menyiapkan komponen bawaan ini:

  1. Impor komponen bawaan.

Selesai

Agen Anda kini telah disiapkan dan siap diuji.

Sebelumnya
Laporan mutasi kartu
Berikutnya
Sengketa