Komponen bawaan autentikasi mengumpulkan informasi dari pengguna untuk mengautentikannya 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 (Kecocokan ANI), Level 1 (Dasar), atau Level 2 (Multi-faktor) seperti yang dijelaskan dalam tabel Tingkat Autentikasi.
| Tingkat Autentikasi | Persyaratan |
|---|---|
| Tingkat 0: Kecocokan ANI | Pengguna diautentikasi dengan menelepon dari atau memberikan nomor telepon yang sesuai dengan akun terdaftar. Pengguna dapat diautentikasi ke Level 0 menggunakan komponen bawaan Ucapan. |
| Level 1: Dasar | Pengguna diautentikasi dengan memverifikasi kode sandi sekali pakai (OTP) yang dikirim ke email atau nomor telepon mereka. Jika verifikasi OTP gagal, pengguna dapat memberikan jawaban atas 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 dihasilkan oleh aplikasi pengautentikasi eksternal atau notifikasi push. |
Jenis pengguna yang didukung
Komponen autentikasi memberikan dukungan bagi pengguna yang merupakan pelanggan bank terdaftar yang merupakan pemegang rekening, 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 rekening 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 parameter input
$session.params.account_auth_enabled dan $session.params.card_auth_enabled. Tabel ini menjelaskan perilaku
komponen untuk berbagai kombinasi nilai untuk flag autentikasi akun dan
autentikasi kartu.
| account_auth_enabled | card_auth_enabled | Authentication type |
|---|---|---|
true |
false |
Pengguna akan diautentikasi sebagai pemegang rekening, yang memverifikasi bahwa pengguna memiliki satu atau beberapa rekening di bank dan mengonfirmasi pertanyaan keamanan termasuk empat digit terakhir kartu debit terdaftar. |
false |
true |
Pengguna akan diautentikasi sebagai pemegang kartu, yang memverifikasi bahwa pengguna memiliki satu atau beberapa kartu kredit di 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 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 rekening di bank, komponen akan memeriksa apakah pengguna tersebut adalah pemegang kartu. Jika pengguna memiliki satu atau beberapa kartu kredit di 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 ini tidak akan menggunakan OTP untuk mengautentikasi pelanggan yang menelepon dari nomor telepon alternatif yang tidak terdaftar dengan 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 telephony, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.
Autentikasi level 1 berhasil: 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 lebih suka 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 kodenya? | |
| Kodenya adalah 123457 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Autentikasi level 1 berhasil: pertanyaan keamanan
Komponen mengonfirmasi autentikasi Level 0 pengguna dengan mengumpulkan dan memverifikasi nomor telepon yang diberikan. Komponen meminta dan memvalidasi jawaban yang benar dari pengguna untuk tiga pertanyaan keamanan - tanggal lahir, empat digit terakhir nomor kartu debet pengguna, dan jumlah transaksi terakhir. Pengguna berhasil diautentikasi ke Level 1.
| Input pengguna | Respons agen |
|---|---|
| Apakah Anda pelanggan 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. Nomor yang Anda sebutkan adalah +1 6502530000, benar? | |
| Ya | |
| Bagus, kami sudah selesai mengumpulkan nomor telepon. Oke, untuk tujuan keamanan, kami memerlukan beberapa informasi lagi untuk memvalidasi identitas Anda. |
|
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Baik, tanggal lahir Anda adalah 3 Februari 1995, benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| 1234 | |
| Beri tahu kami jumlah dolar dari transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah $100,30, ucapkan "100". | |
| Harganya 500 dolar | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Sukses autentikasi level 2: autentikasi 2 langkah
Pengguna sebelumnya telah diautentikasi ke autentikasi Level 1. Komponen ini meminta pengguna untuk membuat kunci keamanan menggunakan aplikasi pengautentikasi atau bank mereka. Pengguna berhasil mengonfirmasi kunci keamanan yang dihasilkan dan diotentikasi ke Level 2.
| Input pengguna | Respons agen |
|---|---|
| Bagikan kunci keamanan Anda. Buat kunci keamanan 6 digit di aplikasi bank atau aplikasi pengautentikasi Anda. Kemudian, ucapkan atau masukkan digitnya. |
|
| 232425 | |
| Terima kasih, Anda telah berhasil diautentikasi. |
Penolakan informasi
Pengguna menolak untuk memberikan informasi yang diperlukan untuk melakukan autentikasi. Komponen akan 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 lebih suka menerima kode melalui telepon atau email? | |
| Tidak, saya tidak ingin berbagi | |
| Baik, untuk tujuan keamanan, kami memerlukan beberapa informasi lagi untuk memvalidasi identitas Anda. | |
| Agen mengumpulkan tanggal lahir pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Baik, tanggal lahir Anda adalah 3 Februari 1995, benar? | |
| Ya | |
| Bagus, kami telah mengumpulkan tanggal lahir Anda. Beri tahu kami empat digit terakhir nomor kartu debit Anda. |
|
| 1234 | |
| Beri tahu kami jumlah dolar dari transaksi terakhir Anda. Misalnya, jika jumlah transaksi terakhir Anda adalah $100,30, 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 | [Component Name] | Autentikasi |
| Intent 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 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 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 di 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 di 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 untuk 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 yang 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 disediakan oleh aplikasi pengautentikasi untuk autentikasi Level 2. Nilai defaultnya adalah 6. |
bilangan bulat |
| $flow.otp_length | Menentukan panjang Sandi Sekali Pakai (OTP) yang valid untuk autentikasi Level 1. Nilai defaultnya adalah 6. |
bilangan bulat |
Untuk mengonfigurasi parameter input untuk komponen ini, luaskan 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 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:
- Impor komponen bawaan.
- 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.
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 surat kuasanya dimiliki oleh pengguna. | 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 dengan akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null. |
string |
Untuk mengonfigurasi webhook verifikasi Telepon untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- 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 Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 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 yang 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 dengan akun. Jika tidak ada email yang terdaftar dengan akun, nilai parameter ini adalah null. |
string |
Untuk mengonfigurasi webhook Get credit card details untuk komponen ini, luaskan untuk melihat 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 Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Kirim OTP
Webhook prebuilt_components_authentication:send_otp digunakan
oleh komponen untuk mengirim 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 entitas 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, luaskan untuk mendapatkan 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 Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Jawaban keamanan
Webhook prebuilt_components_authentication:security_answers digunakan oleh komponen untuk mengambil jawaban keamanan pengguna akhir dari akun terdaftar mereka.
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 entitas 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 bagi komponen ini, luaskan untuk mendapatkan petunjuk.
- 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 Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Validasi 2 langkah
Webhook prebuilt_components_authentication:2fa_validation digunakan oleh
komponen untuk memvalidasi kunci keamanan yang diberikan oleh pengguna akhir untuk autentikasi
faktor kedua.
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 pengautentikasi. | 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 2 langkah untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- 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 Agen Percakapan (Dialogflow CX) dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di menu dropdown.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen dan webhook-nya kini telah disiapkan dan siap diuji.