[[["易于理解","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 feedback component collects feedback from users, asking for a quantitative score between one and five, and if the score is negative, it can also collect qualitative feedback.\u003c/p\u003e\n"],["\u003cp\u003eThe component uses a webhook to check if recent feedback exists from a user, and if not, it proceeds to ask for a feedback score.\u003c/p\u003e\n"],["\u003cp\u003eIf a user provides a negative feedback score, the component can optionally request the user to provide additional qualitative feedback to understand how to improve.\u003c/p\u003e\n"],["\u003cp\u003eThe component has limitations, such as assuming customer phone numbers are maintained in a CRM, and it may not authenticate existing customers using alternate phone numbers.\u003c/p\u003e\n"],["\u003cp\u003eWebhooks are essential for this component to function, including one for checking the last feedback provided and another to update feedback in an external service, and various parameters must be set for the webhooks to operate correctly.\u003c/p\u003e\n"]]],[],null,["# Feedback prebuilt component\n\nThe feedback\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component) collects\nquantitative and qualitative feedback from the end-user.\n\nThe component first performs a lookup using the configured [Check last feedback webhook](#check_last_feedback)\nto check whether recent feedback was provided by that particular end-user.\nIf no recent feedback exists, the component asks the user to provide a\nquantitative feedback score between one and five. If the feedback is negative,\nthe component can optionally collect freeform qualitative feedback from the user.\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- The component assumes that the customer phone numbers are maintained in a CRM (Customer Relationship Management) system or other service.\n- Existing customers using an alternate phone number to contact will not be authenticated by this component.\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### Positive feedback\n\nThe response from the [Check last feedback webhook](#check_last_feedback)\nindicates that the end-user has not provided feedback recently. Agent requests\nuser's feedback score, and the user provides a score indicating a positive experience.\n\n### Negative feedback\n\nThe response from the [Check last feedback webhook](#check_last_feedback)\nindicates that the end-user has not provided feedback recently. Agent\nrequests user's feedback score, and the user provides a score indicating a\nnegative experience. The agent then requests qualitative feedback from the user.\n\n### Recent feedback\n\nThe response from the [Check last feedback webhook](#check_last_feedback)\nindicates that the end-user has provided feedback recently, so the agent does\nnot ask the user for further input.\n\n### Invalid input\n\nThe response from the [Check last feedback webhook](#check_last_feedback)\nindicates that the end-user has not provided feedback recently. Agent\nrequests user's feedback score, and the user provides invalid input multiple\ntimes. The component ends the flow with failure.\n\nNaming conventions\n------------------\n\nThis prebuilt component uses the following naming conventions:\n\nInput parameters\n----------------\n\nInput parameters are parameters that are used to configure certain behaviors of\nthe component. The parameters will be used by one or more conditions within the\nflow to determine how the component should behave. Flow-scoped parameters must\nbe set on the start page of the component as described below. Session-scoped\nparameters may be set either by a calling flow, or on the start\npage of this component.\n\nThis prebuilt component accepts the following input parameters:\n\n#### To configure the input parameters for this component, expand for instructions.\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select the **Build** tab.\n5. Click the imported component in the **Flows** section.\n6. Click the Start Page in the **Pages** section.\n7. Click the **true** Route in the Start Page.\n8. In the Route window, edit the **Parameter Presets** values as needed.\n9. Click **Save**.\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).\n2. Configure the provided [flexible webhooks](/dialogflow/cx/docs/concept/webhook#flexible) with your external services, see Webhook setup below.\n\nWebhook setup\n-------------\n\nIn order to use this component, you will need to configure the included\n[flexible webhooks](/dialogflow/cx/docs/concept/webhook#flexible) to retrieve\nneeded information from your external services.\n\n### Check last feedback\n\nThe `prebuilt_components_feedback:last_feedback_check` webhook is used by the\ncomponent to check whether a user has provided feedback recently. The time period\nduring which previously-provided feedback is considered recent is defined by the\nexternal service integrated with this webhook, which can be configured by the\nservice's owner.\n\n#### API request parameters\n\nThe following parameters are provided by the component as inputs to the API request.\n\n#### API response parameters\n\nThe following parameters are pulled from the API response to be used by the component.\n\n#### To configure the Check last feedback webhook for this component, expand for instructions.\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select the **Manage** tab.\n5. Click **Webhooks**.\n6. Select the prebuilt_components_feedback:last_feedback_check webhook.\n7. Replace the URL in the Conversational Agents (Dialogflow CX) **Webhook URL** field with the endpoint for the service you want to integrate with. Select the proper **Method** in the dropdown.\n8. Review and update the **Request body** to form the proper request format for your webhook.\n9. Review and update the **Response configuration** to extract specific fields from your webhook's response. Do not modify the parameter names, as these are required by the component to access the returned field values.\n10. Review and update the **Authentication** settings as needed.\n11. Click **Save**.\n\n### Update feedback\n\nThe `prebuilt_components_feedback:update_feedback` webhook is used by the\ncomponent to send collected feedback to an external service.\n\n#### API request parameters\n\nThe following parameters are provided by the component as inputs to the API request.\n\n#### To configure the Update feedback webhook for this component, expand for instructions.\n\n1. Open the [Dialogflow CX console](https://dialogflow.cloud.google.com/cx/projects).\n2. Choose your Google Cloud project.\n3. Select your agent.\n4. Select the **Manage** tab.\n5. Click **Webhooks**.\n6. Select the prebuilt_components_feedback:update_feedback webhook.\n7. Replace the URL in the Conversational Agents (Dialogflow CX) **Webhook URL** field with the endpoint for the service you want to integrate with. Select the proper **Method** in the dropdown.\n8. Review and update the **Request body** to form the proper request format for your webhook.\n9. Review and update the **Response configuration** to extract specific fields from your webhook's response. Do not modify the parameter names, as these are required by the component to access the returned field values.\n10. Review and update the **Authentication** settings as needed.\n11. Click **Save**.\n\n### Complete\n\nYour agent and its webhooks should now be set up and ready to test."]]
