Komponen bawaan autentikasi mengumpulkan informasi dari pengguna untuk mengautentikasi mereka ke tingkat autentikasi yang diperlukan. Komponen ini mencakup persyaratan autentikasi yang umum, tetapi tidak eksklusif, untuk industri jasa keuangan (FSI). Komponen ini menggunakan komponen bawaan Pengumpulan tanggal habis masa berlaku kartu kredit, Pengumpulan tanggal lahir, dan Pengumpulan nomor telepon untuk mengumpulkan dan memvalidasi detail pengguna.
Tingkat autentikasi
Ada beberapa tingkat autentikasi yang diperlukan oleh berbagai komponen bawaan, dengan tingkat yang lebih tinggi memerlukan lebih banyak informasi pengguna untuk mengautentikasi pengguna. Komponen Autentikasi memungkinkan pengguna melakukan autentikasi ke Level 0 (Pencocokan ANI), Level 1 (Dasar), atau Level 2 (Multi-faktor) seperti yang dijelaskan dalam tabel Tingkat Autentikasi.
| Tingkat Autentikasi | Persyaratan |
|---|---|
| Level 0: Pencocokan ANI | Pengguna diautentikasi dengan melakukan panggilan dari atau memberikan nomor telepon yang sesuai dengan akun terdaftar. Pengguna dapat diautentikasi ke Level 0 dengan menggunakan komponen bawaan Greeting. |
| Level 1: Dasar | Pengguna diautentikasi dengan memverifikasi kode sandi sekali pakai (OTP) yang dikirim ke email atau nomor teleponnya. Jika verifikasi OTP gagal, pengguna dapat memberikan jawaban untuk tiga dari empat pertanyaan keamanan agar berhasil diautentikasi: tanggal lahir (DOB), empat digit terakhir kartu debit atau tanggal habis masa berlaku kartu kredit pengguna (bergantung pada apakah mereka adalah pemegang akun atau kartu), jumlah transaksi terakhir, dan metode pembayaran tagihan kartu kredit terakhir. |
| Level 2: Multi-faktor | Pengguna juga diautentikasi dengan memverifikasi kunci keamanan yang dibuat oleh aplikasi autentikator eksternal atau notifikasi push. |
Jenis pengguna yang didukung
Komponen autentikasi memberikan dukungan bagi pengguna yang terdaftar sebagai pelanggan bank yang merupakan pemegang akun, pemegang kartu, atau keduanya. Komponen ini juga mendukung autentikasi untuk pengguna yang bukan pelanggan bank terdaftar, tetapi memiliki surat kuasa untuk akun yang terdaftar di bank. Pengguna mungkin memiliki satu atau beberapa akun atau kartu yang terdaftar di bank.
Jenis autentikasi
Komponen ini memungkinkan Anda mengonfigurasi apakah pengguna harus diautentikasi sebagai
pemegang akun, pemegang kartu, atau keduanya. Opsi ini dikonfigurasi dengan
menetapkan $session.params.account_auth_enabled dan $session.params.card_auth_enabled
parameter input. Tabel ini menjelaskan perilaku komponen untuk berbagai kombinasi nilai untuk autentikasi akun dan flag autentikasi kartu.
| account_auth_enabled | card_auth_enabled | Authentication type |
|---|---|---|
true |
false |
Pengguna akan diautentikasi sebagai pemegang akun, yang memverifikasi bahwa pengguna memegang satu atau beberapa akun di bank dan mengonfirmasi pertanyaan keamanan termasuk empat digit terakhir kartu debit yang terdaftar. |
false |
true |
Pengguna akan diautentikasi sebagai pemegang kartu, memverifikasi bahwa pengguna memegang satu atau beberapa kartu kredit dengan bank dan mengonfirmasi pertanyaan keamanan termasuk tanggal habis masa berlaku kartu kredit untuk kartu kredit terdaftar. |
true |
true |
Komponen ini pertama-tama memeriksa apakah pengguna adalah pemegang akun terdaftar. Jika pengguna memiliki satu atau beberapa akun di bank, komponen akan mengautentikasi pengguna menggunakan informasi akun. Jika pengguna tidak memiliki akun apa pun di bank, komponen akan mencoba mengautentikasi pengguna menggunakan informasi pemegang kartu. |
false |
false |
Komponen ini pertama-tama memeriksa apakah pengguna adalah pemegang akun terdaftar. Jika pengguna memiliki satu atau beberapa akun di bank, komponen akan mengautentikasi pengguna ke autentikasi Level 0. Jika pengguna tidak memiliki akun apa pun di bank, komponen akan memeriksa apakah pengguna adalah pemegang kartu. Jika pengguna memegang satu atau beberapa kartu kredit dengan bank, komponen akan mengautentikasi pengguna ke autentikasi Level 0. |
Batasan
Selain batasan komponen bawaan umum, komponen bawaan ini memiliki batasan berikut:
- OTP hanya akan dikirim ke nomor ponsel atau alamat email yang sebelumnya terdaftar untuk pengguna. Komponen tidak akan menggunakan OTP untuk mengautentikasi pelanggan yang menelepon dari nomor telepon alternatif yang tidak terdaftar di akun mereka. Saat pengguna menelepon dari nomor telepon alternatif, pertanyaan keamanan akan digunakan untuk mengautentikasi penelepon.
- Komponen ini tidak mengenkripsi data apa pun.
Contoh dialog
Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Dialog contoh menunjukkan perilaku saat komponen dipanggil menggunakan telepon, yang memicu Maksud Sambutan Default dan respons agen pertama di awal percakapan.
Keberhasilan autentikasi Level 1: OTP
Pengguna sebelumnya telah diautentikasi ke autentikasi Level 0. Komponen mengirim dan meminta pengguna untuk mengonfirmasi OTP yang dikirim ke saluran pilihan pengguna. Pengguna dapat memberikan OTP yang valid dan berhasil diautentikasi ke Level 1.
| Input pengguna | Respons agen |
|---|---|
| Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda ingin menerima kode melalui telepon atau email? | |
| Telepon | |
| Kami telah mengirimkan kode ke nomor telepon terdaftar Anda yang berakhiran 0000. Proses ini mungkin memerlukan waktu beberapa detik. Dapatkah Anda mengonfirmasi kode tersebut? | |
| Kodenya adalah 123457 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Keberhasilan autentikasi level 1: pertanyaan keamanan
Komponen mengonfirmasi autentikasi Level 0 pengguna dengan mengumpulkan dan memverifikasi nomor telepon yang diberikan. Komponen meminta dan memvalidasi jawaban pengguna yang benar atas tiga pertanyaan keamanan - tanggal lahir, empat digit terakhir nomor kartu debit pengguna, dan jumlah transaksi terakhir. Pengguna berhasil diautentikasi ke Level 1.
| Input pengguna | Respons agen |
|---|---|
| Apakah Anda nasabah bank kami, atau apakah Anda memiliki surat kuasa? Harap konfirmasi dengan mengatakan ya atau tidak. | |
| Ya | |
| Oke, kami perlu mengumpulkan nomor telepon Anda untuk mengambil detail akun Anda. | |
| Agen mengumpulkan nomor telepon pengguna menggunakan komponen bawaan Pengumpulan nomor telepon | |
| Oke. Apakah nomor yang Anda sebutkan adalah +1 6502530000, sudah benar? | |
| Ya | |
| Bagus, kami telah selesai mengumpulkan nomor telepon. Oke, untuk tujuan keamanan, kami akan memerlukan informasi lebih lanjut untuk memvalidasi identitas Anda. |
|
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen siap pakai Pengumpulan tanggal lahir | |
| Oke, tanggal lahir Anda adalah 3 Februari 1995, apakah itu benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Harap beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| Ini 1234 | |
| Beri tahu kami jumlah dolar transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp1.003.000, ucapkan "100". | |
| Harganya 500 dolar | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Keberhasilan autentikasi level 2: autentikasi 2 faktor
Pengguna sebelumnya telah diautentikasi ke autentikasi Level 1. Komponen meminta pengguna untuk membuat kunci keamanan menggunakan aplikasi bank atau autentikator mereka. Pengguna berhasil mengonfirmasi kunci keamanan yang dibuat dan diautentikasi ke Level 2.
| Input pengguna | Respons agen |
|---|---|
| Bagikan kunci keamanan Anda. Buat kunci keamanan 6 digit di aplikasi bank atau aplikasi autentikator Anda. Kemudian, ucapkan atau masukkan digitnya. |
|
| 232425 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Penolakan informasi
Pengguna menolak memberikan informasi yang diperlukan untuk autentikasi. Komponen keluar dengan pesan kegagalan.
| Input pengguna | Respons agen |
|---|---|
| Untuk tujuan keamanan, kami perlu memvalidasi identitas Anda, jadi kami akan mengirimkan kode kepada Anda. Apakah Anda ingin menerima kode melalui telepon atau email? | |
| Tidak, saya tidak ingin membagikan | |
| Oke, untuk tujuan keamanan, kami memerlukan informasi lebih lanjut untuk memvalidasi identitas Anda. | |
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen siap pakai Pengumpulan tanggal lahir | |
| Oke, tanggal lahir Anda adalah 3 Februari 1995, apakah itu benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Harap beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| Ini 1234 | |
| Beri tahu kami jumlah dolar transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah Rp1.003.000, ucapkan "100". | |
| Saya tidak ingin membagikan detailnya | |
| Kami tidak dapat mengautentikasi Anda, sehingga kami tidak dapat menyelesaikan tindakan ini. Kami mohon maaf atas ketidaknyamanan ini. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Autentikasi |
| Niat Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_authentication_power_of_attorney |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_authentication_payment_mode |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_authentication:telephony_verification |
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 pengguna akhir saat ini. | bilangan bulat |
| $session.params.auth_level_req | Menentukan tingkat autentikasi yang akan digunakan untuk mengautentikasi pengguna akhir. Nilai yang valid adalah 0, 1, atau 2. |
bilangan bulat |
| $session.params.account_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang akun. Perilaku komponen bergantung pada nilai ini dan nilai $session.params.card_auth_enabled seperti yang dijelaskan dalam Tingkat autentikasi. |
boolean |
| $session.params.card_auth_enabled | Menunjukkan apakah pengguna harus diautentikasi sebagai pemegang kartu. Perilaku komponen bergantung pada nilai ini dan nilai $session.params.account_auth_enabled seperti yang dijelaskan dalam Tingkat autentikasi. |
boolean |
| $session.params.phone_number | (opsional) Nomor telepon pengguna akhir. Jika parameter ini tidak diberikan, komponen akan mengumpulkan nomor telepon dari pengguna akhir. | string |
| $flow.max_retry_telephone_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan nomor telepon pengguna. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.max_retry_security_ans_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan jawaban keamanan. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_security_key | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan kunci keamanan. Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.max_retry_otp_not_received | Menentukan jumlah percobaan ulang yang diizinkan saat Sandi Sekali Pakai (OTP) tidak diterima. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.max_retry_otp_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan Sandi Sekali Pakai (OTP). Nilai defaultnya adalah 3. |
bilangan bulat |
| $flow.security_ans_denial_count | Menentukan jumlah percobaan ulang yang diizinkan saat pengguna menolak memberikan informasi yang diminta. Nilai defaultnya adalah 1. |
bilangan bulat |
| $flow.security_ans_mid_count | Menentukan jumlah jawaban keamanan yang salah yang dapat diberikan pengguna. Nilai defaultnya adalah 2, yang berarti jika pemanggil memberikan jawaban yang salah untuk dua pertanyaan berbeda, komponen akan keluar dengan kegagalan. |
bilangan bulat |
| $flow.max_retry_card_counter | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan empat digit terakhir kartu debit pengguna akhir. Nilai defaultnya adalah 2. |
bilangan bulat |
| $flow.security_key_length | Menentukan panjang kunci keamanan yang valid yang diberikan oleh aplikasi autentikator untuk autentikasi Level 2. Nilai defaultnya adalah 6. |
bilangan bulat |
| $flow.otp_length | Menentukan panjang yang valid untuk Sandi Sekali Pakai (OTP) untuk autentikasi Level 1. Nilai defaultnya adalah 6. |
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 pengguna akhir saat ini. | bilangan bulat |
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, yang digunakan untuk mengidentifikasi pengguna. | 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.
Verifikasi telepon
Webhook prebuilt_components_authentication:telephony_verification digunakan
oleh komponen untuk mengambil detail akun pengguna berdasarkan nomor telepon
yang diberikan.
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 |
|---|---|---|
| account_count | Jumlah akun yang terkait dengan nomor telepon terdaftar. Akun ini mencakup akun pribadi dan akun yang pengguna miliki surat kuasanya. | bilangan bulat |
| last_four_digit_of_account_number | Jika pengguna memiliki satu akun, empat digit terakhir nomor akun akan ditampilkan. Jika pengguna memiliki lebih dari satu akun, nilai parameter ini adalah null. |
string |
Email yang terdaftar di akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null. |
string |
Untuk mengonfigurasi webhook verifikasi Telephony 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_authentication:telephony_verification.
- 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.
Mendapatkan detail kartu kredit
Webhook prebuilt_components_account_services:get_credit_card_details digunakan oleh komponen untuk mendapatkan informasi tentang kartu kredit 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 |
|---|---|---|
| credit_card_count | Jumlah kartu kredit yang terkait dengan nomor telepon terdaftar. | bilangan bulat |
| last_four_digit_of_credit_card_number | Jika pengguna memiliki satu kartu kredit, empat digit terakhir nomor kartu akan ditampilkan. Jika pengguna memiliki lebih dari satu kartu, nilai parameter ini adalah null. |
string |
Email yang terdaftar di 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 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_credit_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.
Kirim OTP
Webhook prebuilt_components_authentication:send_otp digunakan
oleh komponen untuk mengirimkan sandi sekali pakai (OTP) ke saluran terdaftar
yang dipilih oleh pengguna akhir.
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 |
| $flow.channel | Saluran yang dipilih pengguna untuk menerima OTP. Nilai yang valid ditentukan oleh entity kustom prebuilt_components_authentication_channel. Secara default, email dan mobile didukung. |
string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| generated_otp | Nilai OTP yang dibuat dan dikirim ke pengguna menggunakan saluran yang dipilih. | string |
Untuk mengonfigurasi webhook Kirim OTP untuk komponen ini, perluas untuk melihat petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_authentication:send_otp.
- 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.
Jawaban keamanan
Webhook prebuilt_components_authentication:security_answers digunakan oleh
komponen untuk mengambil jawaban keamanan pengguna akhir dari akun terdaftarnya.
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 |
|---|---|---|
| security_last_trans_amount | Menunjukkan jumlah penuh transaksi terakhir pengguna, tanpa simbol mata uang. Misalnya, jika jumlah transaksi terakhir pengguna adalah $100,30 USD, nilai yang diharapkan untuk kolom ini adalah "100.30". |
string |
| last_payment_mode | Metode pembayaran yang digunakan untuk transaksi terakhir pengguna, dengan nilai valid yang ditentukan oleh entity kustom prebuilt_components_authentication_payment_mode. Secara default, nilai ini mencakup mobile, upi, online, debit, credit, dan account. |
string |
| security_card_number | Empat digit terakhir nomor kartu debit pengguna. | string |
| user_dob | Tanggal lahir (DOB) pengguna dalam format YYYY-MM-DD. | string |
| cards_exp_date_all | Tanggal habis masa berlaku semua kartu kredit yang terdaftar dengan pengguna dalam format MMYYYY. | Daftar (string) |
Untuk mengonfigurasi webhook Jawaban keamanan 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_authentication:security_answers.
- 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 dua faktor
Webhook prebuilt_components_authentication:2fa_validation digunakan oleh
komponen untuk memvalidasi kunci keamanan yang diberikan oleh pengguna akhir untuk autentikasi
dua faktor.
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 |
| $flow.security_key | Kunci keamanan yang disediakan oleh pengguna akhir, yang dibuat menggunakan aplikasi bank atau aplikasi authenticator. | string |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| security_key_verified | Menunjukkan apakah kunci keamanan yang diberikan pengguna akhir valid. true menunjukkan bahwa kunci keamanan yang diberikan valid. false menunjukkan bahwa kunci keamanan yang diberikan tidak valid. |
boolean |
Untuk mengonfigurasi webhook validasi Dua faktor 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_authentication:2fa_validation.
- 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.