Komponen bawaan masukan

Komponen bawaan masukan mengumpulkan masukan kuantitatif dan kualitatif dari pengguna akhir.

Komponen pertama-tama melakukan pencarian menggunakan Check last service webhook yang dikonfigurasi untuk memeriksa apakah masukan terbaru diberikan oleh pengguna akhir tersebut atau tidak. Jika tidak ada masukan terbaru, komponen akan meminta pengguna untuk memberikan skor masukan kuantitatif antara satu dan lima. Jika masukan tersebut negatif, komponen dapat secara opsional mengumpulkan masukan kualitatif berformat bebas dari pengguna.

Batasan

Selain batasan komponen bawaan umum, komponen bawaan ini memiliki batasan berikut:

• Komponen ini mengasumsikan bahwa nomor telepon pelanggan dikelola di sistem CRM (Pengelolaan Hubungan Pelanggan) atau layanan lainnya.
• Pelanggan lama yang menggunakan nomor telepon alternatif untuk menghubungi tidak akan diautentikasi oleh komponen ini.

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.

Masukan positif

Respons dari Check last feedback webhook menunjukkan bahwa pengguna akhir tidak memberikan masukan baru-baru ini. Agen meminta skor masukan pengguna, dan pengguna memberikan skor yang menunjukkan pengalaman positif.

Input pengguna	Respons agen
	Terima kasih telah menelepon. Masukan Anda penting bagi kami. Harap luangkan waktu sejenak untuk menyampaikan pendapat Anda tentang layanan yang Anda terima hari ini dengan menjawab beberapa pertanyaan singkat. Dalam skala 1 hingga 5, di mana 1 paling tidak puas dan 5 paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
5
	Bagus, terima kasih atas masukan positif Anda.

Masukan negatif

Respons dari Check last feedback webhook menunjukkan bahwa pengguna akhir tidak memberikan masukan baru-baru ini. Agen meminta skor masukan pengguna, dan pengguna memberikan skor yang menunjukkan pengalaman negatif. Agen kemudian meminta masukan kualitatif dari pengguna.

Input pengguna	Respons agen
	Terima kasih telah menelepon. Masukan Anda penting bagi kami. Harap luangkan waktu sejenak untuk menyampaikan pendapat Anda tentang layanan yang Anda terima hari ini dengan menjawab beberapa pertanyaan singkat. Dalam skala 1 hingga 5, di mana 1 paling tidak puas dan 5 paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
2
	Harap beri tahu kami bagaimana kami dapat meningkatkan pengalaman ini untuk Anda.
Beberapa pertanyaan saya tidak dijawab sepenuhnya.
	Terima kasih atas masukan Anda. Kami mohon maaf atas ketidaknyamanan yang ditimbulkan dan kami berusaha untuk memberi Anda pengalaman yang lebih baik di lain waktu.

Masukan terbaru

Respons dari Periksa webhook masukan terakhir menunjukkan bahwa pengguna akhir baru-baru ini memberikan masukan, sehingga agen tidak meminta input lebih lanjut kepada pengguna.

Input pengguna	Respons agen
	Terima kasih sudah menghubungi kami.

Input tidak valid

Respons dari Check last feedback webhook menunjukkan bahwa pengguna akhir tidak memberikan masukan baru-baru ini. Agen meminta skor masukan pengguna, dan pengguna memberikan input yang tidak valid beberapa kali. Komponen mengakhiri flow dengan kegagalan.

Input pengguna	Respons agen
	Terima kasih telah menelepon. Masukan Anda penting bagi kami. Harap luangkan waktu sejenak untuk menyampaikan pendapat Anda tentang layanan yang Anda terima hari ini dengan menjawab beberapa pertanyaan singkat. Dalam skala 1 hingga 5, di mana 1 paling tidak puas dan 5 paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
-1
	Maaf, kami tidak mengerti. Silakan beri tahu kami skor umpan balik yang 1, 2, 3, 4, atau 5.
100
	Maaf, kami tidak mengerti. Silakan beri tahu kami skor umpan balik yang 1, 2, 3, 4, atau 5.
Bagus
	Maaf, jumlah percobaan ulang maksimum telah terlampaui. Coba lagi setelah beberapa saat.

Konvensi penamaan

Komponen bawaan ini menggunakan konvensi penamaan berikut:

Fitur	Format	Contoh
Flow	[Nama Komponen]	Masukan
Parameter	[param_name]	feedback_score
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_feedback:last_feedback_check

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	Nomor telepon lokal pengguna, yang digunakan untuk mengidentifikasi pengguna dalam permintaan API. Nomor telepon tidak boleh berisi kode negara.	string
$flow.minimum_feedback_score	Parameter ini menunjukkan ambang batas untuk apa yang dianggap sebagai skor masukan negatif atau positif. Skor rendah (sama dengan atau kurang dari nilai parameter ini) menunjukkan pengalaman negatif dan skor tinggi (lebih besar dari nilai parameter ini) menunjukkan pengalaman positif. Jika pengguna akhir memberikan skor rendah, {i>feedback<i} kualitatif diminta dari pengguna, menanyakan bagaimana pengalaman pengguna dapat ditingkatkan. Nilai default untuk parameter ini adalah 3.	bilangan bulat
$flow.feedback_max_retry_count	Parameter ini adalah parameter yang dapat dikonfigurasi yang menangkap jumlah maksimum percobaan ulang yang diberikan kepada pengguna. Nilai yang ditetapkan ke parameter ini harus kurang dari satu dari jumlah percobaan yang tersedia. Nilai defaultnya adalah 2, yang berarti pemanggil mendapatkan tiga kali percobaan untuk memberikan informasi yang diminta.	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
feedback_score	Parameter ini menangkap skor masukan yang diberikan oleh pengguna akhir. Nilai yang valid adalah bilangan bulat antara satu dan lima, inklusif.	bilangan bulat
feedback_comment	Parameter ini menangkap komentar kualitatif yang diberikan oleh pengguna akhir, jika ada.	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 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.

Memeriksa masukan terakhir

Webhook prebuilt_components_feedback:last_feedback_check digunakan oleh komponen untuk memeriksa apakah pengguna baru-baru ini memberikan masukan. Jangka waktu saat masukan yang diberikan sebelumnya dianggap terbaru ditentukan oleh layanan eksternal yang terintegrasi dengan webhook ini, yang dapat dikonfigurasi oleh pemilik layanan.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
phone_number	Nomor telepon lokal pengguna, tanpa kode negara, digunakan untuk mengidentifikasi pengguna.	bilangan bulat

Parameter respons API

Parameter berikut diambil dari respons API yang akan digunakan oleh komponen.

Nama Parameter	Deskripsi	Format Output
last_feedback_time_elapsed	Menunjukkan apakah masukan telah diberikan oleh pengguna baru-baru ini. true menunjukkan jangka waktu telah berlalu sejak pengguna terakhir memberikan masukan dan tidak ada masukan terbaru yang ditemukan. false menunjukkan bahwa masukan diberikan baru-baru ini, dan tidak cukup waktu yang telah berlalu sejak pengguna terakhir kali memberikan masukan.	boolean

Untuk mengonfigurasi webhook Periksa masukan terakhir 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_feedback:last_feedback_check.
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.

Perbarui masukan

Webhook prebuilt_components_feedback:update_feedback digunakan oleh komponen untuk mengirim masukan yang dikumpulkan ke layanan eksternal.

Parameter permintaan API

Parameter berikut disediakan oleh komponen sebagai input ke permintaan API.

Nama Parameter	Deskripsi	Format Input
phone_number	Nomor telepon lokal pengguna, tanpa kode negara, digunakan untuk mengidentifikasi pengguna.	string
feedback_score	Parameter ini menyimpan skor masukan yang diberikan oleh pengguna akhir. Nilai yang diharapkan adalah bilangan bulat antara satu dan lima, inklusif.	bilangan bulat
feedback_comment	Parameter ini menyimpan komentar masukan kualitatif yang diberikan oleh pengguna akhir.	string

Untuk mengonfigurasi webhook Masukan pembaruan 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_feedback:update_feedback.
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.