[[["易于理解","easyToUnderstand","thumb-up"],["解决了我的问题","solvedMyProblem","thumb-up"],["其他","otherUp","thumb-up"]],[["很难理解","hardToUnderstand","thumb-down"],["信息或示例代码不正确","incorrectInformationOrSampleCode","thumb-down"],["没有我需要的信息/示例","missingTheInformationSamplesINeed","thumb-down"],["翻译问题","translationIssue","thumb-down"],["其他","otherDown","thumb-down"]],["最后更新时间 (UTC)：2025-08-18。"],[[["\u003cp\u003eThis prebuilt component captures and validates both the country code and the telephone number provided by the user.\u003c/p\u003e\n"],["\u003cp\u003eThe component can handle users providing the country code and telephone number in either one or two separate turns.\u003c/p\u003e\n"],["\u003cp\u003eThe system uses the IS_PHONE_NUMBER function to ensure the validity of the provided telephone number, but numbers over 16 digits are not accepted.\u003c/p\u003e\n"],["\u003cp\u003eThis prebuilt component features repeat, waiting room, and playback functionalities for user interaction, and also offers output parameters to return the collected data.\u003c/p\u003e\n"],["\u003cp\u003eThe component can fail after 3 attempts at invalid input, and provides various response messages to guide the end-user, including re-prompting when there is invalid input.\u003c/p\u003e\n"]]],[],null,["# Telephone number collection prebuilt component\n\nThis\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\ncaptures and validates country code and telephone number.\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- Telephone numbers more than 16 digits long 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 telephone number in two turns\n\nEnd-user provides country code first followed by telephone number; agent successfully validates and accepts it.\n\n### Valid telephone number in single turn\n\nEnd-user provides country code and telephone number at the same time, agent successfully validates and accepts it.\n\n### Invalid phone number\n\nEnd-user provides a country code and telephone number in one turn; agent checks\nand finds the provided telephone number is of valid length (within 16 digits) but\nnot a valid telephone number. Then agent re-prompts the end-user to provide telephone number.\n\n### Invalid country code and telephone number\n\nEnd-user provides a country code and telephone number in one turn; agent checks\nand finds the provided country code and telephone number is invalid. The agent then\nre-prompts the end-user to provide country code and telephone number.\n\n### Unrecognized input\n\nComponent exits the flow after the end-user provides unrecognized input three times.\n\nTelephone number validation\n---------------------------\n\nThe telephone number prebuilt component uses the [IS_PHONE_NUMBER system function](/dialogflow/cx/docs/reference/system-functions#func-isphonenumber)\nto validate that the phone number matches a valid pattern.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\nOutput parameters\n-----------------\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 should now be set up and ready to test."]]
