Komponen bawaan kartu kunci

Komponen bawaan kunci kartu akan mengautentikasi pengguna, mengambil kartu yang terdaftar ke pengguna, dan memungkinkan pengguna mengunci kartu untuk sementara, mengunci kartu secara permanen, atau mengaktifkan kembali kartu. Setelah mengonfirmasi kartu yang terkunci, komponen ini 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 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 Intent Selamat Datang Default dan respons agen pertama di awal percakapan.

Pengguna yang tidak diautentikasi dengan beberapa kartu

Agen mengidentifikasi bahwa pengguna belum diautentikasi sebelumnya 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 mereka ingin mengunci sementara kartu yang dipilih, dan agen membuat permintaan kunci kartu.

Input pengguna Respons agen
Agen mengautentikasi pengguna menggunakan komponen bawaan Autentikasi
Terima kasih, Anda telah berhasil diautentikasi.
Harap tunggu sementara kami mengambil detail kartu Anda.

Kami menemukan beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki kartu Visa yang berakhiran 5555, kartu Visa yang berakhiran 6666, kartu MasterCard yang berakhiran 4444, dan kartu MasterCard yang berakhiran 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 benar?
Ya
Apakah Anda ingin mengunci kartu Anda untuk sementara atau secara permanen?
Saya ingin menguncinya sementara
Beri tahu kami alasan Anda mengunci kartu. Anda dapat memilih dari opsi seperti rusak, dicuri, hilang, atau lainnya.
Rusak
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?
Kirim ke ponsel saya
Baik, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Dapatkah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan?
123456
Baik, kartu Anda yang diakhiri dengan 4444 akan dikunci untuk sementara. Setelah 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 telah berhasil dibagikan ke 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 kunci kartu secara permanen. Agen kemudian 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 selagi 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.
Rusak
Maaf atas masalah ini. Jangan khawatir, kami akan mengunci kartu Anda secara permanen. Dapatkah Anda mengonfirmasi apakah kartu berakhir dengan 4444?
Ya
Baik, sebelum melanjutkan, kami akan mengirimkan kode ke nomor ponsel Anda yang terdaftar. Dapatkah Anda mengonfirmasi kode Anda untuk memvalidasi permintaan?
123456
Baik, kartu Anda yang diakhiri dengan 4444 akan dikunci untuk sementara. Setelah 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 telah berhasil dibagikan ke nomor ponsel yang terdaftar.

Apakah Anda ingin menerbitkan ulang kartu baru?
Ya
Kami akan mengirimkan kartu ke alamat terdaftar Anda. Dapatkah Anda mengonfirmasi kode pos alamat pengiriman Anda, 12345?
Benar
Baik, 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 yang terdaftar.

Kartu akan dikirim ke alamat terdaftar Anda dalam 3 hari kerja. Untuk menggunakan kartu, ikuti petunjuk yang disertakan dengan kartu.

Mengaktifkan kembali kartu

Agen mengidentifikasi bahwa pengguna memerlukan autentikasi tambahan dan mengirimkan 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 lebih suka menerima kode melalui telepon?
Ya
Kami telah mengirimkan kode ke nomor telepon terdaftar Anda yang berakhiran 5041. Proses ini mungkin memerlukan waktu beberapa detik. Dapatkah Anda mengonfirmasi kodenya?
123456
Terima kasih, Anda telah berhasil divalidasi.

Harap tunggu sementara kami mengambil detail kartu Anda.

Kami menemukan beberapa kartu yang terdaftar dengan nomor Anda. Kami memiliki kartu Visa yang berakhiran 1456, kartu MasterCard yang berakhiran 1457, kartu American Express yang berakhiran 1345, dan kartu Visa yang berakhiran 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 benar?
Ya
Kartu yang diminta sudah dalam status terkunci sementara. Apakah Anda ingin mengaktifkan kembali kartu, atau memblokirnya secara permanen?
Mengaktifkannya kembali
Harap tunggu sejenak saat kami mengalihkan panggilan Anda untuk membantu Anda dengan lebih baik.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur Format Contoh
Flow [Component Name] Mengunci 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 adalah parameter yang digunakan untuk mengonfigurasi perilaku tertentu dari 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 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 transaksinya. Nilai ini dikonfigurasi di preset parameter dari 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 dari 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 dari fulfillment 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 untuk 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. 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, luaskan 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 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 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 pada suatu saat 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 yang tidak cocok. 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 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 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 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, 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 ke 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 terdaftar ke 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 terkait dengan pengguna yang diautentikasi. bilangan bulat

Untuk mengonfigurasi webhook Get card details 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 Webhook.
  6. Pilih webhook prebuilt_components_account_services:get_card_details.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Memvalidasi 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, 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 ke 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 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

Untuk mengonfigurasi webhook Validasi kartu untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  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_lock_card:validate_card.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Mengunci 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, 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 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 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 untuk digunakan oleh komponen.

Nama Parameter Deskripsi Format Output
ticket_number Nomor tiket untuk permintaan kartu kunci yang dibuat. bilangan bulat

Untuk mengonfigurasi webhook Lock card untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  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_lock_card:lock_card_ticket_number.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Menerbitkan 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, 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 ke akun pengguna. 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 kartu yang dibuat ulang. bilangan bulat

Untuk mengonfigurasi webhook Kartu cetak ulang untuk komponen ini, luaskan untuk mendapatkan petunjuk.

  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_lock_card:reissue_card_number.
  7. Ganti URL di kolom Webhook URL Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi webhook Anda.
  9. 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.
  10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
  11. Klik Simpan.

Selesai

Agen dan webhook-nya kini telah disiapkan dan siap diuji.