Komponen bawaan kartu kunci mengautentikasi pengguna, mengambil kartu yang terdaftar untuk pengguna, dan memungkinkan pengguna mengunci kartu untuk sementara, mengunci kartu secara permanen, atau mengaktifkan kembali kartu. Setelah mengonfirmasi kartu yang terkunci, komponen memungkinkan pengguna meminta kartu baru. Komponen ini menggunakan versi kustom komponen Autentikasi bawaan 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 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 beberapa kartu
Agen mengidentifikasi bahwa pengguna belum pernah diautentikasi sebelumnya dan mengumpulkan informasi untuk memverifikasi bahwa pengguna tersebut adalah pemegang kartu terdaftar. Setelah pengguna melakukan autentikasi, agen akan mengambil informasi tentang kartu yang terdaftar untuk pengguna. Pengguna mengonfirmasi bahwa mereka ingin mengunci kartu yang dipilih untuk sementara, dan agen akan membuat permintaan kartu kunci.
| 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 beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki Visa yang berakhiran 5555, Visa yang diakhiri dengan 6666, MasterCard yang berakhiran 4444, dan MasterCard yang berakhiran 4449. Beri tahu kami 4 digit terakhir kartu yang ingin Anda kunci atau aktifkan kembali. |
|
| 4444 | |
| Empat digit terakhir dari nomor kartu yang kita dapatkan adalah 4444, apakah itu benar? | |
| Ya | |
| Apakah Anda ingin mengunci kartu untuk sementara atau secara permanen? | |
| Saya ingin menguncinya untuk sementara | |
| Beri tahu kami mengapa Anda mengunci kartu. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya. | |
| Ada kerusakan | |
| Maaf atas masalah ini. Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda lebih suka menerima kode melalui telepon atau email? | |
| Kirimkan ke ponsel saya | |
| Oke, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Bisakah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan tersebut? | |
| 123456 | |
| Oke, kartu Anda yang berakhiran 4444 akan dikunci sementara. Setelah kartu terkunci, Anda tidak akan dapat melakukan transaksi apa pun secara online atau di mesin POS dengan kartu tersebut. Apakah Anda mengonfirmasi tindakan ini? | |
| Ya | |
| Kartu Anda berhasil dikunci. Nomor permintaan Anda adalah 9711485 dan berhasil dibagikan dengan nomor ponsel Anda yang terdaftar. |
Pengguna terautentikasi dengan satu kartu
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 |
|---|---|
| Harap tunggu sementara kami mengambil detail kartu Anda. Kami menemukan bahwa MasterCard Anda yang berakhiran 4444. Apakah Anda ingin mengunci kartu untuk sementara atau secara permanen? |
|
| Permanen | |
| Beri tahu kami mengapa Anda mengunci kartu. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya. | |
| Item rusak | |
| Maaf atas masalah ini. Jangan khawatir, kami akan mengunci kartu Anda secara permanen. Dapatkah Anda mengonfirmasi apakah kartu diakhiri dengan 4444? | |
| Ya | |
| Oke, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Bisakah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan tersebut? | |
| 123456 | |
| Oke, kartu Anda yang berakhiran 4444 akan dikunci sementara. Setelah kartu terkunci, Anda tidak akan dapat melakukan transaksi apa pun secara online atau di mesin POS dengan kartu tersebut. Apakah Anda mengonfirmasi tindakan ini? | |
| Ya | |
| Kartu Anda berhasil dikunci. Nomor permintaan Anda adalah 6108410 dan berhasil dibagikan dengan nomor ponsel Anda yang terdaftar. Ingin menerbitkan ulang kartu baru? |
|
| Ya | |
| Kami akan mengirimkan kartu ke alamat Anda yang terdaftar. Harap konfirmasi alamat pengiriman Anda untuk kode pos 12345? | |
| Tepat sekali | |
| Oke, harap tunggu beberapa detik sementara kami mengajukan permintaan untuk menerbitkan kembali kartu baru. Permintaan pembayaran ulang untuk kartu baru berhasil. Nomor permintaan Anda adalah 3808109 dan berhasil dibagikan dengan nomor ponsel Anda yang terdaftar. Kartu akan dikirim ke alamat terdaftar Anda dalam 3 hari kerja. Untuk menggunakan kartu, ikuti petunjuk yang dibagikan dengan kartu tersebut. |
Aktifkan kembali kartu
Agen mengidentifikasi bahwa pengguna memerlukan autentikasi tambahan dan mengirim sandi sekali pakai untuk memverifikasi identitas pengguna. Pengguna meminta untuk mengaktifkan kembali kartu, dan agen mentransfernya ke agen manusia untuk melanjutkan.
| Input pengguna | Respons agen |
|---|---|
| Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda memilih untuk menerima kode melalui telepon? | |
| Ya | |
| Kami telah mengirimkan kode ke nomor telepon terdaftar Anda yang diakhiri dengan 5041. Proses ini mungkin perlu waktu beberapa detik. Bisakah Anda mengonfirmasi kodenya? | |
| 123456 | |
| Terima kasih, Anda telah berhasil divalidasi. Harap tunggu sementara kami mengambil detail kartu Anda. Kami telah menemukan beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki Visa yang diakhiri dengan 1456, MasterCard dengan akhiran 1457, American Express yang berakhiran 1345, dan Visa yang diakhiri dengan 3456. Beri tahu kami 4 digit terakhir kartu yang ingin Anda kunci atau aktifkan kembali. |
|
| 1456 | |
| Empat digit terakhir nomor kartu yang kita dapatkan adalah 1456, apakah itu benar? | |
| Ya | |
| Kartu yang diminta sudah dalam status terkunci sementara. Apakah Anda ingin mengaktifkan kembali kartu, atau memblokirnya secara permanen? | |
| Aktifkan kembali | |
| Harap tunggu sementara kami mentransfer panggilan Anda untuk membantu Anda dengan lebih baik. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Kartu Kunci |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_lock_card_locked_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_lock_card:lock_card_ticket_number |
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 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 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.card_count | (opsional) Jumlah kartu kredit yang dikaitkan dengan pengguna yang diautentikasi. | bilangan bulat |
| $flow.card_status_active | Menentukan nilai parameter yang ditampilkan oleh Validasi webhook 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 Validasi webhook kartu untuk menunjukkan bahwa kartu yang dipilih dikunci untuk sementara. Secara default, nilainya adalah "inactive". |
string |
| $flow.card_status_lock_permanent | Menentukan nilai parameter yang ditampilkan oleh Validasi webhook kartu untuk menunjukkan bahwa kartu yang dipilih terkunci secara permanen. Secara default, nilainya adalah "blocked". |
string |
| $flow.card_status_reactivate | Menentukan nilai parameter yang ditampilkan oleh Validasi webhook kartu untuk menunjukkan bahwa kartu yang dipilih telah diaktifkan kembali. Secara default, nilainya adalah "reactivate". |
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 |
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 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 kartu yang dipilih pengguna untuk dikunci atau menerbitkan ulang kartunya. | 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
Webhook prebuilt_components_account_services:get_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu yang didaftarkan 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 |
|---|---|---|
| last_four_digit_of_all_cards | Daftar berisi empat digit terakhir dari setiap kartu yang didaftarkan kepada pengguna, misalnya ["0000", "1111", "2222"]. Setiap elemen dalam daftar ini mewakili kartu yang sama dengan elemen dengan indeks yang sama di card_vendor_all. |
Daftar (string) |
| card_vendor_all | Daftar yang berisi vendor kartu kredit untuk setiap kartu yang didaftarkan untuk pengguna, misalnya ["Visa", "Mastercard", "Discover"]. Setiap elemen dalam daftar ini mewakili kartu yang sama dengan elemen dengan indeks yang sama di last_four_digit_of_all_cards. |
Daftar (string) |
| card_count | Jumlah kartu yang dikaitkan dengan pengguna terautentikasi. | bilangan bulat |
Untuk mengonfigurasi webhook Dapatkan detail kartu 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_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_lock_card:validate_card digunakan oleh komponen untuk mendapatkan informasi tentang kartu tertentu yang terdaftar ke 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, 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 yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| zip_code | Kode pos yang terdaftar pada 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 secara 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 |
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_lock_card: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.
Kunci kartu
Webhook prebuilt_components_lock_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, 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 ke kartu pengguna. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_lock_card_lock_type_active. Secara default, "blocked" (kunci permanen) dan "inactive (kunci sementara) didukung. |
string |
| $flow.lock_reason | Menunjukkan alasan pengguna meminta kartu untuk dikunci. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_lock_card_locked_reason. Secara default, "damaged", "stolen", "lost", dan "others" didukung. |
string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| ticket_number | Nomor tiket untuk permintaan kartu kunci yang dibuat. | bilangan bulat |
Guna mengonfigurasi webhook Kartu kunci 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_lock_card:lock_card_ticket_number.
- 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.
Pembayaran ulang kartu
Webhook prebuilt_components_lock_card:reissue_card_number
digunakan oleh komponen untuk membuat permintaan guna menerbitkan 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, 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 pada akun pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| acknowledgement_number | Nomor tiket untuk permintaan kartu pembayaran ulang yang dibuat. | bilangan bulat |
Guna mengonfigurasi webhook kartu Ulang 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_lock_card:reissue_card_number.
- 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.