Pernyataan akun komponen bawaan memeriksa tingkat autentikasi pelanggan, lalu mengirimkan pernyataan akun untuk jangka waktu tertentu kepada pelanggan yang diautentikasi. Jika pelanggan memiliki beberapa akun, komponen ini akan mengonfirmasi akun tertentu yang ingin digunakan pelanggan untuk mengambil laporan mutasi akun. Komponen ini menggunakan komponen bawaan Authentication untuk mengautentikasi pengguna dan menggunakan versi yang disesuaikan dari Pengumpulan tanggal lahir untuk mengumpulkan tanggal mulai dan tanggal berakhir untuk periode laporan.
Batasan
Selain batasan komponen bawaan umum, komponen bawaan ini memiliki batasan berikut:
- Komponen ini tidak mengenkripsi data apa pun.
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 Maksud Selamat Datang Default dan respons agen pertama di awal percakapan.
Akun tunggal
Pengguna akhir memiliki satu akun. Agen mengumpulkan tanggal mulai dan akhir laporan, apakah pengguna ingin mengenkripsi laporan, dan mengirimkan laporan rekening kepada pengguna.
| Input pengguna | Respons agen |
|---|---|
| Agen mengautentikasi pengguna menggunakan komponen bawaan Authentication | |
| Terima kasih, Anda telah berhasil diautentikasi. | |
| Harap tunggu sementara kami mengambil detail akun Anda. Kami telah menemukan nomor rekening yang berakhiran 1001 yang terkait dengan nomor Anda. Berikan tanggal mulai laporan rekening, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perlu diketahui bahwa periode laporan rekening hanya akan diberikan untuk 90 hari terakhir. |
|
| Agen mengumpulkan tanggal mulai pernyataan menggunakan komponen bawaan Tanggal lahir | |
| Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi Anda. Harap berikan tanggal akhir laporan mutasi akun, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perlu diketahui bahwa periode laporan rekening hanya akan diberikan untuk 90 hari terakhir. |
|
| Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir | |
| Terima kasih. Harap konfirmasi apakah Anda mencari laporan mutasi rekening antara 12-07-2023 hingga 24-07-2023? | |
| Ya | |
| Harap tunggu sementara kami mengambil detail laporan mutasi Anda. Kami menemukan transaksi dari 12-07-2023 hingga 24-07-2023. Apakah Anda ingin menerimanya melalui email, SMS, atau WhatsApp? |
|
| SMS | |
| Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda? | |
| Lain kali | |
| Anda akan menerima laporan mutasi dalam waktu 15 menit di ponsel terdaftar Anda. |
Beberapa akun
Pengguna akhir memiliki beberapa akun; agen mengonfirmasi akun mana yang diminta pengguna untuk mendapatkan laporan akun. Agen mengumpulkan tanggal mulai dan akhir laporan, apakah pengguna ingin mengenkripsi laporan, dan mengirimkan laporan rekening kepada pengguna.
| Input pengguna | Respons agen |
|---|---|
| Agen mengautentikasi pengguna menggunakan komponen bawaan Authentication | |
| Terima kasih, Anda telah berhasil diautentikasi. | |
| Harap tunggu sementara kami mengambil detail akun Anda. Kami menemukan bahwa ada 2 akun yang terkait dengan nomor Anda. Dapatkah Anda membantu kami dengan memberikan 4 digit terakhir akun yang Anda maksud? |
|
| 2002 | |
| Empat digit terakhir nomor rekening yang kami dapatkan adalah 2002, apakah sudah benar? | |
| ya | |
| Berikan tanggal mulai laporan mutasi akun, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perlu diketahui bahwa periode laporan rekening hanya akan diberikan untuk 90 hari terakhir. | |
| Agen mengumpulkan tanggal mulai pernyataan menggunakan komponen bawaan Tanggal lahir | |
| Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi Anda. Harap berikan tanggal akhir laporan mutasi akun, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perlu diketahui bahwa periode laporan rekening hanya akan diberikan untuk 90 hari terakhir. |
|
| Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir | |
| Terima kasih. Harap konfirmasi apakah Anda mencari laporan mutasi rekening antara 18-07-2023 hingga 22-07-2023? | |
| Ya | |
| Harap tunggu sementara kami mengambil detail laporan mutasi Anda. Kami menemukan transaksi dari 18-07-2023 hingga 22-07-2023. Apakah Anda ingin menerimanya melalui email, SMS, atau WhatsApp? |
|
| Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda? | |
| Ya | |
| Detail sandi akan dibagikan di WhatsApp terdaftar Anda. Anda akan menerima laporan mutasi dalam waktu 15 menit di WhatsApp terdaftar Anda. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Laporan Akun |
| Niat Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_account_statement_channelall |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_statement:request_statement |
Parameter input
Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku tertentu komponen. Parameter akan digunakan oleh satu atau beberapa kondisi dalam alur untuk menentukan perilaku komponen. Parameter cakupan alur harus ditetapkan di halaman awal komponen seperti yang dijelaskan di bawah. Parameter cakupan sesi dapat ditetapkan oleh alur panggilan, atau di halaman mulai komponen ini.
Komponen bawaan ini menerima parameter input berikut:
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.auth_level | (opsional) Menunjukkan tingkat autentikasi pemanggil. | bilangan bulat |
| $session.params.auth_level_req | Menunjukkan tingkat autentikasi yang diperlukan sebelum pengguna dapat mengakses laporan akunnya. Nilai ini dikonfigurasi di preset parameter pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah 1. |
bilangan bulat |
| $session.params.account_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang akun seperti yang dijelaskan dalam Jenis autentikasi. Nilai ini dikonfigurasi di preset parameter pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah true. |
boolean |
| $session.params.card_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang kartu seperti yang dijelaskan dalam Jenis autentikasi. Nilai ini dikonfigurasi di preset parameter pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah false. |
boolean |
| $session.params.phone_number | (opsional) Nomor telepon terdaftar pelanggan yang digunakan untuk autentikasi. | string |
| $session.params.account_count | (opsional) Jumlah akun yang terkait dengan pengguna terautentikasi. | bilangan bulat |
| $session.params.last_four_digit_of_account_number | (opsional) Empat digit terakhir nomor akun pelanggan yang laporannya perlu diberikan. Jika pelanggan memiliki satu akun, informasi ini akan diambil secara otomatis setelah autentikasi. Jika pelanggan memiliki beberapa akun, nomor akun tertentu akan dikumpulkan dari pelanggan. | string |
| $session.params.account_statement_max_days | Menentukan jumlah maksimum hari sebelum tanggal saat ini yang diizinkan untuk tanggal mulai laporan. Secara default, nilai ini adalah -90, yang menunjukkan bahwa tanggal mulai laporan dapat dimulai paling lambat 90 hari sebelum tanggal saat ini. Parameter ini dikonfigurasi di rute true halaman awal. |
bilangan bulat |
| $flow.max_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat meminta pengguna akhir untuk memberikan tanggal akhir laporan yang valid. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_confirm_period_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengonfirmasi periode pernyataan dengan pengguna akhir. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_statement_counter | Menentukan jumlah percobaan ulang yang diizinkan saat periode laporan yang diberikan tidak mengambil transaksi apa pun. Nilai defaultnya adalah 3. |
bilangan bulat |
Untuk mengonfigurasi parameter input untuk komponen ini, perluas untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Alur.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute true di Halaman Mulai.
- Di jendela Rute, edit nilai Preset Parameter sesuai kebutuhan.
- Klik Simpan.
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 |
|---|---|---|
| auth_level | Menunjukkan tingkat autentikasi pemanggil. | bilangan bulat |
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| account_count | Jumlah akun yang terkait dengan nomor telepon terdaftar. Akun ini mencakup akun pribadi dan akun yang pengguna miliki surat kuasanya. | bilangan bulat |
| last_four_digit_of_account_number | Jika pengguna memiliki satu akun, empat digit terakhir nomor akun akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah empat digit terakhir nomor akun yang dipilih pengguna untuk menerima informasi laporan akun. | string |
| transfer_reason | Parameter ini menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:agent: pengguna akhir meminta agen manusia di beberapa titik selama percakapan.denial_of_information: pengguna akhir menolak untuk membagikan informasi yang diminta oleh komponen.max_no_input: percakapan mencapai jumlah percobaan ulang maksimum untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input.max_no_match: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tanpa kecocokan. Lihat peristiwa bawaan tanpa kecocokan.webhook_error: terjadi error webhook. Lihat webhook.error built-in event. webhook_not_found: URL webhook tidak dapat dijangkau. Lihat webhook.error.not-found built-in event. |
string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan ini:
- Impor komponen bawaan.
- Konfigurasi webhook fleksibel yang disediakan dengan konfigurasi yang menjelaskan layanan eksternal Anda, lihat penyiapan Webhook di bawah.
Penyiapan webhook
Untuk menggunakan komponen ini, Anda harus mengonfigurasi webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.
Autentikasi
Jika sebelumnya Anda belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, Anda harus mengonfigurasinya untuk mengaktifkan autentikasi pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi untuk petunjuk selengkapnya.
Validasi akun
Webhook prebuilt_components_account_services:validate_account digunakan
oleh komponen untuk memverifikasi bahwa akun ada berdasarkan nomor telepon terdaftar pengguna
dan empat digit terakhir nomor akun yang diberikan.
Webhook juga menampilkan saldo akun, jika akun ada.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan rekening. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| account_found | Menunjukkan apakah akun dengan empat digit terakhir yang diberikan ada untuk akun terdaftar pengguna. | boolean |
| saldo | Jumlah saldo saat ini di akun, jika ada. | angka |
Untuk mengonfigurasi webhook Validasi akun untuk komponen ini, perluas petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_services:validate_account.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
- Klik Simpan.
Mendapatkan transaksi
Webhook prebuilt_components_account_statement:get_transactions digunakan oleh komponen untuk mengambil transaksi akun berdasarkan nomor telepon terdaftar pengguna, empat digit terakhir nomor akun, dan periode laporan mutasi.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan rekening. | string |
| $flow.statement_start_date | Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". | string |
| $flow.statement_end_date | (opsional) Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". Jika pengguna tidak memberikan nilai atau pemanggil menolak memberikan tanggal akhir, nilai akan ditetapkan ke tanggal saat ini secara default. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| transactions_count | Jumlah transaksi yang ditemukan untuk akun tertentu dalam periode laporan yang diberikan. | bilangan bulat |
Untuk mengonfigurasi webhook Get transactions untuk komponen ini, perluas untuk melihat petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_statement:get_transactions.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
- Klik Simpan.
Meminta laporan
Webhook prebuilt_components_account_statement:request_statement digunakan
oleh komponen untuk mengirimkan laporan rekening ke saluran yang dipilih berdasarkan
nomor telepon terdaftar pengguna, empat digit terakhir nomor rekening,
dan periode laporan.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan rekening. | string |
| $flow.statement_start_date | Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". | string |
| $flow.statement_end_date | (opsional) Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". Jika pengguna tidak memberikan nilai atau pemanggil menolak memberikan tanggal akhir, nilai akan ditetapkan ke tanggal saat ini secara default. | string |
| $flow.channel_medium | Saluran yang dipilih pengguna untuk menerima pesan. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_account_statement_channelphn dan prebuilt_components_account_statement_channelall, bergantung pada apakah pengguna memiliki email terdaftar. Secara default, email, mobile, dan WhatsApp didukung. |
string |
| $flow.encryption_status | Menunjukkan apakah pengguna ingin dokumen dienkripsi sebelum dikirim ke saluran yang ditentukan. Jika pengguna tidak memberikan nilai atau pemanggil menolak memberikan tanggal akhir, nilai defaultnya adalah true. |
boolean |
Untuk mengonfigurasi webhook pernyataan Permintaan untuk komponen ini, perluas untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_statement:request_statement.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat untuk webhook Anda.
- Tinjau dan perbarui Konfigurasi respons untuk mengekstrak kolom tertentu dari respons webhook Anda. Jangan ubah nama parameter, karena nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen dan webhook-nya kini telah disiapkan dan siap diuji.