Komponen bawaan yang dibangun sebelumnya mengautentikasi pengguna dan memungkinkannya menyengketakan atau menyangkal tagihan, transaksi, dan biaya. Komponen ini menggunakan versi kustom komponen Autentikasi bawaan untuk mengautentikasi pemegang rekening dan pemegang kartu. Komponen ini juga menggunakan versi komponen bawaan Tanggal lahir yang disesuaikan untuk mengumpulkan tanggal transaksi yang disengketakan.
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.
Pengguna yang tidak diautentikasi dengan sengketa transaksi
Agen mengidentifikasi bahwa pengguna belum pernah diautentikasi sebelumnya dan mengumpulkan informasi untuk memverifikasi bahwa pengguna adalah pemegang akun yang terdaftar. Agen akan mengumpulkan informasi tentang sengketa yang meliputi nomor rekening, mode sengketa, tanggal, dan jumlah, dan membuat kasus baru untuk sengketa tersebut.
| Input pengguna | Respons agen |
|---|---|
| Agen mengautentikasi pengguna menggunakan komponen bawaan Authentication | |
| Terima kasih, Anda telah berhasil diautentikasi. | |
| Ingatlah bahwa Anda dapat mengajukan klaim atau menyengketakan tagihan di portal perbankan online. Apakah Anda ingin melanjutkan percakapan ini untuk mengajukan klaim atau sengketa? | |
| Ya, ajukan sengketa | |
| Beri tahu kami apakah sengketa Anda berkaitan dengan penagihan kartu kredit atau transaksi. | |
| Ini tentang transaksi saya | |
| Harap tunggu selagi kami mengambil detail akun Anda. Kami telah menemukan bahwa ada 2 akun yang dikaitkan dengan nomor Anda. Beri tahu kami 4 digit terakhir dari akun yang Anda maksud. |
|
| 1001 | |
| Terima kasih, 4 digit terakhir yang kami kumpulkan adalah 1001. Apakah itu benar? | |
| Ya | |
| Untuk memulai, kapan tanggal transaksinya? | |
| Agen mengumpulkan tanggal transaksi menggunakan komponen bawaan Tanggal lahir | |
| Dapatkah Anda mengonfirmasi jumlah yang ditransfer? Misalnya, jika Anda ingin menemukan transaksi di atas $100,30, ucapkan "100". | |
| 15 dolar | |
| Anda telah memasukkan jumlah sengketa sebesar $15 untuk tanggal 005-05-2023. Apakah Anda ingin mengajukan sengketa pada akun Anda? | |
| Ya | |
| Kami telah mengajukan kasus baru terkait sengketa Anda. Nomor kasus Anda adalah 448639 dan telah dibagikan dengan alamat email terdaftar Anda. Setelah memeriksa informasi yang Anda berikan, kami akan mengembalikan dana Anda ke rekening Anda yang diakhiri dengan 1001. |
Pengguna terautentikasi dengan sengketa kartu kredit
Agen mengidentifikasi bahwa pengguna telah diautentikasi sebelumnya dan mengambil informasi tentang kartu yang terdaftar untuk pengguna. Pengguna memilih untuk mengunci kartu secara permanen, dan agen membuat permintaan kartu kunci secara permanen. Agen kemudian menanyakan kepada pengguna apakah mereka ingin menerbitkan ulang kartu baru untuk kartu yang terkunci secara permanen, dan membuat permintaan pembayaran ulang untuk kartu tersebut.
| Input pengguna | Respons agen |
|---|---|
| Kami mendapati bahwa ada 2 kartu kredit yang terkait dengan nomor Anda. Apakah Anda mencari nomor kartu yang berakhiran 4321? | |
| Ya | |
| Jika sengketa Anda berkaitan dengan penagihan kartu kredit, ucapkan "penagihan kartu kredit". | |
| Penagihan kartu kredit | |
| Apakah Anda ingin mengajukan sengketa terkait biaya kelebihan tagihan atau pengeluaran pada tagihan kartu kredit Anda? | |
| Saya menerima tagihan yang berlebihan | |
| Untuk memulai, dapatkah Anda mengonfirmasikan pada bulan apa potensi masalah tersebut terjadi? | |
| 04 | |
| Dapatkah Anda mengonfirmasi jumlah yang ingin Anda klaim? Misalnya, jika Anda ingin menemukan klaim di atas $100,30, ucapkan "100". | |
| 4567 | |
| Terima kasih. Dapatkah Anda mengonfirmasi deskripsi biaya yang terkait dengan potensi masalah ini? Anda dapat memilih dari biaya tahunan, biaya transaksi, biaya keterlambatan pembayaran, atau biaya lainnya. | |
| Itu adalah biaya tahunan | |
| Anda telah memasukkan jumlah sengketa sebesar $4.567 untuk tanggal 01-04-2023. Apakah Anda ingin mengajukan sengketa terkait kartu kredit Anda? | |
| Ya | |
| Kami telah mengajukan kasus baru terkait sengketa Anda. Nomor kasus Anda adalah 111236 dan telah dibagikan dengan nomor telepon Anda yang terdaftar. Kasus Anda akan diselesaikan dalam waktu 3 hari kerja ke depan. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Sengketa |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_disputes_dispute_type |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_disputes_dispute_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_disputes:get_disputed_transaction |
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 tingkat autentikasi yang diperlukan sebelum pengguna dapat mengakses histori transaksi. 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.card_count | (opsional) Jumlah kartu kredit yang dikaitkan dengan pengguna yang diautentikasi. | bilangan bulat |
| $session.params.account_count | (opsional) Jumlah akun yang dikaitkan dengan nomor telepon terdaftar. Akun ini mencakup akun mandiri dan akun yang kuasanya dimiliki pengguna. | bilangan bulat |
| $session.params.last_four_digit_of_card_number | (opsional) Empat digit terakhir dari nomor kartu yang dapat digunakan untuk mengajukan sengketa. 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.last_four_digit_of_account_number | (opsional) Empat digit terakhir dari nomor rekening pelanggan yang dapat digunakan untuk mengajukan sengketa. 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 |
| $flow.max_gclid_month | Menentukan jumlah bulan maksimum sebelum tanggal saat ini yang diizinkan untuk tanggal transaksi yang disengketakan. Secara default, nilainya adalah -6, yang menunjukkan bahwa sengketa dapat diajukan untuk transaksi tidak lebih dari 6 bulan sebelum tanggal saat ini. |
bilangan bulat |
| $flow.max_attempts | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan sandi sekali pakai (OTP) dari pengguna. Nilai defaultnya adalah 2. |
bilangan bulat |
| flow.max_retry_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan informasi dari pengguna. Nilai defaultnya adalah 2. |
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 |
| card_count | Jumlah kartu kredit yang dikaitkan dengan pengguna terautentikasi. | bilangan bulat |
| 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_card_number | Empat digit terakhir nomor kartu yang digunakan untuk mengajukan sengketa. | string |
| last_four_digit_of_account_number | Empat digit terakhir nomor rekening pelanggan yang disengketakan. | 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_account_services:get_credit_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu kredit yang terdaftar ke 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, 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 |
| last_four_digit_of_credit_card_number | Jika pengguna memiliki satu kartu kredit, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki lebih dari satu kartu, nilai parameter ini adalah null. |
string |
Email yang terdaftar dengan akun. Jika tidak ada email yang terdaftar pada akun, nilai parameter ini 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_account_services:get_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 kredit
Webhook prebuilt_components_disputes:validate_credit_card digunakan oleh komponen untuk memvalidasi bahwa kartu kredit yang ditentukan telah terdaftar ke 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, digunakan untuk mengidentifikasi pengguna. | string |
| $session.params.last_four_digit_of_card_number | Empat digit terakhir nomor kartu yang diajukan pengguna untuk pengajuan sengketa. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| card_found | Menunjukkan apakah kartu yang diminta ada. | boolean |
Untuk mengonfigurasi webhook Validasi 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_violations:validate_credit_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.
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 diminta pengguna untuk mengajukan sengketa. | 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.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_services:validate_account.
- 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 transaksi
Webhook prebuilt_components_disputes:validate_transaction digunakan oleh
komponen untuk memvalidasi apakah transaksi yang ditentukan ada atau tidak.
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 |
| $flow.menyengketakan_type | Jenis transaksi yang disengketakan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_disputes_dispute_type. |
string |
| $flow.menyengketakan_date | Tanggal transaksi yang disengketakan dalam format YYYY-MM-DD. | string |
| $flow.menyengketakan_amount | Jumlah transaksi yang disengketakan. | bilangan bulat |
| $flow.last_four_digits | Empat digit terakhir nomor kartu kredit atau nomor rekening tempat transaksi yang disengketakan. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| transaction_found | Menunjukkan apakah transaksi yang diminta ada. | boolean |
Untuk mengonfigurasi webhook Validasi 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_annotations:validate_transaction.
- 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.
Buat kasus sengketa
Webhook prebuilt_components_disputes:create_dispute_case
digunakan oleh komponen untuk membuat kasus baru atas sengketa.
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 |
| $flow.menyengketakan_type | Jenis sengketa. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_disputes_dispute_type. |
string |
| $flow.menyengketakan_date | Tanggal transaksi yang disengketakan dalam format YYYY-MM-DD. | string |
| $flow.menyengketakan_amount | Jumlah transaksi yang disengketakan. | bilangan bulat |
| $flow.Dispute_reason | Alasan sengketa. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_disputes_dispute_reason. |
string |
| $flow.menyengketakan_fee_type | Jenis biaya untuk sengketa. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_disputes_fee_types. |
string |
| $flow.last_four_digits | Empat digit terakhir nomor kartu kredit atau nomor rekening tempat transaksi yang disengketakan. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| dispute_case_number | Nomor kasus untuk sengketa yang dibuat. | bilangan bulat |
Untuk mengonfigurasi webhook Buat kasus sengketa 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_menyengketakans:create_violation_case.
- 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.