Komponen bawaan kartu kunci mengautentikasi pengguna, mengambil kartu yang terdaftar untuk pengguna, dan memungkinkan mereka mengunci kartu untuk sementara, mengunci kartu secara permanen, atau mengaktifkan kembali kartu. Setelah mengonfirmasi bahwa kartu terkunci, komponen akan memungkinkan pengguna meminta kartu baru.
Komponen ini menggunakan versi yang disesuaikan dari komponen bawaan Autentikasi untuk mengautentikasi pemegang kartu.
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 beberapa kartu
- Agen mengidentifikasi bahwa pengguna belum diautentikasi dan mengumpulkan informasi untuk memverifikasi bahwa pengguna adalah pemegang kartu terdaftar.
- Setelah pengguna melakukan autentikasi, agen akan mengambil informasi tentang kartu yang terdaftar untuk pengguna.
- Pengguna mengonfirmasi bahwa dia ingin mengunci sementara kartu yang dipilih.
- Agen 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 dengan nomor akhir 5555, Visa dengan nomor akhir 6666, MasterCard dengan nomor akhir 4444, dan MasterCard dengan nomor akhir 4449. Beri tahu kami 4 digit terakhir kartu yang ingin Anda kunci atau aktifkan kembali. |
|
| 4444 | |
| Empat digit terakhir nomor kartu yang kami dapatkan adalah 4444, apakah itu benar? | |
| Ya | |
| Apakah Anda ingin mengunci kartu Anda untuk sementara atau secara permanen? | |
| Saya ingin menguncinya untuk sementara | |
| Beri tahu kami alasan Anda mengunci kartu. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya. | |
| Perangkat rusak | |
| Kami mohon maaf. 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? | |
| Kirim ke ponsel saya | |
| Oke, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Dapatkah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan? | |
| 123456 | |
| Oke, kartu Anda yang berakhiran 4444 akan dikunci untuk sementara. Setelah dikunci, Anda tidak akan dapat melakukan transaksi apa pun secara online atau di mesin POS dengan kartu tersebut. Apakah Anda setuju dengan tindakan ini? | |
| Ya | |
| Kartu Anda berhasil dikunci. Nomor permintaan Anda adalah 9711485 dan telah berhasil dibagikan ke nomor ponsel Anda yang terdaftar. |
Pengguna yang diautentikasi 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.
- Agen membuat permintaan penguncian kartu secara permanen.
- Kemudian, agen akan bertanya kepada pengguna apakah mereka ingin menerbitkan ulang kartu baru untuk kartu yang terkunci secara permanen, dan membuat permintaan penerbitan ulang untuk kartu tersebut.
| Input Pengguna | Respons Agen |
|---|---|
| Harap tunggu sementara kami mengambil detail kartu Anda. Kami telah menemukan MasterCard Anda yang berakhiran 4444. Apakah Anda ingin mengunci kartu Anda untuk sementara atau secara permanen? |
|
| Permanen | |
| Beri tahu kami alasan Anda mengunci kartu. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya. | |
| Perangkat dalam kondisi rusak | |
| Kami mohon maaf. Jangan khawatir, kami akan mengunci kartu Anda secara permanen. Dapatkah Anda mengonfirmasi apakah kartu tersebut berakhiran 4444? | |
| Ya | |
| Oke, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Dapatkah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan? | |
| 123456 | |
| Oke, kartu Anda yang berakhiran 4444 akan dikunci untuk sementara. Setelah dikunci, Anda tidak akan dapat melakukan transaksi apa pun secara online atau di mesin POS dengan kartu tersebut. Apakah Anda setuju dengan tindakan ini? | |
| Ya | |
| Kartu Anda berhasil dikunci. Nomor permintaan Anda adalah 6108410 dan telah berhasil dibagikan ke nomor ponsel Anda yang terdaftar. Ingin menerbitkan ulang kartu baru? |
|
| Ya | |
| Kami akan mengirimkan kartu ke alamat terdaftar Anda. Bisakah Anda mengonfirmasi kode pos alamat pengiriman Anda 12345? | |
| Tepat | |
| Oke, harap tunggu beberapa detik selagi kami mengajukan permintaan untuk menerbitkan ulang kartu baru. Permintaan penerbitan ulang kartu baru berhasil. Nomor permintaan Anda adalah 3808109 dan telah berhasil dibagikan ke nomor ponsel Anda yang terdaftar. Kartu akan dikirim ke alamat Anda yang terdaftar dalam 3 hari kerja. Untuk menggunakan kartu, ikuti petunjuk yang diberikan bersama kartu. |
Aktifkan kembali kartu
- Agen mengidentifikasi bahwa pengguna memerlukan autentikasi tambahan dan mengirimkan sandi sekali pakai untuk memverifikasi identitas pengguna.
- Pengguna meminta untuk mengaktifkan kembali kartu.
- Agen mengalihkan pengguna 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 lebih suka menerima kode melalui telepon? | |
| Ya | |
| Kami telah mengirimkan kode ke nomor telepon terdaftar Anda yang berakhiran 5041. Proses ini mungkin perlu waktu beberapa detik. Dapatkah Anda mengonfirmasi kodenya? | |
| 123456 | |
| Terima kasih, Anda telah berhasil divalidasi. Harap tunggu selagi kami mengambil detail kartu Anda. Kami telah menemukan beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki Visa dengan akhiran 1456, MasterCard dengan akhiran 1457, American Express dengan akhiran 1345, dan Visa dengan akhiran 3456. Beri tahu kami 4 digit terakhir kartu yang ingin Anda kunci atau aktifkan kembali. |
|
| 1456 | |
| Empat digit terakhir nomor kartu yang kami 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 selagi kami mengalihkan panggilan Anda agar dapat membantu Anda dengan lebih baik. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Component Name] | Kunci Kartu |
| 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 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. 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 detail kartunya. 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 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 parameter presets dari page entry fulfillment 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. | integer |
| $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.card_status_reactivate | Menentukan nilai parameter yang ditampilkan oleh Webhook validasi kartu untuk menunjukkan bahwa kartu yang dipilih 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. |
integer |
| $flow.max_otp_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan sandi sekali pakai (OTP) dari pengguna. Nilai defaultnya adalah 3. |
integer |
Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flows.
- Klik Start Page di bagian Pages.
- Klik Route true di Start Page.
- Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
- 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 yang terkait dengan nomor telepon terdaftar pengguna. | integer |
| last_four_digit_of_card_number | Jika pengguna memiliki satu kartu, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki beberapa kartu, nilai parameter ini adalah empat digit terakhir kartu yang dipilih pengguna untuk dikunci atau diterbitkan ulang. | string |
| transfer_reason | Menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari berikut ini: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:
- Impor komponen bawaan.
- Konfigurasikan webhook fleksibel yang disediakan dengan setelan 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 panduan Penyiapan webhook autentikasi.
Mendapatkan detail kartu
Webhook prebuilt_components_account_services:get_card_details memungkinkan
komponen mengambil informasi tentang kartu 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 |
|---|---|---|
| last_four_digit_of_all_cards | Daftar yang berisi empat digit terakhir dari setiap kartu yang terdaftar untuk pengguna, misalnya ["0000", "1111", "2222"]. Setiap elemen dalam daftar ini mewakili 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 untuk pengguna, misalnya ["Visa", "Mastercard", "Discover"]. Setiap elemen dalam daftar ini mewakili 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. | integer |
Untuk mengonfigurasi webhook Dapatkan detail kartu untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_account_services:get_card_details.
- Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.
Memvalidasi kartu
Komponen ini menggunakan webhook prebuilt_components_lock_card:validate_card
untuk mengambil informasi tentang kartu tertentu yang terdaftar di akun 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 dikunci. | string |
Parameter respons API
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| zip_code | Kode pos alamat terdaftar 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 Validate card untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_lock_card:validate_card.
- Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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_lock_card:lock_card_ticket_number memungkinkan
komponen membuat permintaan untuk mengunci kartu yang dipilih.
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 dikunci. | string |
| $flow.lock_type | Menunjukkan jenis kunci yang akan diterapkan ke kartu pengguna. Nilai yang valid ditentukan oleh entity 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 dikunci. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_lock_card_locked_reason. Secara default, "damaged", "stolen", "lost", dan "others" didukung. |
string |
Parameter respons API
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| ticket_number | Nomor tiket untuk permintaan kartu kunci yang dibuat. | integer |
Untuk mengonfigurasi webhook Lock card untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_lock_card:lock_card_ticket_number.
- Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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.
Terbitkan ulang kartu
Webhook prebuilt_components_lock_card:reissue_card_number memungkinkan
komponen membuat permintaan untuk menerbitkan ulang kartu baru atau yang diupgrade.
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 dikunci. | string |
| zip_code | Kode pos alamat terdaftar pengguna. | string |
Parameter respons API
Komponen mengambil parameter berikut dari respons API:
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| acknowledgement_number | Nomor tiket untuk permintaan penerbitan ulang kartu yang dibuat. | integer |
Untuk mengonfigurasi webhook Kartu penerbitan ulang untuk komponen ini, luaskan untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhooks.
- Pilih webhook prebuilt_components_lock_card:reissue_card_number.
- Ganti URL di kolom URL webhook Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di 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
Komponen bawaan Lock card dan webhook-nya kini telah disiapkan dan siap diuji.