Mengatur komponen bawaan janji temu

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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Build.
  5. Klik komponen yang diimpor di bagian Flow.
  6. Klik Halaman Awal di bagian Halaman.
  7. Klik Rute yang benar di Halaman Awal.
  8. Di jendela Rute, edit nilai Presets 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, 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:

  1. Impor komponen bawaan.
  2. 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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_arrange_appointment:get_account.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. 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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_arrange_appointment:get_branch.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. 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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_arrange_appointment:available_branch.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. 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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_arrange_appointment:get_available_slots.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. 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.

  1. Buka Dialogflow CX Console.
  2. Pilih project Google Cloud Anda.
  3. Pilih agen Anda.
  4. Pilih tab Kelola.
  5. Klik Webhook.
  6. Pilih webhook prebuilt_components_arrange_appointment:submit_appointment.
  7. Ganti URL di kolom Webhook URL Dialogflow dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang tepat di menu dropdown.
  8. Tinjau dan perbarui Isi permintaan guna membentuk format permintaan yang tepat untuk 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 Authentication sesuai kebutuhan.
  11. Klik Simpan.

Selesai

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