Beberapa produk dan fitur sedang dalam proses penggantian nama. Fitur playbook dan alur generatif juga dimigrasikan ke satu konsol gabungan. Lihat detailnya.
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.
Kode pos yang valid
Pengguna akhir memberikan kode pos lima digit; agen berhasil mengumpulkannya.
Input pengguna
Respons agen
Ucapkan atau masukkan kode pos lima digit.
27656
Anda menyebutkan kode posnya adalah 27656, apakah itu benar?
ya
Bagus, saya sudah selesai mengumpulkan kode pos.
Coba lagi
Pengguna akhir memberikan kode pos lima digit pada upaya kedua; agen berhasil menerimanya.
Input pengguna
Respons agen
Ucapkan atau masukkan kode pos lima digit.
27656
Anda menyebutkan kode posnya adalah 27657, apakah itu benar?
tidak
Maaf, saya tidak mengerti. Harap ucapkan atau masukkan kode pos lima digit.
27656
Anda menyebutkan kode posnya adalah 27656, apakah itu benar?
ya
Bagus, saya sudah selesai mengumpulkan kode pos.
Kode pos tidak valid
Pengguna akhir memberikan kode pos yang tidak valid yang panjangnya lebih dari lima digit; agen meminta ulang dan berhasil mengumpulkan kode pos yang dikoreksi.
Input pengguna
Respons agen
Ucapkan atau masukkan kode pos lima digit.
276566
Saya mendengar 123456, yang bukan kode pos lima digit yang valid. Harap ucapkan atau masukkan kode pos lima digit.
27656
Anda menyebutkan kode posnya adalah 27656, apakah itu benar?
ya
Bagus, saya sudah selesai mengumpulkan kode pos.
Input tidak dikenal
Komponen keluar dari alur setelah pengguna akhir memberikan input yang tidak dikenal tiga kali.
Input pengguna
Respons agen
Ucapkan atau masukkan kode pos lima digit.
Tidak apa-apa
Maaf, saya tidak mengerti. Bisakah Anda mengucapkan atau memasukkan kode pos lima digit lagi?
Baik
Hmm, saya masih belum bisa mendapatkannya. Pastikan Anda mengucapkan kode pos lima digit. Anda juga dapat menggunakan keypad untuk memasukkan kode pos.
Bagus
Maaf, saya kesulitan memahami respons Anda.
Konvensi penamaan
Komponen bawaan ini menggunakan konvensi penamaan berikut:
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
zip_code_collection_zip_code
Parameter ini menampilkan kode pos yang dikumpulkan oleh alur percakapan
[[["Mudah dipahami","easyToUnderstand","thumb-up"],["Memecahkan masalah saya","solvedMyProblem","thumb-up"],["Lainnya","otherUp","thumb-up"]],[["Sulit dipahami","hardToUnderstand","thumb-down"],["Informasi atau kode contoh salah","incorrectInformationOrSampleCode","thumb-down"],["Informasi/contoh yang saya butuhkan tidak ada","missingTheInformationSamplesINeed","thumb-down"],["Masalah terjemahan","translationIssue","thumb-down"],["Lainnya","otherDown","thumb-down"]],["Terakhir diperbarui pada 2025-09-04 UTC."],[[["\u003cp\u003eThis prebuilt component is designed to collect five-digit zip codes from users, ensuring only numeric inputs of that length are accepted.\u003c/p\u003e\n"],["\u003cp\u003eThe component offers additional features including repeat, waiting room, and playback functionalities, allowing the user to interact with the component in different ways.\u003c/p\u003e\n"],["\u003cp\u003eThe component is setup to handle scenarios like invalid input, retries, and unrecognized input by prompting the user for a valid input or exiting the flow after three failures.\u003c/p\u003e\n"],["\u003cp\u003eDTMF should be enabled to allow users to input numeric zip codes using the telephone keypad.\u003c/p\u003e\n"],["\u003cp\u003eThe component uses a specific naming convention for flows, intents, and parameters, such as \u003ccode\u003eZip Code Collection\u003c/code\u003e for the flow and \u003ccode\u003ezip_code\u003c/code\u003e for the collected parameter.\u003c/p\u003e\n"]]],[],null,["# Zip code collection prebuilt component\n\nThis\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\ncollects five-digit zip codes.\n\nLimitations\n-----------\n\nIn addition to the\n[common prebuilt component limitations](/dialogflow/cx/docs/concept/prebuilt-component#limits),\nthis prebuilt component has the following limitations:\n\n- Zip codes longer than five digits are not accepted.\n- Alphanumeric zip codes are not accepted.\n\nRecommended agent settings\n--------------------------\n\n[Enable DTMF](/dialogflow/cx/docs/concept/parameter#dtmf) to allow users to input numeric values using the telephone keypad.\n\nAdditional features\n-------------------\n\nThe following additional functionalities are provided by this prebuilt component:\n\n- [Repeat](/dialogflow/cx/docs/concept/prebuilt-component#repeat-functionality)\n- [Waiting room](/dialogflow/cx/docs/concept/prebuilt-component#waiting-room-functionality)\n- [Playback](/dialogflow/cx/docs/concept/prebuilt-component#playback-functionality)\n\nSample dialogs\n--------------\n\nThe following sample dialogs demonstrate common scenarios handled by this\nprebuilt component. The sample dialogs demonstrate behavior when the component is\ncalled via telephony, which triggers the Default Welcome Intent and the first\nagent response at the start of the conversation.\n\n### Valid zip code\n\nEnd-user provides a five-digit zip code; agent successfully collects it.\n\n### Retry\n\nEnd-user provides a five-digit zip code in the second attempt; agent successfully accepts it.\n\n### Invalid zip code\n\nEnd-user provides an invalid zip code that is over five digits long; agent reprompts and successfully collects the corrected zip code.\n\n### Unrecognized input\n\nComponent exits the flow after the end-user provides unrecognized input three times.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\n### Output parameters\n\nOutput parameters are session parameters that will remain active after exiting\nthe component. These parameters contain important information collected by the\ncomponent. This prebuilt component provides values for the following output\nparameters:\n\nBasic setup\n-----------\n\nTo set up this prebuilt component:\n\n1. [Import the prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component#import).\n\n### Complete\n\nYour agent and should now be set up and ready to test."]]