Komponen bawaan laporan mutasi akun

Komponen bawaan Laporan mutasi akun memeriksa tingkat autentikasi pelanggan, lalu mengirimkan laporan mutasi akun tersebut selama periode waktu tertentu kepada pelanggan yang diautentikasi. Jika pelanggan memiliki beberapa akun, komponen akan mengonfirmasi akun tertentu yang laporan mutasi akunnya ingin diambil oleh pelanggan. Komponen ini menggunakan komponen bawaan Authentication untuk mengautentikasi pengguna dan menggunakan versi Tanggal lahir yang disesuaikan untuk mengumpulkan tanggal mulai dan akhir 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 ini menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.

Akun tunggal

Pengguna akhir memiliki satu akun. Agen mengumpulkan tanggal mulai dan akhir pernyataan, apakah pengguna ingin mengenkripsi pernyataan, dan mengirim laporan mutasi akun 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 rekening Anda.

Kami telah menemukan nomor rekening yang diakhiri dengan 1001 yang terkait dengan nomor Anda.

Berikan tanggal mulai laporan mutasi rekening, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Harap perhatikan bahwa periode laporan mutasi rekening hanya akan diberikan untuk 90 hari terakhir.
Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir
Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi Anda.

Berikan tanggal akhir laporan mutasi rekening, dimulai dengan bulan, diikuti hari, lalu tahun. Harap perhatikan bahwa periode laporan mutasi rekening hanya akan diberikan untuk 90 hari terakhir.
Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir
Terima kasih. Harap konfirmasi jika Anda mencari laporan mutasi rekening antara 12-07-2023 hingga 24-07-2023?
Ya
Harap tunggu selagi 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?
Tidak
Anda akan menerima laporan dalam waktu 15 menit di ponsel yang terdaftar.

Beberapa akun

Pengguna akhir memiliki beberapa akun; agen mengonfirmasi untuk akun mana pengguna meminta laporan mutasi rekening. Agen mengumpulkan tanggal mulai dan akhir pernyataan, apakah pengguna ingin mengenkripsi pernyataan, dan mengirim laporan mutasi akun 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?
2002
Empat digit terakhir dari nomor rekening yang kita dapatkan adalah 2002, apakah itu benar?
ya
Berikan tanggal mulai laporan mutasi rekening, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Harap perhatikan bahwa periode laporan mutasi rekening hanya akan diberikan untuk 90 hari terakhir.
Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir
Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi Anda.

Berikan tanggal akhir laporan mutasi rekening, dimulai dengan bulan, diikuti hari, lalu tahun. Harap perhatikan bahwa periode laporan mutasi rekening hanya akan diberikan untuk 90 hari terakhir.
Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir
Terima kasih. Harap konfirmasi jika Anda mencari laporan mutasi rekening antara 18-07-2023 hingga 22-07-2023?
Ya
Harap tunggu selagi 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?
WhatsApp
Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya?
Ya
Detail sandi akan dibagikan di WhatsApp terdaftar Anda.

Anda akan menerima pernyataan dalam waktu 15 menit di WhatsApp yang terdaftar.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Flow [Nama Komponen] Laporan Aktivitas Akun
Intent 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 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 level autentikasi pemanggil. bilangan bulat
$session.params.auth_level_req Menunjukkan level autentikasi yang diperlukan sebelum pengguna dapat mengakses laporan mutasi akunnya. 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 diisikan laporannya. 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.account_statement_max_days Menentukan jumlah hari maksimum sebelum tanggal saat ini yang diizinkan untuk tanggal mulai laporan. Secara default, nilainya adalah -90, yang menunjukkan bahwa tanggal mulai laporan mutasi dapat dimulai tidak lebih dari 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 memberikan tanggal akhir pernyataan 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 jika periode pernyataan yang diberikan tidak mengambil transaksi apa pun. Nilai defaultnya adalah 3. bilangan bulat

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

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Flow.
  6. Klik Halaman Awal di bagian Halaman.
  7. Klik Rute yang benar di Halaman Awal.
  8. Di jendela Rute, edit nilai Presets 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 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 dari nomor rekening yang dipilih pengguna untuk menerima informasi laporan mutasi rekeningnya. 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:

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

  1. Buka Dialogflow CX Console.
  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 Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. Klik Simpan.

Mendapatkan transaksi

Webhook prebuilt_components_account_statement:get_transactions digunakan oleh komponen untuk mengambil transaksi untuk sebuah akun, berdasarkan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor akun, 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, 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
$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

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. bilangan bulat

Untuk mengonfigurasi webhook Dapatkan transaksi untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_account_statement:get_transactions.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. Klik Simpan.

Pernyataan permintaan

Webhook prebuilt_components_account_statement:request_statement digunakan oleh komponen untuk mengirim pernyataan untuk akun ke saluran yang dipilih berdasarkan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor rekening, dan periode pernyataan.

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
$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.channel_medium Saluran yang dipilih pengguna untuk menerima pesan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_account_statement_channelphn dan prebuilt_components_account_statement_channelall, 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 Pernyataan permintaan untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_account_statement:request_statement.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. Klik Simpan.

Selesai

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