Komponen bawaan laporan mutasi kartu kredit

Pernyataan kartu kredit komponen bawaan memeriksa tingkat autentikasi pelanggan, lalu mengirimkan pernyataan kartu kredit untuk jangka waktu tertentu kepada pelanggan yang diautentikasi. Jika pelanggan memiliki beberapa kartu kredit, komponen ini akan mengonfirmasi kartu tertentu yang ingin digunakan pelanggan untuk mengambil laporan kartu kredit. Komponen ini menggunakan komponen bawaan Autentikasi versi yang disesuaikan untuk mengautentikasi pemegang kartu dan menggunakan komponen bawaan Pengumpulan tanggal lahir versi yang disesuaikan untuk mengumpulkan tanggal mulai dan akhir 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.

Satu kartu kredit

Pengguna akhir memiliki satu kartu kredit. Agen mengumpulkan tanggal mulai dan akhir laporan mutasi, apakah pengguna ingin mengenkripsi laporan mutasi, dan mengirimkan laporan mutasi kartu kredit 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 kartu Anda. Kami telah menemukan nomor kartu yang berakhiran 1002 yang terkait dengan nomor Anda.
	Berikan tanggal mulai laporan mutasi kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan kartu kredit hanya akan diberikan untuk 180 hari terakhir.
	Agen mengumpulkan tanggal mulai pernyataan menggunakan komponen bawaan Tanggal lahir
	Bagus, kami telah mengumpulkan tanggal mulai laporan kartu kredit Anda. Berikan tanggal akhir laporan kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan kartu kredit hanya akan diberikan untuk 180 hari terakhir.
	Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir
	Bagus, kami telah mengumpulkan tanggal akhir laporan kartu kredit Anda. Terima kasih. Harap konfirmasi apakah Anda mencari laporan antara 01-06-2023 dan 30-06-2023.
Ya
	Harap tunggu sementara kami mengambil detail laporan mutasi Anda. Kami menemukan transaksi antara 01-06-2023 dan 30-06-2023. Apakah Anda ingin menerimanya melalui email, SMS, atau WhatsApp?
Kirimkan ke email saya
	Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda?
Lain kali
	Anda akan menerima laporan mutasi dalam waktu 15 menit di email terdaftar Anda.

Beberapa kartu kredit

Pengguna akhir memiliki beberapa kartu kredit; agen mengonfirmasi kartu mana yang diminta pengguna untuk mendapatkan laporan kartu kredit. Agen mengumpulkan tanggal mulai dan akhir laporan mutasi, apakah pengguna ingin mengenkripsi laporan mutasi, dan mengirimkan laporan mutasi kartu kredit kepada pengguna.

Input pengguna	Respons agen
	Agen mengautentikasi pengguna menggunakan komponen bawaan Authentication
	Terima kasih, Anda telah berhasil divalidasi.
	Harap tunggu sementara kami mengambil detail kartu Anda. Kami menemukan bahwa ada 2 kartu yang terkait dengan nomor Anda. Dapatkah Anda membantu kami dengan memberikan 4 digit terakhir kartu yang Anda maksud?
1122
	Empat digit terakhir nomor kartu yang kami dapatkan adalah 1122, apakah benar?
Ya
	Berikan tanggal mulai laporan mutasi kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan kartu kredit hanya akan diberikan untuk 180 hari terakhir.
	Agen mengumpulkan tanggal mulai pernyataan menggunakan komponen bawaan Tanggal lahir
	Bagus, kami telah mengumpulkan tanggal mulai laporan kartu kredit Anda. Berikan tanggal akhir laporan kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan kartu kredit hanya akan diberikan untuk 180 hari terakhir.
	Agen mengumpulkan tanggal akhir laporan menggunakan komponen bawaan Tanggal lahir
	Bagus, kami telah mengumpulkan tanggal akhir laporan kartu kredit Anda. Terima kasih. Harap konfirmasi apakah Anda mencari pernyataan antara 13-07-2023 dan 14-07-2023.
Ya
	Harap tunggu sementara kami mengambil detail laporan mutasi Anda. Kami menemukan transaksi antara 13-07-2023 dan 14-07-2023. Apakah Anda ingin menerimanya melalui email, SMS, atau WhatsApp?
SMS
	Apakah Anda ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda?
Ya
	Detail sandi akan dibagikan di ponsel terdaftar Anda. Anda akan menerima laporan mutasi dalam waktu 15 menit di ponsel terdaftar Anda.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Laporan Kartu Kredit
Jenis Entitas	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_statement_channel_all
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_credit_card_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 kartu kredit mereka. 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 Tingkat autentikasi. Nilai ini dikonfigurasi di preset parameter pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah false.	boolean
$session.params.card_auth_enabled	Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang kartu seperti yang dijelaskan dalam Tingkat autentikasi. Nilai ini dikonfigurasi di preset parameter pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah true.	boolean
$session.params.phone_number	(opsional) Nomor telepon terdaftar pelanggan yang digunakan untuk autentikasi.	string
$session.params.credit_card_count	(opsional) Jumlah kartu kredit yang terkait dengan pengguna yang diautentikasi.	bilangan bulat
$session.params.last_four_digit_of_card_number	(opsional) Empat digit terakhir nomor kartu pelanggan yang laporannya perlu diberikan. Jika pelanggan memiliki satu kartu, informasi ini akan diambil secara otomatis setelah autentikasi. Jika pelanggan memiliki beberapa kartu, nomor kartu tertentu dikumpulkan dari pelanggan.	string
$session.params.credit_card_statement_max_days	Menentukan jumlah maksimum hari sebelum tanggal saat ini yang diizinkan untuk tanggal mulai laporan. Secara default, nilai ini adalah -180, yang menunjukkan bahwa tanggal mulai pernyataan tidak boleh lebih dari 180 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

Untuk mengonfigurasi parameter input untuk komponen ini, perluas 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
credit_card_count	Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar.	bilangan bulat
last_four_digit_of_card_number	Jika pengguna memiliki satu kartu, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki lebih dari satu kartu, nilai parameter ini adalah empat digit terakhir nomor kartu yang dipilih pengguna untuk menerima informasi laporan kartu kredit.	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:

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

Mendapatkan detail kartu kredit

Webhook prebuilt_components_credit_card_statement:credit_card_details digunakan oleh komponen untuk mengambil detail kartu kredit untuk nomor telepon terdaftar.

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

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
credit_card_count	Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar.	bilangan bulat
credit_card	Empat digit terakhir nomor kartu kredit pelanggan. Jika pelanggan memiliki beberapa kartu, nilai ini adalah null.	string
email	Email terdaftar pengguna. Jika tidak ada email yang terdaftar ke nomor telepon, nilai ini adalah null.	string

Untuk mengonfigurasi webhook Dapatkan detail kartu kredit untuk komponen ini, luaskan petunjuknya.

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_credit_card_statement:credit_card_details.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Validasi kartu

Webhook prebuilt_components_credit_card_statement:validate_date digunakan oleh komponen untuk memvalidasi apakah kartu kredit tertentu ada untuk nomor telepon terdaftar.

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_card_number	Empat digit terakhir nomor kartu kredit yang diberikan pengguna.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
valid_card	Menunjukkan apakah kartu yang diberikan ditemukan untuk nomor telepon terdaftar.	boolean

Untuk mengonfigurasi webhook Validasi kartu untuk komponen ini, perluas petunjuknya.

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_credit_card_statement:validate_card.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini 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_credit_card_statement:card_transaction_details digunakan oleh komponen untuk mengambil transaksi kartu berdasarkan nomor telepon terdaftar pengguna, empat digit terakhir nomor kartu, 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_card_number	Empat digit terakhir nomor kartu yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan kartu kredit.	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 kartu kredit tertentu dalam periode laporan mutasi yang diberikan.	bilangan bulat

Untuk mengonfigurasi webhook Get transactions untuk komponen ini, perluas untuk melihat petunjuknya.

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_credit_card_statement:card_transaction_details.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Meminta laporan

Webhook prebuilt_components_credit_card_statement:request_statement digunakan oleh komponen untuk mengirimkan laporan kartu kredit ke saluran yang dipilih berdasarkan nomor telepon terdaftar pengguna, empat digit terakhir nomor kartu kredit, 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_card_number	Empat digit terakhir nomor kartu yang dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan kartu kredit.	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_statement_channel_phone dan prebuilt_components_statement_channel_all, 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.

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_credit_card_statement:request_statement.
7. Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini 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.