Komponen bawaan histori transaksi memeriksa tingkat autentikasi pelanggan, lalu mengumpulkan jangka waktu transaksi dan filter lain yang diterapkan saat mengambil histori transaksi. Komponen ini mendukung filter untuk:
- Jenis transaksi
- Nama penjual
- Jumlah transaksi
Jika pelanggan memiliki beberapa akun, komponen akan mengonfirmasi akun tertentu yang histori transaksinya ingin diambil pelanggan. Komponen ini menggunakan komponen bawaan Autentikasi untuk mengautentikasi pengguna dan menggunakan versi Tanggal lahir yang disesuaikan untuk mengumpulkan tanggal mulai dan akhir untuk histori transaksi.
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 ini menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.
Beberapa akun
Pengguna akhir memiliki beberapa akun; agen mengonfirmasi akun mana yang histori transaksinya diminta pengguna. Agen mengumpulkan tanggal mulai dan akhir transaksi, filter apa pun yang ingin diterapkan pengguna ke transaksi, dan apakah pengguna ingin mengenkripsi histori transaksi atau tidak. Agen mengirim riwayat transaksi 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 mendapati bahwa ada 2 akun yang dikaitkan dengan nomor Anda. Bisakah Anda membantu kami dengan 4 digit terakhir dari akun yang Anda maksud? |
|
| 1001 | |
| Empat digit terakhir dari nomor rekening yang kita dapatkan adalah 1001, apakah itu benar? | |
| Ya | |
| Berikan tanggal mulai transaksi Anda, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Harap diperhatikan bahwa histori transaksi hanya akan disediakan selama 90 hari terakhir. | |
| Agen mengumpulkan tanggal mulai transaksi menggunakan komponen bawaan Tanggal lahir | |
| Bagus, kami telah mengumpulkan tanggal mulai transaksi Anda. Berikan tanggal akhir transaksi, dimulai dengan bulan, diikuti hari, lalu tahun. Harap diperhatikan bahwa histori transaksi hanya akan disediakan selama 90 hari terakhir. |
|
| Agen mengumpulkan tanggal mulai transaksi menggunakan komponen bawaan Tanggal lahir | |
| Terima kasih. Harap konfirmasi jika Anda mencari transaksi antara 25-06-2023 hingga 21-07-2023? | |
| Ya | |
| Beri tahu kami nama penjual yang transaksinya ingin Anda dapatkan. | |
| Nama penjual yang kami ambil adalah "Google". Bisakah Anda mengonfirmasinya dengan ya atau tidak? | |
| Ya | |
| Apakah Anda ingin melihat histori transaksi untuk kartu debit atau kredit Anda? | |
| Kredit | |
| Berikan jumlah untuk mengambil transaksi pada atau di atas jumlah yang ditentukan. Misalnya, jika Anda ingin menemukan transaksi di atas $100,30, ucapkan "100". | |
| 500 | |
| Harap tunggu selagi kami mengambil detail transaksi Anda. Kami menemukan transaksi dari 2-06-2023 hingga 21-07-2023. Mau menerimanya melalui SMS atau WhatsApp? |
|
| SMS | |
| Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya? | |
| Ya, silakan | |
| Detail sandi akan dibagikan di ponsel yang terdaftar. Anda akan menerima laporan dalam waktu 15 menit di ponsel yang terdaftar. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Histori Transaksi |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_transaction_history_transaction_collection |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_transaction_history_det_cred |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_transaction_history:get_transactions |
Parameter input
Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku komponen tertentu. Parameter akan digunakan oleh satu atau beberapa kondisi dalam flow untuk menentukan perilaku komponen yang seharusnya. 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 awal 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 histori transaksi. Nilai ini dikonfigurasi di preset parameter fulfillment 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 fulfillment 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 fulfillment entri halaman di halaman check auth level. Secara default, nilainya adalah false. |
boolean |
| $session.params.phone_number | (opsional) Nomor telepon pelanggan yang terdaftar yang digunakan untuk autentikasi. | string |
| $session.params.account_count | (opsional) Jumlah akun yang dikaitkan dengan pengguna yang diautentikasi. | bilangan bulat |
| $session.params.last_four_digit_of_account_number | (opsional) Empat digit terakhir nomor rekening pelanggan yang harus diisi histori transaksinya. Jika pelanggan memiliki satu akun, informasi ini akan diambil secara otomatis setelah autentikasi. Jika pelanggan memiliki beberapa akun, nomor rekening tertentu akan dikumpulkan dari pelanggan. | string |
| $session.params.transaction_history_max_days | Menentukan jumlah hari maksimum sebelum tanggal saat ini yang diizinkan untuk tanggal mulai transaksi. Secara default, nilainya adalah -90, yang menunjukkan bahwa tanggal mulai transaksi dapat dimulai tidak lebih dari 90 hari sebelum tanggal saat ini. Parameter ini ditetapkan di rute true halaman awal. |
bilangan bulat |
| $flow.max_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat meminta pengguna akhir untuk memberikan tanggal mulai dan akhir transaksi yang valid. Nilai defaultnya adalah 3. |
bilangan bulat |
Guna mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flow.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute yang benar di Halaman Awal.
- Di jendela Rute, edit nilai Presets 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 level autentikasi pemanggil. | bilangan bulat |
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, digunakan untuk mengidentifikasi pengguna. | string |
| account_count | Jumlah akun yang dikaitkan dengan nomor telepon yang terdaftar. Akun ini mencakup akun mandiri dan akun yang kuasanya dimiliki pengguna. | bilangan bulat |
| last_four_digit_of_account_number | Jika pengguna memiliki satu akun, empat digit terakhir nomor rekening akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah empat digit terakhir nomor rekening yang dipilih pengguna untuk menerima histori transaksi. | string |
| transfer_reason | Parameter ini menunjukkan alasan keluarnya flow, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:agent: pengguna akhir meminta agen manusia kapan saja 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 telah mencapai jumlah percobaan ulang maksimum untuk peristiwa tidak ada kecocokan. Lihat peristiwa bawaan yang 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 ini:
- Impor komponen bawaan.
- Konfigurasikan webhook fleksibel yang disediakan dengan konfigurasi yang mendeskripsikan layanan eksternal Dialogflow 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.
Authentication
Jika belum pernah mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, Anda harus mengonfigurasinya untuk mengaktifkan autentikasi pengguna untuk komponen ini. Lihat Penyiapan webhook autentikasi untuk petunjuk mendetail.
Validasi akun
Webhook prebuilt_components_account_services:validate_account digunakan oleh komponen untuk memverifikasi bahwa akun ada berdasarkan nomor telepon pengguna yang terdaftar dan empat digit terakhir nomor akun yang diberikan.
Webhook juga menampilkan saldo akun, jika ada akun.
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, digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih pengguna dan dikonfirmasi untuk menerima informasi laporan mutasi rekeningnya. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| account_found | Menunjukkan apakah ada akun dengan empat digit terakhir yang diberikan untuk akun pengguna yang terdaftar. | boolean |
| keseimbangan | Jumlah saldo saat ini di akun, jika ada. | angka |
Untuk mengonfigurasi webhook akun Validasi untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- 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 dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Mendapatkan transaksi
Webhook prebuilt_components_transaction_history:get_transactions digunakan oleh komponen untuk mengambil jumlah transaksi untuk akun berdasarkan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor akun, periode histori transaksi, dan filter apa pun yang dipilih oleh pengguna.
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, digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih pengguna dan dikonfirmasi untuk menerima histori transaksinya. | 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 tidak ada nilai yang diberikan oleh pengguna atau pemanggil menolak untuk memberikan tanggal akhir, nilainya akan ditetapkan secara default ke tanggal saat ini. | string |
| $flow.transaction_credit_debit | Jenis transaksi yang diminta oleh pengguna. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_transaction_history_det_cred. Secara default, "credit" dan "debit" didukung. Jika pengguna menolak untuk memilih jenis, nilai ini adalah string kosong "" dan transaksi jenis apa pun harus dihitung. |
string |
| $flow.merchant_name | Nama penjual yang diminta oleh pengguna. Jika pengguna menolak untuk memberikan nama penjual, nilai ini adalah string kosong "" dan transaksi dari semua penjual akan dihitung. |
string |
| $flow.high_amount_value | Jumlah transaksi minimum yang diminta oleh pengguna. Jika pengguna menolak untuk memberikan jumlah, parameter ini memiliki nilai default sebesar 0. |
bilangan bulat |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| transactions_count | Jumlah transaksi yang ditemukan untuk akun yang ditentukan dalam periode laporan yang ditentukan dengan penerapan filter yang dipilih. | bilangan bulat |
Untuk mengonfigurasi webhook Dapatkan transaksi untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_transaction_historyt:get_transactions.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Kirim info
Webhook prebuilt_components_transaction_history:send_info digunakan oleh komponen untuk mengirim histori transaksi ke saluran yang dipilih berdasarkan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor akun, periode histori transaksi, dan filter apa pun yang dipilih oleh pengguna.
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, digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_account_number | Empat digit terakhir nomor rekening yang dipilih pengguna dan dikonfirmasi untuk menerima histori transaksinya. | 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". | string |
| $flow.transaction_credit_debit | Jenis transaksi yang diminta oleh pengguna. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_transaction_history_det_cred. Secara default, "credit" dan "debit" didukung. Jika pengguna menolak untuk memilih jenis, nilai ini adalah string kosong "" dan transaksi jenis apa pun harus dikirim. |
string |
| $flow.merchant_name | Nama penjual yang diminta oleh pengguna. Jika pengguna menolak untuk memberikan nama penjual, nilai ini berupa string kosong "" dan transaksi dari semua penjual harus dikirim. |
string |
| $flow.high_amount_value | Jumlah transaksi minimum yang diminta oleh pengguna. Jika pengguna menolak untuk memberikan jumlah, parameter ini memiliki nilai default sebesar 0. |
bilangan bulat |
| $flow.channel_medium | Saluran yang dipilih pengguna untuk menerima pesan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_transaction_history_phone dan prebuilt_components_transaction_history_channel, bergantung pada apakah pengguna memiliki email yang 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 tidak ada nilai yang diberikan oleh pengguna atau pemanggil menolak untuk memberikan tanggal akhir, nilainya akan ditetapkan secara default ke true. |
boolean |
Untuk mengonfigurasi webhook Kirim info untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_transaction_history:send_info.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen Anda dan webhook-nya kini telah disiapkan dan siap diuji.