Komponen bawaan histori transaksi

Komponen bawaan histori transaksi akan memeriksa tingkat autentikasi pelanggan, lalu mengumpulkan jangka waktu transaksi dan filter lainnya yang diterapkan saat mengambil histori transaksi. Komponen ini mendukung filter untuk:

  • Jenis transaksi
  • Nama penjual
  • Jumlah transaksi

Jika pelanggan memiliki beberapa akun, komponen ini akan mengonfirmasi akun tertentu yang ingin diambil histori transaksinya oleh pelanggan. Komponen ini menggunakan komponen bawaan Autentikasi untuk mengautentikasi pengguna dan menggunakan versi Pengumpulan tanggal lahir yang disesuaikan untuk mengumpulkan tanggal mulai dan tanggal 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 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 oleh pengguna. Agen mengumpulkan tanggal mulai dan akhir transaksi, filter apa pun yang ingin diterapkan pengguna ke transaksi, dan apakah pengguna ingin mengenkripsi histori transaksi. Agen mengirimkan histori transaksi kepada pengguna.

Input pengguna Respons agen
Agen mengautentikasi pengguna menggunakan komponen bawaan Autentikasi
Terima kasih, Anda telah berhasil diautentikasi.
Harap tunggu sementara kami mengambil detail akun Anda.

Kami mendapati bahwa ada 2 akun yang terkait dengan nomor Anda.

Bisakah Anda memberi tahu kami 4 digit terakhir akun yang Anda maksud?
1001
Empat digit terakhir nomor rekening yang kami dapatkan adalah 1001, apakah benar?
Ya
Berikan tanggal mulai transaksi Anda, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa histori transaksi hanya akan diberikan untuk 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 Anda, mulai dari bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa histori transaksi hanya akan diberikan untuk 90 hari terakhir.
Agen mengumpulkan tanggal mulai transaksi menggunakan komponen bawaan Tanggal lahir
Terima kasih. Harap konfirmasi apakah Anda mencari transaksi antara 25-06-2023 hingga 21-07-2023?
Ya
Beri tahu kami nama penjual yang transaksinya ingin Anda dapatkan.
Google
Nama penjual yang kami tangkap adalah "Google". Dapatkah Anda mengonfirmasi dengan ya atau tidak?
Ya
Apakah Anda ingin melihat histori transaksi untuk kartu debit atau kredit Anda?
Kredit
Berikan jumlah untuk mengambil transaksi dengan jumlah yang sama atau lebih besar dari jumlah yang diberikan. 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 02-06-2023 hingga 21-07-2023. Ingin menerimanya melalui SMS atau WhatsApp?
SMS
Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda?
Ya, silakan
Detail sandi akan dibagikan di ponsel Anda yang terdaftar.

Anda akan menerima laporan mutasi dalam waktu 15 menit di ponsel Anda 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 tertentu dari 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 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 transaksinya. Nilai ini dikonfigurasi di preset parameter dari 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 dari 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 dari fulfillment 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 yang diautentikasi. bilangan bulat
$session.params.last_four_digit_of_account_number (opsional) Empat digit terakhir nomor akun pelanggan yang histori transaksinya 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.transaction_history_max_days Menentukan jumlah maksimum hari sebelum tanggal saat ini yang diizinkan untuk tanggal mulai transaksi. Secara default, nilai ini adalah -90, yang menunjukkan bahwa tanggal mulai transaksi tidak boleh 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

Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Alur.
  6. Klik Halaman Awal di bagian Halaman.
  7. Klik Rute true di Halaman Mulai.
  8. Di jendela Rute, edit nilai Preset Parameter sesuai kebutuhan.
  9. 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 surat kuasanya dimiliki oleh pengguna. bilangan bulat
last_four_digit_of_account_number Jika pengguna memiliki satu akun, empat digit terakhir dari nomor akun akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah empat digit terakhir dari nomor akun yang dipilih pengguna untuk menerima histori transaksi. 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 pada suatu saat 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 yang tidak cocok. 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 ini:

  1. Impor komponen bawaan.
  2. Konfigurasikan 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 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.

Memvalidasi akun

Webhook prebuilt_components_account_services:validate_account digunakan oleh komponen untuk memverifikasi bahwa akun ada berdasarkan nomor telepon yang terdaftar milik pengguna dan empat digit terakhir dari 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 dari nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan mutasi 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, luaskan untuk mendapatkan petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_account_services:validate_account.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Mendapatkan transaksi

Webhook prebuilt_components_transaction_history:get_transactions digunakan oleh komponen untuk mengambil jumlah transaksi untuk akun dengan nomor telepon terdaftar pengguna, 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, yang digunakan untuk mengidentifikasi pengguna. string
$session.params.last_four_digit_of_account_number Empat digit terakhir dari nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima histori transaksi. string
$flow.statement_start_date Tanggal mulai laporan mutasi yang diminta dalam format "YYYY-MM-DD". string
$flow.statement_end_date (opsional) Tanggal mulai laporan mutasi yang diminta dalam format "YYYY-MM-DD". Jika tidak ada nilai yang diberikan oleh pengguna atau pemanggil menolak untuk memberikan tanggal akhir, nilai defaultnya adalah 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 dari 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 harus dihitung. string
$flow.high_amount_value Jumlah transaksi minimum yang diminta oleh pengguna. Jika pengguna menolak untuk memberikan jumlah, parameter ini memiliki nilai default 0. bilangan bulat

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 yang ditentukan dalam periode laporan mutasi yang diberikan dengan filter yang dipilih diterapkan. bilangan bulat

Untuk mengonfigurasi webhook Get transactions untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_transaction_historyt:get_transactions.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Mengirim info

Webhook prebuilt_components_transaction_history:send_info digunakan oleh komponen untuk mengirim histori transaksi ke saluran yang dipilih berdasarkan nomor telepon terdaftar pengguna, 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, yang digunakan untuk mengidentifikasi pengguna. string
$session.params.last_four_digit_of_account_number Empat digit terakhir dari nomor rekening yang dipilih dan dikonfirmasi pengguna untuk menerima histori transaksi. string
$flow.statement_start_date Tanggal mulai laporan mutasi yang diminta dalam format "YYYY-MM-DD". string
$flow.statement_end_date (opsional) Tanggal mulai laporan mutasi 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 dari jenis apa pun harus dikirim. 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 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 0. bilangan bulat
$flow.channel_medium Saluran yang dipilih pengguna untuk menerima pesan. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_transaction_history_phone dan prebuilt_components_transaction_history_channel, 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 tidak ada nilai yang diberikan oleh pengguna atau pemanggil menolak untuk memberikan tanggal akhir, nilai defaultnya adalah true. boolean

Untuk mengonfigurasi webhook Kirim info untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_transaction_history:send_info.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Selesai

Agen dan webhook-nya kini telah disiapkan dan siap diuji.