Komponen bawaan pengaturan janji temu memungkinkan pelanggan baru dan lama untuk membuat janji temu. Komponen ini menggunakan komponen bawaan Pengumpulan tanggal lahir versi yang disesuaikan untuk mengumpulkan tanggal janji temu, serta menggunakan komponen bawaan Pengumpulan nomor telepon dan Pengumpulan kode pos untuk mengumpulkan informasi tentang pengguna dan lokasi janji temu.
Alasan dan jenis janji temu
Komponen ini mendukung beberapa kategori alasan janji temu dan menawarkan berbagai jenis janji temu bergantung pada alasan yang dipilih pengguna.
| Alasan janji temu | Jenis janji temu yang tersedia |
|---|---|
| Pinjaman | Secara langsung, virtual, telepon |
| Hipotek | Secara langsung, virtual, telepon |
| Pengelolaan kekayaan | Secara langsung, virtual, telepon |
| Kartu kredit | Virtual, ponsel |
| Lainnya | Telepon |
Kategori janji temu dapat disesuaikan dengan mengubah entitas kustom prebuilt_components_arrange_appt_reason. Jenis janji temu yang tersedia untuk setiap kategori dapat dikonfigurasi dengan mengubah parameter input untuk setiap jenis janji temu.
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 ini menunjukkan perilaku saat komponen dipanggil melalui telepon, yang memicu Intent Selamat Datang Default dan respons agen pertama di awal percakapan.
Pengguna yang sudah ada membuat janji temu tatap muka
Agen mengidentifikasi bahwa pengguna sebelumnya telah diautentikasi sebagai pengguna yang sudah ada. Pengguna memberikan alasan janji temu dan memilih untuk membuat janji temu secara langsung. Agen mengonfirmasi bahwa pengguna ingin pergi ke cabang yang terdekat dengan alamat terdaftar mereka, dan mengonfirmasi bahwa tanggal dan waktu pilihan pengguna tersedia. Agen mengonfirmasi waktu dan tempat serta berhasil menjadwalkan janji temu.
| Input pengguna | Respons agen |
|---|---|
| Sebelum menjadwalkan janji temu, kami akan mengajukan beberapa pertanyaan. Bisakah Anda memberi tahu kami alasan janji temu Anda? | |
| Saya ingin berbincang dengan seseorang tentang manajemen kekayaan | |
| Apakah Anda mencari panggilan telepon, panggilan video, atau janji temu langsung di salah satu cabang kami? | |
| Saya ingin datang secara langsung | |
| Oke, mau buat janji temu di cabang yang berlokasi di 1600 Amphitheatre Pkwy, Mountain View, CA 94043? | |
| Ya | |
| Berikan tanggal janji temu yang Anda inginkan. Harap sebutkan bulan yang Anda inginkan, diikuti dengan hari dan kemudian tahun. Harap diingat bahwa cabang kami buka dari Senin hingga Jumat: 09.00 hingga 17.00, Sabtu: 09.00 hingga 13.00. | |
| Agen mengumpulkan tanggal janji temu pilihan pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Bagus, kami sudah selesai mengumpulkan tanggal yang Anda inginkan. Berikan slot waktu yang Anda inginkan. |
|
| 10.00 | |
| Anda telah memilih pukul 10.00. Untuk melanjutkan dengan waktu janji temu yang dipilih, ucapkan ya. | |
| Ya | |
| Kami akan menjadwalkan janji temu di alamat bank 1600 Amphitheatre Pkwy, Mountain View, CA 94043 pada 23-09-2023 pukul 10.00. Apa benar? | |
| Ya | |
| Oke, kita telah menjadwalkan janji temu. Nomor konfirmasi Anda adalah 818452. Mau membuat janji temu lain? | |
| Tidak, itu saja | |
| Terima kasih telah menghubungi kami. Semoga hari Anda menyenangkan. |
Pelanggan baru memesan beberapa janji temu
Agen mengidentifikasi bahwa pengguna belum pernah diautentikasi sebelumnya dan mengumpulkan nomor telepon pengguna. Pengguna meminta janji temu virtual untuk mendiskusikan pinjaman. Preferensi pertama pengguna untuk tanggal dan waktu tidak tersedia, sehingga agen menawarkan slot waktu yang tersedia kepada pengguna. Pengguna memilih slot waktu yang tersedia dan janji temu berhasil dijadwalkan. Pengguna mengonfirmasi bahwa dia ingin membuat janji temu kedua, dan agen berhasil menjadwalkan janji temu kedua.
| Input pengguna | Respons agen |
|---|---|
| Agen mengumpulkan nomor telepon pengguna menggunakan komponen bawaan Pengumpulan nomor telepon | |
| Bagus, kami selesai mengumpulkan nomor telepon. Sebelum menjadwalkan janji temu, kami akan mengajukan beberapa pertanyaan kepada Anda. Bisakah Anda memberi tahu kami alasan janji temu Anda? |
|
| Saya ingin mendapatkan pinjaman | |
| Apakah Anda mencari panggilan telepon, panggilan video, atau janji temu langsung di salah satu cabang kami? | |
| Janji temu virtual boleh dilakukan | |
| Berikan tanggal janji temu yang Anda inginkan. Harap sebutkan bulan yang Anda inginkan, diikuti dengan hari dan kemudian tahun. Harap diingat bahwa cabang kami buka dari Senin hingga Jumat: 09.00 hingga 17.00, Sabtu: 09.00 hingga 13.00. | |
| Agen mengumpulkan tanggal janji temu pilihan pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Bagus, kami sudah selesai mengumpulkan tanggal yang Anda inginkan. Berikan slot waktu yang Anda inginkan. |
|
| 3:00 baik untukku | |
| Anda telah memilih 03:00. Untuk melanjutkan dengan waktu janji temu yang dipilih, ucapkan ya. | |
| Ya | |
| Kami akan menjadwalkan janji temu dengan konsultan kami pada 03-10-2023 pukul 15.00. Apakah itu benar? | |
| Ya, silakan | |
| Oke, kita telah menjadwalkan janji temu. Nomor konfirmasi Anda adalah 754731. Mau membuat janji temu lain? |
|
| Ya | |
| Sebelum menjadwalkan janji temu, kami akan mengajukan beberapa pertanyaan. Bisakah Anda memberi tahu kami alasan janji temu Anda? | |
| Saya perlu membuat janji temu untuk kartu kredit saya | |
| Apakah Anda mencari janji temu panggilan telepon atau video dengan salah satu perwakilan cabang kami? | |
| Telepon | |
| Berikan tanggal janji temu yang Anda inginkan. Harap sebutkan bulan yang Anda inginkan, diikuti dengan hari dan kemudian tahun. Harap diingat bahwa cabang kami buka dari Senin hingga Jumat: 09.00 hingga 17.00, Sabtu: 09.00 hingga 13.00. | |
| Agen mengumpulkan tanggal janji temu pilihan pengguna menggunakan komponen bawaan Pengumpulan tanggal lahir | |
| Bagus, kami sudah selesai mengumpulkan tanggal yang Anda inginkan. Berikan slot waktu yang Anda inginkan. |
|
| Apakah jam 08.00 bisa? | |
| Anda telah memilih pukul 08.00. Untuk melanjutkan dengan waktu janji temu yang dipilih, ucapkan ya. | |
| Ya | |
| Maaf, slot waktu yang dipilih tidak tersedia. Kami memiliki ketersediaan untuk pukul 11.30, 12.30, 13.30, dan 15.00 pada 2023-10-06. Apakah Anda ingin mengubah slot waktu atau menjadwalkan janji temu pada tanggal yang berbeda? | |
| Oke, ayo kita lakukan 1.30 lalu | |
| Anda telah memilih 13.30. Untuk melanjutkan dengan waktu janji temu yang dipilih, ucapkan ya. | |
| Ya | |
| Kami akan menjadwalkan janji temu dengan konsultan kami pada 06-10-2023 pukul 13.30. Apakah itu benar? | |
| Ya | |
| Oke, kita telah menjadwalkan janji temu. Nomor konfirmasi Anda adalah 714637. Mau membuat janji temu lain? |
|
| Tidak, itu saja | |
| Terima kasih telah menghubungi kami. Semoga hari Anda menyenangkan. |
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
| Fitur | Format | Contoh |
|---|---|---|
| Flow | [Nama Komponen] | Jadwalkan Janji Temu |
| Intent Khusus Komponen | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_arrange_appt_change_date_slot |
| Jenis Entitas | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_arrange_appt_reason |
| Webhook | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_arrange_appointment:submit_appointment |
Parameter input
Parameter input adalah parameter yang digunakan untuk mengonfigurasi perilaku komponen tertentu. Parameter akan digunakan oleh satu atau beberapa kondisi dalam flow untuk menentukan perilaku komponen yang seharusnya. 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.phone_number | (opsional) Nomor telepon pelanggan yang terdaftar yang digunakan untuk autentikasi. | string |
| $session.params.auth_level | (opsional) Menunjukkan tingkat autentikasi pemanggil. | bilangan bulat |
| $flow.all_appointment_type | Menentukan daftar alasan janji temu yang menyediakan semua jenis janji temu. Nilai defaultnya adalah ["loans", "wealth"]. |
Daftar (string) |
| $flow.video_phone_appointment_type | Menentukan daftar alasan janji temu yang menyediakan semua jenis janji temu. Nilai defaultnya adalah ["cards"]. |
Daftar (string) |
| layanan_$flow.appointment | Menentukan daftar jenis janji temu yang lokasi cabangnya tidak diperlukan dan tidak akan dikumpulkan dari pengguna. Nilai defaultnya adalah ["video", "phone"]. |
Daftar (string) |
| $flow.working_hours | Menentukan jam buka cabang, misalnya "Monday to Friday: 9 AM to 5 PM, Saturday: 9 AM to 1 PM". |
string |
| $session.params.arrange_appointment_max_days | Menentukan jumlah maksimum hari setelah tanggal saat ini yang diizinkan untuk pembuatan janji temu. Secara default, nilainya adalah 90, yang menunjukkan bahwa tanggal janji temu dapat dipesan tidak lebih dari 90 hari setelah tanggal saat ini. Parameter ini ditetapkan di rute true halaman awal. |
bilangan bulat |
| flow.max_retry_count | Menentukan jumlah percobaan ulang yang diizinkan saat mengumpulkan informasi dari pengguna. Nilai defaultnya adalah 3. |
bilangan bulat |
Guna mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Flow.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute yang benar di Halaman Awal.
- Di jendela Rute, edit nilai Presets 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 |
|---|---|---|
| phone_number | Nomor telepon lokal pengguna, tanpa kode negara, digunakan untuk mengidentifikasi pengguna. | string |
| transfer_reason | Parameter ini menunjukkan alasan keluarnya flow, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari:agent: pengguna akhir meminta agen manusia kapan saja 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 telah mencapai jumlah percobaan ulang maksimum untuk peristiwa tidak ada kecocokan. Lihat peristiwa bawaan yang 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 mendeskripsikan layanan eksternal Dialogflow 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.
Dapatkan akun
Webhook prebuilt_components_arrange_appointment:get_account digunakan oleh komponen untuk mendapatkan detail akun untuk nomor telepon yang diberikan, jika ada akun yang 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, digunakan untuk mengidentifikasi pengguna. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| account_count | Jumlah akun yang dikaitkan dengan nomor telepon yang terdaftar. | bilangan bulat |
| cards_count | Jumlah kartu yang dikaitkan dengan nomor telepon yang terdaftar. | bilangan bulat |
| loans_count | Jumlah pinjaman yang terkait dengan nomor telepon yang terdaftar. | bilangan bulat |
| mortgage_count | Jumlah hipotek yang terkait dengan nomor telepon yang terdaftar. | bilangan bulat |
| branch_code | Kode cabang yang terkait dengan nomor telepon yang terdaftar, digunakan untuk mengidentifikasi lokasi cabang yang unik. | string |
Untuk mengonfigurasi webhook Dapatkan akun bagi komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_arrange_appointment:get_account.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Mendapatkan cabang
Webhook prebuilt_components_arrange_appointment:get_branch digunakan oleh komponen untuk mengambil informasi tentang lokasi cabang yang diberi kode cabang.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $flow.branch_code | Kode cabang yang mengidentifikasi lokasi cabang yang unik. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| branch_address | Alamat cabang. | string |
Untuk mengonfigurasi webhook Get cabang untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_arrange_appointment:get_branch.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Cabang yang tersedia
Webhook prebuilt_components_arrange_appointment:available_branch digunakan oleh komponen untuk mendapatkan lokasi cabang terdekat yang diberikan kode pos.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| kode_pos $flow. | Kode pos yang diberikan oleh pengguna akhir. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| branch_address | Alamat cabang. | string |
Untuk mengonfigurasi webhook Cabang yang tersedia bagi komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_arrange_appointment:available_branch.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Dapatkan slot yang tersedia
Webhook prebuilt_components_arrange_appointment:get_available_slots
digunakan oleh komponen untuk memeriksa slot waktu yang tersedia untuk tanggal dan jenis janji temu
yang diinginkan pengguna.
Parameter permintaan API
Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.
| Nama Parameter | Deskripsi | Format Input |
|---|---|---|
| $flow.preferred_date | Tanggal yang diinginkan untuk janji temu yang disediakan oleh pengguna akhir dalam format "YYYY-MM-DD". | string |
| $flow.appointment_type | Jenis janji temu untuk janji temu. | string |
| $flow.branch_code | Kode cabang yang mengidentifikasi lokasi cabang unik yang dipilih oleh pengguna akhir. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| available_slots | Daftar waktu janji temu yang tersedia untuk tanggal yang ditentukan, dalam format "HH:MM XM", misalnya ["09:00 AM", "2:30 PM"]. Jika tidak ada slot yang tersedia, parameter ini adalah daftar kosong []. |
Daftar (string) |
Untuk mengonfigurasi webhook Dapatkan slot tersedia untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_arrange_appointment:get_available_slots.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Kirim janji temu
Webhook prebuilt_components_arrange_appointment:submit_appointment
digunakan oleh komponen untuk menjadwalkan janji temu dengan tanggal, waktu, cabang, alasan janji temu, dan jenis janji temu yang dipilih 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, digunakan untuk mengidentifikasi pengguna. | string |
| $flow.preferred_date | Tanggal yang diinginkan untuk janji temu yang disediakan oleh pengguna akhir dalam format "YYYY-MM-DD". | string |
| slot $flow.preferred_slot | Waktu yang dipilih untuk janji temu yang disediakan oleh pengguna akhir dalam format "HH:MM XM". | string |
| $flow.appointment_reason | Alasan janji temu untuk janji temu. | string |
| $flow.appointment_type | Jenis janji temu untuk janji temu. | string |
| $flow.branch_code | Kode cabang yang mengidentifikasi lokasi cabang unik yang dipilih oleh pengguna akhir. | string |
Parameter respons API
Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.
| Nama Parameter | Deskripsi | Format Output |
|---|---|---|
| request_number | Nomor permintaan untuk janji temu yang dijadwalkan. | bilangan bulat |
Untuk mengonfigurasi Kirim webhook janji temu untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka Dialogflow CX Console.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_arrange_appointment:submit_appointment.
- Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
- Tinjau dan perbarui Isi permintaan guna 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 diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
- Tinjau dan perbarui setelan Authentication sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen Anda dan webhook-nya kini telah disiapkan dan siap diuji.