Komponen bawaan saldo akun memeriksa tingkat autentikasi pelanggan dan memberikan informasi saldo akun kepada pelanggan yang diautentikasi. Jika pelanggan memiliki beberapa akun, komponen akan mengonfirmasi akun spesifik yang ingin diambil saldo akunnya oleh pelanggan.
Komponen ini menggunakan komponen bawaan Authentication untuk mengautentikasi pengguna.
Batasan
Selain batasan komponen bawaan umum, komponen bawaan ini mencakup batasan berikut:
- Komponen ini tidak mengenkripsi data apa pun.
Contoh dialog
Contoh dialog menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Mereka menunjukkan perilaku saat pengguna memanggil komponen menggunakan telepon, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.
Akun tunggal
Pengguna memiliki satu akun dan diberikan informasi saldo akun.
| Input Pengguna | Respons Agen |
|---|---|
| Agen mengautentikasi pengguna menggunakan komponen bawaan Authentication. | |
| Terima kasih, Anda telah berhasil diautentikasi. | |
| Tunggu sebentar, detail akun sedang diambil. Saldo Anda yang terkait dengan akun yang berakhiran 4567 adalah Rp500.000. |
Beberapa akun
Jika pengguna memiliki beberapa akun, agen akan meminta dan mengonfirmasi empat digit terakhir nomor rekening dan memberikan saldo rekening untuk akun tersebut.
| 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 itu benar? | |
| ya | |
| Saldo Anda yang terkait dengan nomor rekening yang berakhiran 2002 adalah $5.000. |
Beberapa akun dengan konteks
Jika pengguna memiliki beberapa akun, nomor akun yang direferensikan akan dipertahankan dari intent sebelumnya, dan pengguna akan diberi tahu saldo akunnya.
| Input Pengguna | Respons Agen |
|---|---|
| Harap tunggu sementara kami mengambil detail akun Anda. Kami menemukan bahwa ada 3 akun yang terkait dengan nomor Anda. Apakah Anda mencari nomor akun yang berakhiran 4567? |
|
| Ya | |
| Saldo Anda yang terkait dengan nomor rekening yang berakhiran 4567 adalah Rp500.000. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | Nama Komponen | Saldo Akun |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_account_number_collection_four_digit_account_number |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_account_balance:get_account_balance |
Parameter input
Parameter input mengonfigurasi perilaku tertentu dari komponen. Satu atau beberapa kondisi dalam alur menggunakan parameter ini untuk menentukan perilaku komponen. Anda harus menetapkan parameter cakupan alur di halaman awal komponen. Anda dapat menetapkan parameter cakupan sesi menggunakan alur panggilan atau di halaman awal komponen ini.
Komponen bawaan ini menerima parameter input berikut:
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.auth_level | (opsional) Menunjukkan tingkat autentikasi pemanggil. | integer |
| $session.params.auth_level_req | Menunjukkan tingkat autentikasi yang diperlukan sebelum pengguna dapat mengakses saldo akunnya. Nilai ini dikonfigurasi di parameter presets dari page entry fulfillment di halaman check auth level. Secara default, nilainya adalah 1. |
integer |
| $session.params.account_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang akun seperti yang dijelaskan dalam Jenis autentikasi. Nilai ini dikonfigurasi di parameter presets dari page entry fulfillment 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 parameter presets dari page entry fulfillment 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. | integer |
| $session.params.last_four_digit_of_account_number | (opsional) Empat digit terakhir nomor rekening pelanggan yang saldonya 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 |
| $flow.max_retry_acc_number | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan empat digit terakhir nomor rekening pengguna. Nilai defaultnya adalah 3. |
integer |
Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flows.
- Klik Start Page di bagian Pages.
- Klik Route true di Start Page.
- Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
- Klik Simpan.
Parameter output
Parameter output adalah parameter sesi yang 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. | integer |
| phone_number | Nomor telepon lokal penelepon, 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 surat kuasanya dimiliki oleh pengguna. | integer |
| 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 rekening yang dipilih pengguna untuk menerima informasi saldo rekening. | string |
| transfer_reason | Menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:agent: pengguna meminta agen manusia pada suatu waktu selama percakapan.denial_of_information: pengguna menolak untuk membagikan informasi yang diminta oleh komponen.max_no_input: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input.max_no_match: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tidak ada kecocokan. Lihat peristiwa bawaan tidak cocok.webhook_error: terjadi error webhook. Lihat peristiwa bawaan webhook.error. webhook_not_found: URL webhook tidak dapat dijangkau. Lihat peristiwa bawaan webhook.error.not-found. |
string |
Penyiapan dasar
Untuk menyiapkan komponen bawaan, selesaikan langkah-langkah berikut:
- Impor komponen bawaan.
- Konfigurasikan webhook fleksibel yang disediakan dengan setelan yang menjelaskan layanan eksternal Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Penyiapan webhook.
Penyiapan webhook
Untuk menggunakan komponen ini, Anda harus mengonfigurasi webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal dan melakukan tindakan yang diminta oleh komponen.
Autentikasi
Jika Anda belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, konfigurasikan layanan tersebut untuk mengaktifkan autentikasi pengguna untuk komponen ini. Untuk mengetahui informasi selengkapnya tentang penyiapan webhook, lihat Penyiapan webhook autentikasi.
Memvalidasi akun
Komponen ini menggunakan webhook prebuilt_components_account_services:validate_account
untuk memverifikasi bahwa akun ada berdasarkan nomor telepon pengguna yang terdaftar
dan empat digit terakhir nomor rekening yang diberikan. Webhook
juga menampilkan saldo akun jika akun ada.
Parameter permintaan API
Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $session.params.phone_number | Nomor telepon lokal penelepon, 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 saldo rekening. | string |
Parameter respons API
Komponen ini mengambil parameter berikut dari respons API:
| 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, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_account_services:validate_account.
- Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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
Komponen bawaan dan webhook-nya kini telah disiapkan dan siap diuji.