Komponen bawaan umpan balik mengumpulkan masukan kuantitatif dan kualitatif dari pengguna akhir.
Komponen ini pertama-tama melakukan pencarian menggunakan Webhook periksa masukan terakhir yang dikonfigurasi untuk memeriksa apakah masukan terbaru diberikan oleh pengguna akhir tertentu tersebut. Jika tidak ada masukan terbaru, komponen akan meminta pengguna untuk memberikan skor masukan kuantitatif antara satu dan lima. Jika masukan negatif, komponen dapat secara opsional mengumpulkan masukan kualitatif bebas format 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 dihubungi tidak akan diautentikasi oleh komponen ini.
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.
Masukan positif
Respons dari webhook Periksa masukan terakhir menunjukkan bahwa pengguna akhir 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 membagikan 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 akhir belum 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 menghubungi kami. Masukan Anda penting bagi kami. Harap luangkan waktu sejenak untuk membagikan 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 | |
Beri tahu kami cara meningkatkan pengalaman ini bagi Anda. | |
Beberapa pertanyaan saya tidak terjawab sepenuhnya. | |
Terima kasih atas masukan Anda. Kami mohon maaf atas ketidaknyamanan yang ditimbulkan dan akan berusaha memberikan pengalaman yang lebih baik pada Anda di lain waktu. |
Masukan terbaru
Respons dari webhook Periksa masukan terakhir menunjukkan bahwa pengguna akhir baru-baru ini memberikan masukan, 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 akhir 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 membagikan 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. Beri tahu kami skor masukan yang berupa 1, 2, 3, 4, atau 5. | |
100 | |
Maaf, kami tidak mengerti. Beri tahu kami skor masukan yang berupa 1, 2, 3, 4, atau 5. | |
Bagus | |
Maaf, jumlah maksimum percobaan ulang 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 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.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 | Parameter ini menunjukkan nilai minimum untuk 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, masukan kualitatif akan diminta dari pengguna, yang menanyakan cara meningkatkan pengalaman. Nilai default untuk parameter ini adalah 3 . |
bilangan bulat |
$flow.feedback_max_retry_count | Ini adalah parameter yang dapat dikonfigurasi yang menangkap jumlah maksimum percobaan ulang yang diberikan kepada pengguna. Nilai yang ditetapkan ke parameter ini harus satu kurang dari jumlah percobaan yang tersedia. Nilai defaultnya adalah 2 , yang berarti pemanggil mendapatkan tiga percobaan untuk memberikan informasi yang diminta. |
bilangan bulat |
Untuk mengonfigurasi parameter input untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Build.
- Klik komponen yang diimpor di bagian Alur.
- Klik Halaman Awal di bagian Halaman.
- Klik Rute true di Halaman Mulai.
- Di jendela Rute, edit nilai Preset 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 |
---|---|---|
feedback_score | Parameter ini merekam 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 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:
- Impor komponen bawaan.
- 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 telah memberikan masukan baru-baru ini. Jangka waktu
saat masukan yang diberikan sebelumnya dianggap baru 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, yang digunakan untuk mengidentifikasi pengguna. | bilangan bulat |
Parameter respons API
Parameter berikut diambil dari respons API untuk digunakan oleh komponen.
Nama Parameter | Deskripsi | Format Output |
---|---|---|
last_feedback_time_elapsed | Menunjukkan apakah masukan telah diberikan oleh pengguna baru-baru ini. true menunjukkan periode waktu yang 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 yang berlalu sejak pengguna terakhir kali memberikan masukan. |
boolean |
Untuk mengonfigurasi webhook Check last feedback untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_feedback:last_feedback_check.
- 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.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Memperbarui 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, yang 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 Update feedback untuk komponen ini, luaskan untuk mendapatkan petunjuk.
- Buka konsol Dialogflow CX.
- Pilih project Google Cloud Anda.
- Pilih agen Anda.
- Pilih tab Kelola.
- Klik Webhook.
- Pilih webhook prebuilt_components_feedback:update_feedback.
- 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.
- Tinjau dan perbarui Isi permintaan untuk membentuk format permintaan yang tepat bagi 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 Autentikasi sesuai kebutuhan.
- Klik Simpan.
Selesai
Agen dan webhook-nya kini telah disiapkan dan siap diuji.