Komponen bawaan sengketa

Komponen bawaan sengketa mengautentikasi pengguna dan memungkinkan mereka menyengketakan atau mempermasalahkan tagihan, transaksi, dan biaya.

Komponen ini menggunakan versi yang disesuaikan 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 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.

Pengguna yang tidak diautentikasi dengan sengketa transaksi

  1. Agen mengidentifikasi bahwa pengguna belum diautentikasi sebelumnya dan mengumpulkan informasi untuk memverifikasi bahwa pengguna adalah pemegang akun terdaftar.
  2. Agen mengumpulkan informasi tentang sengketa, termasuk nomor rekening, 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.
Ingat 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
Tunjukkan apakah sengketa Anda terkait dengan penagihan atau transaksi kartu kredit.
Ini terkait transaksi saya
Tunggu sementara kami mengambil detail akun Anda.

Sistem menemukan bahwa ada 2 akun yang terkait dengan nomor Anda. Berikan 4 digit terakhir nomor rekening yang Anda maksud.
1001
Terima kasih, 4 digit terakhir yang dikumpulkan 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 Rp100.000, ucapkan "100 ribu".
15 dolar
Anda telah memasukkan jumlah sengketa sebesar $15 untuk tanggal 01-05-2023. Apakah Anda ingin mengajukan sengketa di akun Anda?
Ya
Kasus baru telah dibuat untuk sengketa Anda. Nomor kasus Anda adalah 448639 dan telah dibagikan ke alamat email terdaftar Anda. Setelah memeriksa informasi yang diberikan, sistem akan mengembalikan dana ke rekening Anda yang berakhiran 1001.

Pengguna terautentikasi dengan sengketa kartu kredit

  1. Agen mengidentifikasi bahwa pengguna sudah diautentikasi dan mengambil informasi tentang kartu yang terdaftar untuk pengguna.
  2. Agen bertanya kepada pengguna apakah mereka ingin mengunci kartu secara permanen.
  3. Agen membuat permintaan untuk mengunci kartu secara permanen.
  4. Agen menanyakan apakah pengguna ingin menerbitkan ulang kartu pengganti.
  5. Jika pengguna setuju, agen akan membuat permintaan penerbitan 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 terkait dengan penagihan kartu kredit, ucapkan "penagihan kartu kredit".
Penagihan kartu kredit
Apakah Anda ingin mengajukan sengketa terkait biaya kelebihan penggunaan atau pengeluaran di tagihan kartu kredit Anda?
Saya dikenai biaya berlebih
Untuk memulai, dapatkah Anda mengonfirmasi pada bulan apa potensi masalah 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.
Merupakan biaya tahunan
Anda telah memasukkan jumlah sengketa sebesar $4.567 untuk tanggal 01-04-2023. Apakah Anda ingin mengajukan sengketa pada kartu kredit Anda?
Ya
Kami telah membuat kasus baru untuk 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

Tabel berikut mencantumkan konvensi penamaan untuk komponen bawaan ini:

Fitur Format Contoh
Flow [Component Name] 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 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 seperti yang dijelaskan di bawah. 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 histori transaksinya. 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 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 parameter presets dari page entry fulfillment 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. integer
$session.params.account_count (opsional) Jumlah akun yang terkait dengan nomor telepon yang terdaftar. Akun ini mencakup akun pribadi dan akun yang surat kuasanya dimiliki oleh pengguna. integer
$session.params.last_four_digit_of_card_number (opsional) Empat digit terakhir nomor kartu yang mungkin disengketakan. 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 nomor rekening pelanggan yang mungkin menjadi objek 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 bulan maksimum 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. integer
$flow.max_attempts Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan sandi sekali pakai (OTP) dari pengguna. Nilai defaultnya adalah 2. integer
$flow.max_retry_counter Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan informasi dari pengguna. Nilai defaultnya adalah 2. integer

Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk melihat 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 Flows.
  6. Klik Start Page di bagian Pages.
  7. Klik Route true di Start Page.
  8. Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
  9. 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
card_count Jumlah kartu kredit yang terkait dengan pengguna yang diautentikasi. integer
account_count Jumlah akun yang terkait dengan nomor telepon terdaftar. Akun ini mencakup akun pribadi dan akun yang surat kuasanya dimiliki oleh pengguna. integer
last_four_digit_of_card_number Empat digit terakhir nomor kartu yang disengketakan. string
last_four_digit_of_account_number Empat digit terakhir nomor rekening pelanggan yang menjadi objek sengketa. string
transfer_reason Parameter ini menunjukkan alasan alur keluar saat 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:

  1. Impor komponen bawaan.
  2. Konfigurasikan webhook fleksibel yang disediakan yang menjelaskan layanan eksternal Anda. Untuk mengetahui informasi selengkapnya, lihat bagian Penyiapan webhook.

Penyiapan webhook

Untuk menggunakan komponen ini, konfigurasikan webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.

Autentikasi

Jika Anda belum mengonfigurasi layanan eksternal yang diperlukan untuk autentikasi, konfigurasikan layanan tersebut untuk mengaktifkan autentikasi pengguna untuk komponen ini. Untuk mengetahui informasi selengkapnya, lihat Penyiapan webhook autentikasi.

Mendapatkan detail kartu kredit

Komponen ini menggunakan webhook prebuilt_components_account_services:get_credit_card_details untuk mengambil informasi tentang kartu kredit yang terdaftar untuk pengguna.

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
last_four_digit_of_credit_card_number Jika pengguna memiliki satu kartu kredit, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki beberapa kartu, nilai parameter ini adalah null. string
email Email yang terdaftar dengan 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 untuk melihat petunjuknya.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_account_services:get_credit_card_details.
  7. Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Memvalidasi kartu kredit

Komponen ini menggunakan webhook prebuilt_components_disputes:validate_credit_card untuk memverifikasi bahwa kartu kredit yang ditentukan terdaftar untuk pengguna.

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 yang diminta pengguna untuk mengajukan sengketa. string

Parameter respons API

Komponen mengambil parameter berikut dari respons API:

Nama Parameter Deskripsi Format Output
card_found Menunjukkan apakah kartu yang diminta ada. boolean

Untuk mengonfigurasi webhook Validate credit card untuk komponen ini, luaskan untuk melihat petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_disputes:validate_credit_card.
  7. Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Memvalidasi akun

Komponen ini menggunakan webhook prebuilt_components_account_services:validate_account untuk memverifikasi bahwa akun ada berdasarkan nomor telepon terdaftar pengguna dan empat digit terakhir nomor rekening yang diberikan. Webhook juga menampilkan saldo akun jika akun ada.

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

Parameter respons API

Komponen mengambil parameter berikut dari respons API:

Nama Parameter Deskripsi Format Output
account_found Menunjukkan apakah akun yang cocok 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, luaskan untuk melihat petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_account_services:validate_account.
  7. Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Memvalidasi transaksi

Komponen ini menggunakan webhook prebuilt_components_disputes:validate_transaction untuk memeriksa apakah transaksi yang ditentukan ada.

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
$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. integer
$flow.last_four_digits Empat digit terakhir nomor kartu kredit atau nomor rekening yang digunakan untuk transaksi yang disengketakan. string

Parameter respons API

Komponen mengambil parameter berikut dari respons API:

Nama Parameter Deskripsi Format Output
transaction_found Menunjukkan apakah transaksi yang diminta ada. boolean

Untuk mengonfigurasi webhook Validate transaction untuk komponen ini, luaskan untuk melihat petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_disputes:validate_transaction.
  7. Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.

Membuat kasus sengketa

Webhook prebuilt_components_disputes:create_dispute_case membuat kasus sengketa baru.

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
$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. integer
$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, jika berlaku. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_disputes_fee_types. string
$flow.last_four_digits Empat digit terakhir nomor kartu kredit atau nomor rekening yang digunakan untuk transaksi yang disengketakan. string

Parameter respons API

Komponen mengambil parameter berikut dari respons API:

Nama Parameter Deskripsi Format Output
dispute_case_number Nomor kasus untuk sengketa yang dibuat. integer

Untuk mengonfigurasi webhook Create dispute case untuk komponen ini, luaskan untuk melihat petunjuk.

  1. Buka konsol Dialogflow CX.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhooks.
  6. Pilih webhook prebuilt_components_disputes:create_dispute_case.
  7. Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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

Komponen bawaan sengketa dan webhook-nya kini telah disiapkan dan siap untuk diuji.