Komponen bawaan masukan

Komponen bawaan masukan mengumpulkan masukan kuantitatif dan kualitatif dari pengguna.

Komponen ini pertama-tama melakukan pencarian menggunakan webhook Check last feedback yang dikonfigurasi untuk memeriksa apakah pengguna telah memberikan masukan baru-baru ini. Jika tidak ada masukan terbaru, komponen akan meminta pengguna memberikan skor masukan kuantitatif antara 1 dan 5. Jika masukan negatif, komponen dapat mengumpulkan masukan kualitatif dalam bentuk bebas dari pengguna.

Batasan

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

• Komponen ini mengasumsikan bahwa Anda mengelola nomor telepon pelanggan di sistem Pengelolaan Hubungan Pelanggan (CRM) atau layanan lainnya.
• Komponen ini tidak mengautentikasi pelanggan lama yang menggunakan nomor telepon alternatif untuk menghubungi Anda.

Contoh dialog

Contoh dialog berikut menunjukkan skenario umum yang ditangani oleh komponen bawaan ini. Diagram ini menggambarkan apa yang terjadi saat telepon memulai komponen, yang memicu Intent Sambutan Default dan respons agen pertama di awal percakapan.

Masukan positif

Respons dari Webhook periksa masukan terakhir menunjukkan bahwa pengguna belum 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 menghubungi kami. 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, dengan 1 berarti paling tidak puas dan 5 berarti paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
5
	Bagus, terima kasih atas masukan positif Anda.

Masukan negatif

Respons dari Webhook periksa masukan terakhir menunjukkan bahwa pengguna belum memberikan masukan baru-baru ini. Agen meminta skor masukan pengguna, dan pengguna memberikan skor yang menunjukkan pengalaman negatif. Kemudian, agen akan meminta masukan kualitatif dari pengguna.

Input Pengguna	Respons Agen
	Terima kasih telah menghubungi kami. 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, dengan 1 berarti paling tidak puas dan 5 berarti paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
2
	Terima kasih atas masukan Anda. 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 Anda alami dan akan berusaha memberikan pengalaman yang lebih baik di lain waktu.

Masukan terbaru

Respons dari webhook Check last feedback menunjukkan bahwa pengguna telah memberikan masukan baru-baru ini, sehingga agen tidak meminta input lebih lanjut dari pengguna.

Input Pengguna	Respons Agen
	Terima kasih sudah menghubungi kami.

Input tidak valid

Respons dari Webhook periksa masukan terakhir menunjukkan bahwa pengguna belum memberikan masukan baru-baru ini. Agen meminta skor masukan pengguna, dan pengguna memberikan input yang tidak valid beberapa kali. Komponen mengakhiri alur dengan kegagalan.

Input Pengguna	Respons Agen
	Terima kasih telah menghubungi kami. 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, dengan 1 berarti paling tidak puas dan 5 berarti paling puas, seberapa puaskah Anda dengan layanan yang Anda terima hari ini?
-1
	Maaf, kami tidak mengerti. Masukkan skor masukan 1, 2, 3, 4, atau 5.
100
	Maaf, kami tidak mengerti. Masukkan skor masukan 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	[Component Name]	Masukan
Parameter	[param_name]	feedback_score
Webhook	prebuilt_components_[component_name]:[webhook_action]	prebuilt_components_feedback:last_feedback_check

Parameter input

Parameter input mengonfigurasi perilaku tertentu dari komponen. Satu atau beberapa kondisi dalam alur menggunakan parameter ini untuk menentukan perilaku komponen. Anda harus menetapkan parameter cakupan alur di halaman awal komponen seperti yang dijelaskan di bawah. Anda dapat menetapkan parameter cakupan sesi menggunakan 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 menyertakan kode negara.	string
$flow.minimum_feedback_score	Menunjukkan nilai minimum untuk skor masukan yang dianggap 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 memberikan skor rendah, masukan kualitatif akan diminta dari pengguna, yang menanyakan bagaimana pengalaman tersebut dapat ditingkatkan. Nilai default untuk parameter ini adalah 3.	integer
$flow.feedback_max_retry_count	Parameter yang dapat dikonfigurasi yang mencatat jumlah maksimum percobaan ulang yang diberikan kepada pengguna. Nilai yang ditetapkan ke parameter ini harus satu angka lebih kecil dari jumlah percobaan yang tersedia. Nilai defaultnya adalah 2, yang berarti penelepon mendapatkan tiga kali percobaan untuk memberikan informasi yang diminta.	integer

Untuk mengonfigurasi parameter input komponen ini, luaskan untuk melihat 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 Flows.
6. Klik Start Page di bagian Pages.
7. Klik Route true di Start Page.
8. Di jendela Route, edit nilai Parameter Presets sesuai kebutuhan.
9. Klik Simpan.

Parameter output

Parameter output adalah parameter sesi yang 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	Mencatat skor masukan yang diberikan oleh pengguna. Nilai yang valid adalah bilangan bulat antara 1 dan 5, inklusif.	integer
feedback_comment	Mencatat komentar kualitatif yang diberikan oleh pengguna, jika ada.	string
transfer_reason	Menunjukkan alasan alur keluar, jika tidak berhasil. Nilai yang ditampilkan adalah salah satu dari berikut ini: agent: pengguna meminta agen manusia pada suatu waktu selama percakapan. denial_of_information: pengguna menolak untuk membagikan informasi yang diminta oleh komponen. max_no_input: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tanpa input. Lihat peristiwa bawaan tanpa input. max_no_match: percakapan mencapai jumlah maksimum percobaan ulang untuk peristiwa tidak ada kecocokan. 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 layanan eksternal Anda, lihat Penyiapan webhook.

Penyiapan webhook

Untuk menggunakan komponen ini, konfigurasikan webhook fleksibel yang disertakan untuk mengambil informasi yang diperlukan dari layanan eksternal Anda.

Memeriksa masukan terakhir

Komponen ini menggunakan webhook prebuilt_components_feedback:last_feedback_check untuk memeriksa apakah pengguna telah memberikan masukan baru-baru ini. Layanan eksternal yang terintegrasi dengan webhook ini menentukan jangka waktu saat masukan yang diberikan sebelumnya dianggap sebagai masukan terbaru, dan pemilik layanan dapat mengonfigurasi periode ini.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

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

Parameter respons API

Komponen mengambil parameter berikut dari respons API:

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

Untuk mengonfigurasi webhook Check last feedback untuk komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_feedback:last_feedback_check.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Memperbarui masukan

Komponen ini menggunakan webhook prebuilt_components_feedback:update_feedback untuk mengirim masukan yang dikumpulkan ke layanan eksternal.

Parameter permintaan API

Komponen ini menyediakan parameter berikut sebagai input untuk permintaan API:

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

Untuk mengonfigurasi webhook Update feedback untuk komponen ini, luaskan untuk melihat petunjuk.

1. Buka konsol Dialogflow CX.
2. Pilih project Google Cloud Anda.
3. Pilih agen Anda.
4. Pilih tab Kelola.
5. Klik Webhooks.
6. Pilih webhook prebuilt_components_feedback:update_feedback.
7. Ganti URL webhook di kolom Webhook URL Dialogflow CX dengan endpoint untuk layanan yang ingin Anda integrasikan. Pilih Metode yang sesuai di dropdown.
8. Tinjau dan perbarui Isi permintaan untuk 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 nama ini diperlukan oleh komponen untuk mengakses nilai kolom yang ditampilkan.
10. Tinjau dan perbarui setelan Autentikasi sesuai kebutuhan.
11. Klik Simpan.

Selesai

Komponen bawaan masukan dan webhook-nya kini telah disiapkan dan siap untuk diuji.