Laporan mutasi kartu kredit komponen bawaan memeriksa tingkat autentikasi pelanggan, lalu mengirim laporan mutasi kartu kredit selama periode waktu tertentu kepada pelanggan yang diautentikasi. Jika pelanggan memiliki beberapa kartu kredit, komponen akan mengonfirmasi kartu tertentu yang ingin diambil laporan mutasi kartu kreditnya. Komponen ini menggunakan versi kustom komponen Autentikasi bawaan untuk mengautentikasi pemegang kartu 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.
Kartu kredit tunggal
Pengguna akhir memiliki satu kartu kredit. Agen mengumpulkan tanggal mulai dan akhir laporan, baik pengguna ingin mengenkripsi pernyataan, dan mengirim 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 diakhiri dengan 1002 yang terkait dengan nomor Anda. |
|
| Berikan tanggal mulai laporan mutasi kartu kredit, dimulai dengan bulan, diikuti hari, lalu tahun. Harap perhatikan bahwa laporan mutasi kartu kredit hanya akan diberikan untuk 180 hari terakhir. | |
| Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir | |
| Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi kartu kredit Anda. Berikan tanggal akhir laporan mutasi kartu kredit, dimulai dengan bulan, diikuti hari, lalu tahun. Harap 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. Harap konfirmasi jika Anda mencari laporan tersebut antara 01-06-2023 dan 30-06-2023. |
|
| Ya | |
| Harap tunggu selagi 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? | |
| Tidak | |
| Anda akan menerima laporan tersebut dalam waktu 15 menit di email terdaftar Anda. |
Beberapa kartu kredit
Pengguna akhir memiliki beberapa kartu kredit; agen mengonfirmasi kartu mana yang laporan mutasi kartu kreditnya diminta pengguna. Agen mengumpulkan tanggal mulai dan akhir laporan, baik pengguna ingin mengenkripsi pernyataan, dan mengirim 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 dikaitkan dengan nomor Anda. Bisakah Anda membantu kami dengan 4 digit terakhir kartu yang Anda maksud? |
|
| 1122 | |
| Empat digit terakhir nomor kartu yang kita dapatkan adalah 1122, apakah itu benar? | |
| Ya | |
| Berikan tanggal mulai laporan mutasi kartu kredit, dimulai dengan bulan, diikuti hari, lalu tahun. Harap perhatikan bahwa laporan mutasi kartu kredit hanya akan diberikan untuk 180 hari terakhir. | |
| Agen mengumpulkan tanggal mulai laporan menggunakan komponen bawaan Tanggal lahir | |
| Bagus, kami telah mengumpulkan tanggal mulai laporan mutasi kartu kredit Anda. Berikan tanggal akhir laporan mutasi kartu kredit, dimulai dengan bulan, diikuti hari, lalu tahun. Harap 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. Harap konfirmasi jika Anda mencari laporan tersebut antara 13-07-2023 hingga 14-07-2023. |
|
| Ya | |
| Harap tunggu selagi 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? | |
| Ya | |
| 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] | 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 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 level autentikasi yang diperlukan sebelum pengguna dapat mengakses laporan mutasi kartu kreditnya. 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 di Tingkat autentikasi. Nilai ini dikonfigurasi di preset parameter fulfillment 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 di Tingkat autentikasi. Nilai ini dikonfigurasi di preset parameter fulfillment entri halaman di halaman check auth level. Secara default, nilainya adalah true. |
boolean |
| $session.params.phone_number | (opsional) Nomor telepon pelanggan yang terdaftar yang digunakan untuk autentikasi. | string |
| $session.params.credit_card_count | (opsional) Jumlah kartu kredit yang dikaitkan dengan pengguna yang diautentikasi. | bilangan bulat |
| $session.params.last_four_digit_of_card_number | (opsional) Empat digit terakhir dari nomor kartu pelanggan yang harus diisi dengan laporan. 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, nilainya adalah -180, yang menunjukkan bahwa tanggal mulai laporan mutasi dapat dimulai tidak 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 memberikan tanggal akhir pernyataan 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 |
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon yang 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 mutasi kartu kredit. | 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.
Dapatkan detail kartu kredit
Webhook prebuilt_components_credit_card_statement:credit_card_details digunakan oleh komponen untuk mengambil detail kartu kredit untuk nomor telepon yang 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, digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon yang terdaftar. | bilangan bulat |
| credit_card | Empat digit terakhir nomor kartu kredit pelanggan. Jika pelanggan memiliki beberapa kartu, nilai ini adalah null. |
string |
Email terdaftar milik pengguna. Jika tidak ada email yang terdaftar ke nomor telepon, nilainya adalah null. |
string |
Untuk mengonfigurasi webhook Dapatkan detail kartu kredit 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_credit_card_statement:credit_card_details.
- 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.
Validasi kartu
Webhook prebuilt_components_credit_card_statement:validate_date digunakan oleh komponen untuk memvalidasi apakah kartu kredit tertentu ada untuk nomor telepon yang 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, 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 yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| valid_card | Menunjukkan apakah kartu yang diberikan ditemukan untuk nomor telepon yang terdaftar. | boolean |
Untuk mengonfigurasi webhook kartu 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_credit_card_statement:validate_card.
- 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_credit_card_statement:card_transaction_details digunakan oleh komponen untuk mengambil transaksi kartu berdasarkan nomor telepon pengguna yang terdaftar, empat digit terakhir nomor kartu, 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_card_number | Empat digit terakhir nomor kartu yang dipilih pengguna dan dikonfirmasi 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 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 kartu kredit yang ditentukan dalam periode laporan yang ditentukan. | 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_credit_card_statement:card_transaction_details.
- 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.
Pernyataan permintaan
Webhook prebuilt_components_credit_card_statement:request_statement digunakan oleh komponen untuk mengirim pernyataan kartu kredit ke saluran yang dipilih berdasarkan nomor telepon pengguna yang terdaftar, 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, digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_card_number | Empat digit terakhir nomor kartu yang dipilih pengguna dan dikonfirmasi 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 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_statement_channel_phone dan prebuilt_components_statement_channel_all, 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.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_credit_card_statement:request_statement.
- 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.