Komponen bawaan sengketa

Komponen bawaan sengketa mengautentikasi pengguna dan memungkinkan mereka menyengketakan atau membantah tagihan, transaksi, dan biaya. Komponen ini menggunakan versi khusus dari komponen bawaan Authentication untuk mengautentikasi pemegang akun dan pemegang kartu. Komponen ini juga menggunakan versi yang disesuaikan dari komponen bawaan Tanggal lahir 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 menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Maksud 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 terdaftar. Agen mengumpulkan informasi tentang sengketa, termasuk nomor akun, mode sengketa, tanggal, dan jumlah, serta 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 Anda. Apakah Anda ingin melanjutkan percakapan ini untuk mengajukan klaim atau sengketa?
Ya, ajukan sengketa
	Beri tahu kami apakah sengketa Anda terkait dengan penagihan atau transaksi kartu kredit.
Ini terkait transaksi saya
	Harap tunggu sementara kami mengambil detail akun Anda. Kami telah menemukan bahwa ada 2 akun yang terkait dengan nomor Anda. Harap beri tahu kami 4 digit terakhir akun yang Anda maksud.
1001
	Terima kasih, 4 digit terakhir yang telah 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 Anda transfer? Misalnya, jika Anda ingin menemukan transaksi di atas Rp1.003.000, ucapkan "100".
15 dolar
	Anda telah memasukkan jumlah sengketa sebesar $15 untuk tanggal 05-0-2023. Apakah Anda ingin mengajukan sengketa di akun Anda?
Ya
	Kami telah membuat kasus baru dengan sengketa Anda. Nomor kasus Anda adalah 448639 dan telah dibagikan ke alamat email terdaftar Anda. Setelah memeriksa informasi yang Anda berikan kepada kami, kami akan mengembalikan dana Anda ke akun Anda yang berakhiran 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 penguncian kartu secara permanen. Kemudian, agen bertanya kepada pengguna apakah mereka ingin menerbitkan ulang kartu baru untuk kartu yang terkunci permanen, dan membuat permintaan penerbitan ulang untuk kartu tersebut.

Input pengguna	Respons agen
	Kami menemukan bahwa ada 2 kartu kredit yang terkait dengan nomor Anda. Apakah Anda mencari nomor kartu yang berakhiran 4321?
Ya
	Jika sengketa Anda terkait dengan penagihan kartu kredit, ucapkan "penagihan kartu kredit".
Penagihan kartu kredit
	Apakah Anda ingin mengajukan sengketa terkait biaya kelebihan tagihan atau biaya pada tagihan kartu kredit Anda?
Saya ditagih biaya yang berlebih
	Untuk memulai, dapatkah Anda mengonfirmasi bulan terjadinya potensi masalah tersebut?
04
	Dapatkah Anda mengonfirmasi jumlah yang ingin Anda klaim? Misalnya, jika Anda ingin menemukan klaim di atas Rp1.003.000, 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 $4567 untuk tanggal 01-04-2023. Apakah Anda ingin mengajukan sengketa atas kartu kredit Anda?
Ya
	Kami telah membuat kasus baru dengan sengketa Anda. Nomor kasus Anda adalah 111236 dan telah dibagikan ke nomor telepon terdaftar Anda. Kasus Anda akan diselesaikan dalam 3 hari kerja ke depan.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Sengketa
Niat 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 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 histori transaksi 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 Jenis autentikasi. Nilai ini dikonfigurasi di preset parameter pengisian 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 pengisian entri halaman di halaman check auth level. Secara default, nilainya adalah false.	boolean
$session.params.phone_number	(opsional) Nomor telepon terdaftar pelanggan yang digunakan untuk autentikasi.	string
$session.params.card_count	(opsional) Jumlah kartu kredit yang terkait dengan pengguna yang diautentikasi.	bilangan bulat
$session.params.account_count	(opsional) Jumlah akun yang terkait dengan nomor telepon terdaftar. Akun ini mencakup akun pribadi dan akun yang pengguna miliki surat kuasanya.	bilangan bulat
$session.params.last_four_digit_of_card_number	(opsional) Empat digit terakhir nomor kartu yang dapat diajukan sengketa. 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.last_four_digit_of_account_number	(opsional) Empat digit terakhir nomor akun pelanggan yang dapat mengajukan sengketa. Jika pelanggan memiliki satu akun, informasi ini akan diambil secara otomatis setelah autentikasi. Jika pelanggan memiliki beberapa akun, nomor akun tertentu akan dikumpulkan dari pelanggan.	string
$flow.max_dispute_month	Menentukan jumlah maksimum bulan sebelum tanggal saat ini yang diizinkan untuk tanggal transaksi yang disengketakan. Secara default, nilai ini 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

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
card_count	Jumlah kartu kredit yang terkait dengan pengguna yang diautentikasi.	bilangan bulat
account_count	Jumlah akun yang terkait dengan nomor telepon terdaftar. Akun ini mencakup akun pribadi dan akun yang pengguna miliki surat kuasanya.	bilangan bulat
last_four_digit_of_card_number	Empat digit terakhir nomor kartu yang menjadi alasan pengajuan sengketa.	string
last_four_digit_of_account_number	Empat digit terakhir nomor akun pelanggan yang mengajukan sengketa.	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_account_services:get_credit_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu kredit yang terdaftar untuk 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, 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
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	Email yang terdaftar di akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter 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_account_services:get_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 kredit

Webhook prebuilt_components_disputes:validate_credit_card digunakan oleh komponen untuk memvalidasi bahwa kartu kredit tertentu terdaftar untuk 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, yang digunakan untuk mengidentifikasi pengguna.	string
$session.params.last_four_digit_of_card_number	Empat digit terakhir nomor kartu yang diminta pengguna untuk mengajukan sengketa.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk 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, 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_disputes:validate_credit_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.

Validasi akun

Webhook prebuilt_components_account_services:validate_account digunakan oleh komponen untuk memverifikasi bahwa akun ada berdasarkan nomor telepon terdaftar pengguna dan empat digit terakhir nomor akun yang diberikan. Webhook juga menampilkan saldo akun, jika akun ada.

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_account_number	Empat digit terakhir nomor rekening yang diminta pengguna untuk mengajukan sengketa.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
account_found	Menunjukkan apakah akun dengan empat digit terakhir yang diberikan ada untuk akun terdaftar pengguna.	boolean
saldo	Jumlah saldo saat ini di akun, jika ada.	angka

Untuk mengonfigurasi webhook Validasi akun 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_account_services:validate_account.
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 transaksi

Webhook prebuilt_components_disputes:validate_transaction digunakan oleh komponen untuk memvalidasi apakah transaksi tertentu ada.

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
$flow.dispute_type	Jenis transaksi yang disengketakan. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_disputes_dispute_type.	string
$flow.dispute_date	Tanggal transaksi yang disengketakan dalam format YYYY-MM-DD.	string
$flow.dispute_amount	Jumlah transaksi yang disengketakan.	bilangan bulat
$flow.last_four_digits	Empat digit terakhir nomor kartu kredit atau rekening yang digunakan untuk transaksi yang disengketakan.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk 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, 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_disputes:validate_transaction.
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.

Buat kasus sengketa

Webhook prebuilt_components_disputes:create_dispute_case digunakan oleh komponen untuk membuat kasus baru untuk 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, yang digunakan untuk mengidentifikasi pengguna.	string
$flow.dispute_type	Jenis sengketa. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_disputes_dispute_type.	string
$flow.dispute_date	Tanggal transaksi yang disengketakan dalam format YYYY-MM-DD.	string
$flow.dispute_amount	Jumlah transaksi yang disengketakan.	bilangan bulat
$flow.dispute_reason	Alasan sengketa. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_disputes_dispute_reason.	string
$flow.dispute_fee_type	Jenis biaya untuk sengketa. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_disputes_fee_types.	string
$flow.last_four_digits	Empat digit terakhir nomor kartu kredit atau rekening yang digunakan untuk transaksi yang disengketakan.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk 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, 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_disputes:create_dispute_case.
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.