Komponen bawaan pendaftaran kartu kredit

Komponen bawaan pendaftaran kartu kredit memungkinkan pelanggan baru dan lama mengajukan permohonan kartu kredit baru.

Komponen ini dimulai dengan mengumpulkan nomor telepon pengguna akhir untuk mengidentifikasi apakah mereka pelanggan baru atau lama. Untuk pengguna baru, komponen ini akan mengumpulkan detail yang diperlukan, termasuk pendapatan bulanan dan kategori pengeluaran atau manfaat kartu yang diminta pengguna. Setelah semua informasi yang diperlukan dikumpulkan, komponen akan mengatur callback dan memberikan nomor permintaan kepada pengguna.

Untuk pelanggan lama, komponen ini akan mengambil informasi pengguna terdaftar dan menampilkan opsi kartu yang tersedia kepada pengguna akhir berdasarkan preferensi mereka dan informasi yang diambil, termasuk skor kredit mereka. Setelah pelanggan memilih opsi kartu, komponen akan mengirimkan link untuk menyelesaikan prosedur pendaftaran melalui saluran terdaftar, termasuk WhatsApp atau SMS.

Komponen ini menggunakan komponen bawaan Pengumpulan nomor telepon dan Pengumpulan kode pos untuk mengumpulkan dan memvalidasi detail pengguna.

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 baru

Komponen memeriksa apakah pengguna menelepon menggunakan nomor telepon terdaftar dan mengidentifikasi bahwa mereka adalah pengguna baru. Komponen ini mengumpulkan kategori kartu yang ingin didaftarkan pengguna dan mengumpulkan informasi untuk mengidentifikasi pengguna, termasuk kode pos dan nomor telepon. Komponen kemudian mengatur panggilan kembali dan memberi pengguna nomor permintaan.

Input pengguna	Respons agen
	Dapatkah Anda mengonfirmasi apakah Anda adalah pelanggan lama bank kami?
Saya tidak
	Kami senang Anda ingin mengajukan permohonan kartu kredit dengan kami. Kami memiliki berbagai kartu kredit yang cocok untuk Anda. Untuk memberikan kartu terbaik yang tersedia, harap sebutkan penghasilan bulanan Anda dalam USD?
5.000 dolar
	Pengeluaran atau manfaat mana yang Anda minati? Kami memiliki berbagai opsi yang tersedia, seperti perjalanan, bahan bakar, dan belanja.
Saya suka belanja
	Respons yang Anda pilih termasuk dalam kategori belanja. Jika Anda ingin melanjutkan lebih lanjut, jawab ya.
Ya
	Agen mengumpulkan kode pos pengguna menggunakan komponen bawaan Pengumpulan kode pos
	Anda menyebutkan kode posnya adalah 10011, apakah itu benar?
Ya, benar
	Bagus, kita sudah selesai mengumpulkan kode pos.
	Agen mengumpulkan nomor telepon pengguna menggunakan komponen bawaan Pengumpulan nomor telepon
	Oke. Nomor yang Anda sebutkan adalah [phone], benar?
Ya
	Bagus, kami sudah selesai mengumpulkan nomor telepon. Salah satu perwakilan kami akan menghubungi Anda kembali untuk memberikan informasi tentang kartu yang terkait berdasarkan kriteria Anda. Nomor permintaan Anda adalah 993835.

Pelanggan lama

Komponen mengidentifikasi pelanggan terdaftar menggunakan nomor telepon mereka. Komponen tersebut kemudian meminta informasi seperti kategori dan jenis kartu yang ingin didaftarkan oleh pengguna. Setelah informasi ini dikonfirmasi, komponen akan meminta pelanggan untuk memilih channel tempat mereka menyelesaikan proses pendaftaran, dan mengirimkan link ke channel terdaftar pelanggan.

Input pengguna	Respons agen
	Kami senang Anda terus memilih produk dan layanan kami. Kami memiliki berbagai macam kartu kredit yang sesuai untuk Anda. Pengeluaran atau manfaat mana yang Anda minati? Kami memiliki berbagai opsi yang tersedia, seperti perjalanan, bahan bakar, dan belanja.
Saya ingin kartu yang dapat saya gunakan saat pergi berlibur lagi
	Respons yang Anda pilih termasuk dalam kategori perjalanan. Jika Anda ingin melanjutkan lebih lanjut, jawab ya.
Ya
	Ada 3 jenis kartu yang sesuai dengan jenis permintaan Anda: kartu perjalanan platinum, kartu perjalanan gold, kartu perjalanan klasik. Apakah Anda ingin mengetahui informasi tentang semua kartu atau kartu tertentu? Misalnya, jika Anda secara khusus mencari kartu klasik, ucapkan kartu klasik.
Bisa ceritakan tentang kartu platinum?
	Tentu saja, untuk kartu perjalanan platinum, biaya tahunannya adalah 95 dolar. Manfaatnya meliputi: mendapatkan 10.000 mil bonus setiap tahun, mendapatkan 2x mil tanpa batas untuk semua pembelian lainnya, mil mudah diperoleh dan mudah digunakan. Anda dapat menemukan informasi selengkapnya tentang manfaat atau bonus di situs kami. Harap konfirmasi apakah Anda ingin mendaftar ke kartu perjalanan platinum.
Ya, mari kita lakukan
	Kami akan membagikan link yang berisi langkah-langkah prosedur pendaftaran. Apakah Anda ingin kami membagikan detail kartu ini ke nomor ponsel Anda melalui SMS atau WhatsApp?
Kirim SMS
	Baik, kami akan mengirimkan link ke nomor ponsel terdaftar Anda. Tindakan ini mungkin memerlukan waktu beberapa detik. Dapatkah Anda mengonfirmasi apakah Anda telah menerima link dengan menjawab ya atau tidak?
Saya mengerti
	Bagus, sekarang Anda dapat membuka link dan memeriksa detail pendaftaran kartu. Setelah data selesai, penerbitan kartu baru akan dimulai dan dikirim ke alamat Anda saat ini.

Penolakan informasi

Pengguna menolak memberikan informasi yang diperlukan untuk mendaftar kartu kredit. Komponen akan keluar dengan pesan kegagalan.

Input pengguna	Respons agen
	Dapatkah Anda mengonfirmasi apakah Anda adalah pelanggan lama bank kami?
Tidak
	Kami senang Anda ingin mengajukan permohonan kartu kredit dengan kami. Kami memiliki berbagai kartu kredit yang cocok untuk Anda. Untuk memberikan kartu terbaik yang tersedia, harap sebutkan penghasilan bulanan Anda dalam USD?
Saya tidak ingin memberi tahu Anda informasi tersebut
	Terima kasih telah menghubungi kami. Mohon maaf, tetapi saat ini kami tidak dapat melanjutkan lebih lanjut tanpa informasi yang diminta.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Pendaftaran Kartu Kredit
Intent Khusus Komponen	prebuilt_components_[component_name]_[intent_name]	prebuilt_components_cc_enroll_collect_cardtype
Jenis Entitas	prebuilt_components_[component_name]_[entity_type]	prebuilt_components_cc_enroll_expense_category
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_credit_card_enrollment:get_available_card

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.phone_number	(opsional) Nomor telepon pengguna akhir. Jika parameter ini tidak diberikan, komponen akan mengumpulkan nomor telepon dari pengguna akhir.	string
$flow.max_retry_count	Menentukan jumlah percobaan ulang yang diberikan kepada pengguna akhir. Nilai defaultnya adalah 3.	bilangan bulat
$flow.currency_name	Menentukan mata uang yang diharapkan saat mengumpulkan detail penghasilan bulanan. Nilai defaultnya adalah "USD".	string

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
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:

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.

Mendapatkan detail akun

Webhook prebuilt_components_credit_card_enrollment:get_account_details digunakan oleh komponen untuk mengambil detail akun pengguna, jika akun ada.

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.	bilangan bulat
credit_score	Skor kredit terdaftar pengguna.	bilangan bulat

Untuk mengonfigurasi webhook Get account 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_credit_card_enrollment:get_account_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.

Mendapatkan jumlah kartu

Webhook prebuilt_components_credit_card_enrollment:get_card_count digunakan oleh komponen untuk mengambil jumlah kartu kredit yang terkait dengan akun pengguna terdaftar.

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
card_count	Jumlah total kartu kredit di seluruh akun pengguna terdaftar.	bilangan bulat

Untuk mengonfigurasi webhook Get card count 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_credit_card_enrollment:get_card_count.
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.

Mendapatkan kartu yang tersedia

Webhook prebuilt_components_credit_card_enrollment:get_available_card digunakan oleh komponen untuk mengambil daftar kartu yang tersedia bagi pengguna untuk kategori tertentu berdasarkan skor kredit pengguna.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.expense_category	Kategori pengeluaran yang dipilih pengguna untuk diikutsertakan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_cc_enroll_expense_category. Secara default, fuel, shopping, dan travel didukung.	string
$flow.credit_score	Skor kredit pengguna, yang diambil oleh komponen menggunakan webhook Get account details.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
available_card_names	Daftar kartu yang tersedia bagi pengguna, misalnya ["gold shopping card","classic shopping card"].	Daftar (string)
cards_count	Jumlah kartu yang tersedia untuk pengguna.	bilangan bulat

Untuk mengonfigurasi webhook Get available cards 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_credit_card_enrollment:get_available_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.

Mendapatkan detail kartu yang dipilih

Webhook prebuilt_components_credit_card_enrollment:get_selected_card digunakan oleh komponen untuk mengambil biaya dan manfaat tahunan untuk kartu yang dipilih.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
$flow.card_type	Jenis kartu yang dipilih pengguna untuk didaftarkan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_cc_enroll_card_type. Secara default, classic, gold, dan platinum didukung.	string
$flow.expense_category	Kategori pengeluaran yang dipilih pengguna untuk diikutsertakan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_cc_enroll_expense_category. Secara default, fuel, shopping, dan travel didukung.	string
$flow.credit_score	Skor kredit pengguna, yang diambil oleh komponen menggunakan webhook Get account details.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
selected_card_benefits	Informasi tentang manfaat kartu yang dipilih.	string
selected_card_annual_fee	Biaya tahunan kartu yang dipilih.	bilangan bulat
selected_card_name	Nama kartu yang dipilih.	string

Untuk mengonfigurasi webhook Get selected 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_credit_card_enrollment:get_selected_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.

Mengirim permintaan pendaftaran

Webhook prebuilt_components_credit_card_enrollment:submit_enroll digunakan oleh komponen untuk membuat permintaan pendaftaran kartu berdasarkan preferensi dan detail pengguna yang diberikan pengguna baru.

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.zipcode	Kode pos yang diberikan pengguna.	string
$flow.monthly_salary	Gaji bulanan yang diberikan pengguna.	bilangan bulat
$flow.currency_name	Mata uang gaji bulanan, yang dikonfigurasi dalam parameter input komponen. Lihat parameter input.	string

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
request_number	Nomor permintaan untuk pendaftaran permintaan pendaftaran kartu yang berhasil.	bilangan bulat

Untuk mengonfigurasi webhook Kirim permintaan pendaftaran 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_credit_card_enrollment:submit_enroll.
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.

Kirim pesan

Webhook prebuilt_components_credit_card_enrollment:send_message digunakan oleh komponen untuk mengirim pesan yang berisi link untuk menyelesaikan pendaftaran kartu kredit bagi pelanggan lama.

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 pesan. Nilai yang valid ditentukan oleh entitas kustom prebuilt_components_cc_enroll_channel. Secara default, SMS dan WhatsApp didukung.	string
$flow.selected_card_name	Daftar kartu yang dipilih oleh pengguna, misalnya ["gold shopping card","classic shopping card"].	Daftar (string)

Parameter respons API

Parameter berikut diambil dari respons API untuk digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
message_sent	Menunjukkan apakah pesan berhasil dikirim ke saluran yang ditentukan oleh pengguna.	boolean

Untuk mengonfigurasi webhook Kirim pesan 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_credit_card_enrollment:send_message.
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.