Komponen bawaan laporan mutasi kartu kredit memeriksa tingkat autentikasi pengguna, lalu mengirimkan laporan mutasi kartu kredit untuk periode yang ditentukan kepada pengguna yang diautentikasi. Jika Anda memiliki beberapa kartu kredit, komponen ini akan mengonfirmasi kartu tertentu untuk mengambil laporan mutasi kartu kredit.
Komponen ini menggunakan versi yang disesuaikan dari komponen bawaan Authentication untuk mengautentikasi pemegang kartu dan mengandalkan versi yang disesuaikan dari Date of birth collection untuk mengumpulkan tanggal mulai dan akhir periode laporan.
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.
Satu kartu kredit
Pengguna memiliki satu kartu kredit. Agen mengumpulkan tanggal mulai dan akhir laporan mutasi serta apakah pengguna ingin mengenkripsi laporan mutasi, lalu 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 selagi 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 mutasi kartu kredit hanya akan diberikan untuk 180 hari terakhir. | |
| Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir. | |
| Baik, kami telah mengumpulkan tanggal mulai laporan mutasi kartu kredit Anda. Berikan tanggal akhir laporan mutasi kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan mutasi 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 mutasi kartu kredit Anda. Terima kasih. 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. Ingin menerimanya melalui email, SMS, atau WhatsApp? |
|
| Kirim ke email saya | |
| 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
Jika pengguna memiliki beberapa kartu kredit, agen akan mengonfirmasi kartu mana yang diminta laporan mutasi kartu kreditnya. Agen mengumpulkan tanggal mulai dan akhir laporan, memeriksa apakah pengguna ingin mengenkripsi laporan, 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 selagi kami mengambil detail kartu Anda. Kami menemukan bahwa ada 2 kartu yang terkait dengan nomor Anda. Berikan 4 digit terakhir kartu yang Anda maksud. |
|
| 1122 | |
| Empat digit terakhir nomor kartu yang kami dapatkan adalah 1122, apakah itu benar? | |
| Ya | |
| Berikan tanggal mulai laporan mutasi kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan mutasi kartu kredit hanya akan diberikan untuk 180 hari terakhir. | |
| Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir. | |
| Baik, kami telah mengumpulkan tanggal mulai laporan mutasi kartu kredit Anda. Berikan tanggal akhir laporan mutasi kartu kredit, dimulai dengan bulan, diikuti dengan hari, lalu tahun. Perhatikan bahwa laporan mutasi 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 mutasi kartu kredit Anda. Terima kasih. Konfirmasi apakah Anda mencari laporan antara 13-07-2023 dan 14-07-2023. |
|
| Ya | |
| Harap tunggu sementara kami mengambil detail laporan Anda. Kami menemukan transaksi antara 13-07-2023 dan 14-07-2023. Ingin menerimanya melalui email, SMS, atau WhatsApp? |
|
| SMS | |
| Ingin mengenkripsi dokumen sebelum kami membagikannya kepada Anda? | |
| Ya | |
| Detail sandi akan dibagikan di ponsel Anda yang terdaftar. Anda akan menerima laporan dalam waktu 15 menit di ponsel Anda yang terdaftar. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Component Name] | Laporan Mutasi 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 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 laporan mutasi kartu kreditnya. 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 false. |
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 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. | integer |
| $session.params.last_four_digit_of_card_number | (opsional) Empat digit terakhir nomor kartu kredit 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 akan dikumpulkan dari pelanggan. | string |
| $session.params.credit_card_statement_max_days | Menentukan jumlah hari maksimum sebelum tanggal saat ini yang diizinkan untuk tanggal mulai laporan. Secara default, nilai ini adalah -180, yang menunjukkan bahwa tanggal mulai laporan tidak boleh dimulai lebih dari 180 hari sebelum tanggal saat ini. Parameter ini dikonfigurasi di rute true halaman awal. |
integer |
| $flow.max_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat meminta pengguna memberikan tanggal akhir laporan yang valid. 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 pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar. | integer |
| 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 kredit yang dipilih pengguna untuk menerima informasi laporan mutasi kartu kredit. | string |
| transfer_reason | Parameter ini 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 ini:
- 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 Anda.
Autentikasi
Jika sebelumnya Anda belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, Anda harus mengonfigurasinya guna mengaktifkan autentikasi pengguna untuk komponen ini. Untuk mengetahui informasi selengkapnya, lihat Penyiapan webhook autentikasi.
Mendapatkan detail kartu kredit
Webhook prebuilt_components_credit_card_statement:credit_card_details
mengambil detail kartu kredit untuk nomor telepon yang terdaftar.
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 pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar. | integer |
| credit_card | Empat digit terakhir nomor kartu kredit pelanggan. Jika pelanggan memiliki beberapa kartu, nilai ini adalah null. |
string |
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 untuk melihat petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_credit_card_statement:credit_card_details.
- 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.
Memvalidasi kartu
Komponen ini menggunakan webhook prebuilt_components_credit_card_statement:validate_date untuk memvalidasi apakah kartu kredit tertentu ada untuk nomor telepon yang terdaftar.
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 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
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| valid_card | Menunjukkan apakah kartu yang diberikan ditemukan untuk nomor telepon yang terdaftar. | boolean |
Untuk mengonfigurasi webhook Validate card 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_credit_card_statement:validate_card.
- 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.
Mendapatkan transaksi
Komponen ini menggunakan webhook prebuilt_components_credit_card_statement:card_transaction_details untuk mengambil transaksi kartu menggunakan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor kartu, dan periode laporan mutasi.
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 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 dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan mutasi kartu kredit. | string |
| $flow.statement_start_date | Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". | string |
| $flow.statement_end_date | (opsional) Tanggal akhir laporan yang diminta dalam format "YYYY-MM-DD". Jika tidak ada nilai yang diberikan oleh pengguna atau penelepon menolak memberikan tanggal akhir, nilai akan ditetapkan secara default ke tanggal saat ini. | string |
Parameter respons API
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| transactions_count | Jumlah transaksi yang ditemukan untuk kartu kredit yang ditentukan dalam periode laporan yang diberikan. | integer |
Untuk mengonfigurasi webhook Dapatkan transaksi 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_credit_card_statement:card_transaction_details.
- 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.
Meminta laporan
Komponen ini menggunakan webhook prebuilt_components_credit_card_statement:request_statement untuk mengirim laporan mutasi kartu kredit ke saluran yang dipilih menggunakan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor kartu kredit, dan periode laporan mutasi.
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 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 dipilih dan dikonfirmasi pengguna untuk menerima informasi laporan mutasi kartu kredit. | string |
| $flow.statement_start_date | Tanggal mulai laporan yang diminta dalam format "YYYY-MM-DD". | string |
| $flow.statement_end_date | (opsional) Tanggal akhir laporan yang diminta dalam format "YYYY-MM-DD". Jika tidak ada nilai yang diberikan oleh pengguna atau penelepon menolak memberikan tanggal akhir, nilai akan ditetapkan secara default ke tanggal saat ini. | 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 tidak ada nilai yang diberikan oleh pengguna atau pemanggil menolak untuk mengenkripsi, nilai akan ditetapkan secara default ke true. |
boolean |
Untuk mengonfigurasi webhook Pernyataan permintaan 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_credit_card_statement:request_statement.
- 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 laporan mutasi kartu kredit dan webhook-nya kini telah disiapkan dan siap diuji.