Komponen bawaan kartu hilang dan dicuri mengautentikasi pengguna, mengambil kartu yang terdaftar untuk pengguna, dan memungkinkan pengguna mengunci kartu. Setelah mengonfirmasi kartu terkunci, komponen ini memungkinkan pengguna mendaftar untuk upgrade atau menerbitkan ulang kartu baru. Komponen ini menggunakan versi khusus dari komponen bawaan Authentication untuk mengautentikasi pemegang kartu.
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 satu kartu
Agen mengidentifikasi bahwa pengguna belum pernah diautentikasi sebelumnya dan mengumpulkan informasi untuk memverifikasi bahwa pengguna adalah pemegang kartu terdaftar. Setelah pengguna melakukan autentikasi, agen akan mengambil informasi tentang satu kartu yang terdaftar untuk pengguna. Pengguna mengonfirmasi bahwa dia ingin mengunci kartu, agen mengunci kartu. Terakhir, agen mengonfirmasi kartu pilihan dan alamat pengiriman pengguna, lalu menerbitkan ulang kartu baru 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 kartu MasterCard Anda yang berakhiran 4444. Apakah Anda ingin mengunci kartu Anda secara permanen? |
|
| Ya | |
| Beri tahu kami alasan Anda mengunci kartu Anda. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya. | |
| Kartu saya hilang | |
| Terima kasih atas masukan Anda. Kami akan membantu Anda mengunci kartu Anda secara permanen. Dapatkah Anda mengonfirmasi apakah kartu tersebut berakhir dengan 4444? | |
| Ya | |
| Oke, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Sebutkan kode untuk memvalidasi permintaan. | |
| 123457 | |
| Oke, kartu Anda yang berakhiran 4444 akan dikunci secara permanen. Setelah dikunci, Anda tidak akan dapat melakukan transaksi online atau di mesin POS dengan kartu tersebut. Apakah Anda mengonfirmasi tindakan ini? | |
| Ya | |
| Kartu Anda berhasil dikunci. Nomor permintaan Anda adalah 9761431 dan telah berhasil dibagikan ke nomor ponsel Anda yang terdaftar. Ingin menerbitkan ulang kartu baru? | |
| Ya | |
| Anda memenuhi syarat untuk mendapatkan kartu platinum. Biaya tahunannya adalah 97 dolar, dan Anda bisa mendapatkan bonus tahunan dan manfaat khusus senilai 494 dolar. Klik link yang dikirim ke nomor ponsel terdaftar Anda untuk mempelajari lebih lanjut. Apakah Anda ingin mendaftar untuk kartu ini? |
|
| Ya | |
| Kami akan mengirimkan kartu ke alamat terdaftar Anda. Dapatkah Anda mengonfirmasi bahwa kode pos alamat pengiriman Anda adalah 12345? | |
| Ya | |
| Oke, tunggu beberapa detik selagi kami mengajukan permintaan penerbitan ulang kartu baru. Permintaan penerbitan ulang kartu baru telah berhasil. Nomor permintaan Anda adalah 4643943 dan telah berhasil dibagikan ke nomor ponsel terdaftar Anda. Kartu akan dikirimkan ke alamat terdaftar Anda dalam 3 hari kerja. Untuk menggunakan kartu, ikuti petunjuk yang dibagikan bersama kartu. |
Pengguna terautentikasi dengan beberapa kartu
Agen mengidentifikasi bahwa pengguna telah diautentikasi sebelumnya dan mengambil informasi tentang kartu yang terdaftar untuk pengguna. Pengguna memilih kartu yang telah dikunci sebelumnya, sehingga agen mengizinkan pengguna untuk meminta kartu baru.
| Input pengguna | Respons agen |
|---|---|
| Harap tunggu sementara kami mengambil detail kartu Anda. Kami telah menemukan beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki kartu Visa yang berakhiran 1456, MasterCard yang berakhiran 1457, MasterCard yang berakhiran 1345, dan Visa yang berakhiran 3456 Beri tahu kami 4 digit terakhir kartu yang ingin Anda kunci. |
|
| 1457 | |
| Empat digit terakhir nomor kartu yang kami dapatkan adalah 1457, apakah benar? | |
| Ya | |
| Kartu yang diminta sudah dalam status terkunci permanen. Ingin menerbitkan ulang kartu baru? | |
| Ya | |
| Kami akan mengirimkan kartu ke alamat terdaftar Anda. Dapatkah Anda mengonfirmasi bahwa kode pos alamat pengiriman Anda adalah 12345? | |
| Ya | |
| Oke, tunggu beberapa detik selagi kami mengajukan permintaan penerbitan ulang kartu baru. Permintaan penerbitan ulang kartu baru telah berhasil. Nomor permintaan Anda adalah 5423270 dan telah berhasil dibagikan ke nomor ponsel terdaftar Anda. Kartu akan dikirimkan ke alamat terdaftar Anda dalam 3 hari kerja. Untuk menggunakan kartu, ikuti petunjuk yang dibagikan bersama kartu. Apakah Anda ingin memblokir kartu lain? |
|
| Tidak, itu saja dari saya | |
| Oke, terima kasih telah menghubungi kami. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Kartu Hilang & Dicuri |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lost_and_stolen_lock_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lost_and_stolen_card:lock_card_ticket_number |
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 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 preset parameter pengisian entri halaman 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.card_count | (opsional) Jumlah kartu kredit yang terkait dengan pengguna yang diautentikasi. | bilangan bulat |
| $flow.card_status_active | Menentukan nilai parameter yang ditampilkan oleh Webhook validasi kartu untuk menunjukkan bahwa kartu yang dipilih saat ini aktif. Secara default, nilainya adalah "active". |
string |
| $flow.card_status_lock_temp | Menentukan nilai parameter yang ditampilkan oleh Webhook validasi kartu untuk menunjukkan bahwa kartu yang dipilih dikunci sementara. Secara default, nilainya adalah "inactive". |
string |
| $flow.card_status_lock_permanent | Menentukan nilai parameter yang ditampilkan oleh Webhook validasi kartu untuk menunjukkan bahwa kartu yang dipilih dikunci secara permanen. Secara default, nilainya adalah "blocked". |
string |
| $flow.max_retry_card_number | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan empat digit terakhir kartu kredit. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_otp_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan sandi sekali pakai (OTP) dari pengguna. Nilai defaultnya adalah 3. |
bilangan bulat |
Untuk mengonfigurasi parameter input untuk komponen ini, perluas untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Alur.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute true di Halaman Mulai.
- Di jendela Rute, edit nilai Preset 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 tingkat autentikasi pemanggil. | bilangan bulat |
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | string |
| card_count | Jumlah kartu yang terkait dengan nomor telepon 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 kartu yang dipilih pengguna untuk mengunci atau menerbitkan ulang kartu baru. | 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:
- Impor komponen bawaan.
- 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
Webhook prebuilt_components_account_services:get_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu 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 |
|---|---|---|
| last_four_digit_of_all_cards | Daftar yang berisi empat digit terakhir setiap kartu yang terdaftar untuk pengguna, misalnya ["0000", "1111", "2222"]. Setiap elemen dalam daftar ini merepresentasikan kartu yang sama dengan elemen yang memiliki indeks yang sama di card_vendor_all. |
Daftar (string) |
| card_vendor_all | Daftar yang berisi vendor kartu kredit untuk setiap kartu yang terdaftar pada pengguna, misalnya ["Visa", "Mastercard", "Discover"]. Setiap elemen dalam daftar ini merepresentasikan kartu yang sama dengan elemen yang memiliki indeks yang sama di last_four_digit_of_all_cards. |
Daftar (string) |
| card_count | Jumlah kartu yang terkait dengan pengguna yang diautentikasi. | bilangan bulat |
Untuk mengonfigurasi webhook Dapatkan detail kartu untuk komponen ini, luaskan petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_account_services:get_card_details.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu 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.
Validasi kartu
Webhook prebuilt_components_lost_and_stolen_card:validate_card digunakan oleh komponen untuk mendapatkan informasi tentang kartu tertentu yang terdaftar di akun 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 dikunci. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| zip_code | Kode pos yang terdaftar di akun pengguna. | string |
| card_vendor | Vendor kartu kredit untuk kartu yang dipilih. | string |
| card_status | Menunjukkan status kartu saat ini. Secara default, nilai yang valid adalah aktif, diblokir sementara, atau diblokir permanen. Status ini ditentukan oleh parameter $flow.card_status_active, $flow.card_status_lock_temp, dan $flow.card_status_lock_permanent. Lihat parameter input. |
string |
| card_upgrade | Menunjukkan apakah upgrade tersedia untuk kartu yang dipilih. | boolean |
| card_upgrade_type | Menentukan jenis upgrade kartu yang tersedia, misalnya "gold" atau "platinum". Jika card_upgrade adalah false, parameter ini tidak diperlukan. |
string |
| card_upgrade_annual_fee | Menentukan jumlah biaya tahunan dalam dolar yang diperlukan untuk upgrade kartu, misalnya 150. Jika card_upgrade adalah false, parameter ini tidak diperlukan. |
angka |
| card_upgrade_benefit | Menentukan jumlah manfaat dalam dolar yang tersedia untuk upgrade kartu, misalnya 450. Jika card_upgrade adalah false, parameter ini tidak diperlukan. |
angka |
| reissue_status | Menunjukkan apakah kartu baru telah diterbitkan ulang untuk kartu ini. | boolean |
| dispatch_status | Menunjukkan apakah kartu yang diterbitkan ulang telah dikirim ke alamat terdaftar. Jika reissue_status adalah false, dispatch_status harus false. |
boolean |
| card_estimated_duration | Estimasi jangka waktu pengiriman kartu baru, misalnya "2 days" atau "24 hours". Jika reissue_status adalah false, parameter ini tidak diperlukan. |
string |
Untuk mengonfigurasi webhook Validasi kartu untuk komponen ini, perluas petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_lost_and_stolen_card:validate_card.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu 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.
Mengunci kartu
Webhook prebuilt_components_lost_and_stolen_card:lock_card_ticket_number
digunakan oleh komponen untuk membuat permintaan guna mengunci kartu yang dipilih.
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 dikunci. | string |
| $flow.lock_type | Menunjukkan jenis kunci yang akan diterapkan pada kartu pengguna. Secara default, komponen ini mendukung penguncian permanen untuk kartu yang hilang dan dicuri. Jenis kunci yang valid ditentukan oleh parameter $flow.card_status_active, $flow.card_status_lock_temp, dan $flow.card_status_lock_permanent. Lihat parameter input. |
string |
| $flow.lock_reason | Menunjukkan alasan pengguna meminta kartu dikunci. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_lost_and_stolen_lock_reason. Secara default, "damaged", "stolen", "lost", dan "others" didukung. |
string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| ticket_number | Nomor tiket untuk permintaan kartu kunci yang dibuat. | bilangan bulat |
Untuk mengonfigurasi webhook kartu Kunci untuk komponen ini, perluas petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_lost_and_stolen_card:lock_card_ticket_number.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu 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.
Menerbitkan ulang kartu
Webhook prebuilt_components_lost_and_stolen_card:reissue_card_number digunakan oleh komponen untuk membuat permintaan penerbitan ulang kartu baru atau yang diupgrade.
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 dikunci. | string |
| zip_code | Kode pos yang terdaftar di akun pengguna. | string |
| card_upgrade | Menunjukkan apakah pengguna memilih untuk mengupgrade kartunya. | boolean |
| card_upgrade_type | Menentukan jenis upgrade kartu yang dipilih oleh pengguna, misalnya "gold" atau "platinum". Jika card_upgrade adalah false, parameter ini tidak diperlukan. |
string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| acknowledgement_number | Nomor tiket untuk permintaan penerbitan ulang kartu yang dibuat. | bilangan bulat |
Untuk mengonfigurasi webhook Terbitkan ulang kartu untuk komponen ini, perluas petunjuknya.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_lost_and_stolen_card:reissue_card_number.
- Ganti URL di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu 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
Agen dan webhook-nya kini telah disiapkan dan siap diuji.