[[["易于理解","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 component, the lock card, enables users to authenticate, retrieve their registered cards, and lock or reactivate them, using a customized version of the Authentication component.\u003c/p\u003e\n"],["\u003cp\u003eUsers can choose to temporarily or permanently lock a card, and the system will generate a corresponding request to perform the requested task.\u003c/p\u003e\n"],["\u003cp\u003eAfter permanently locking a card, users are given the option to request a new card to be reissued, with the necessary information collected and an issuance request being created by the system.\u003c/p\u003e\n"],["\u003cp\u003eThe component uses flexible webhooks for essential functions such as authenticating users, getting card details, validating cards, locking cards, and reissuing cards, all of which need to be configured to interact with external services.\u003c/p\u003e\n"],["\u003cp\u003eThis prebuilt component does not encrypt any data.\u003c/p\u003e\n"]]],[],null,["# Lock card prebuilt component\n\nThe lock card\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\nauthenticates the user, retrieves cards registered to the user, and allows the\nuser to lock a card temporarily, lock a card permanently, or reactivate a card.\nAfter confirming a locked card, the component allows the user to request a new\ncard. This component uses a customized version of the\n[Authentication](/dialogflow/cx/docs/concept/prebuilt-component/authentication)\nprebuilt component to authenticate cardholders.\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- This component does not encrypt any data.\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### Unauthenticated user with multiple cards\n\nThe agent identifies that the user has not been previously authenticated and\ncollects information to verify that the user is a registered cardholder. Once\nthe user has authenticated, the agent retrieves information about the cards\nregistered to the user. The user confirms they would like to temporarily lock a\nselected card, and the agent generates the lock card request.\n\n### Authenticated user with single card\n\nThe agent identifies that the user has been previously authenticated and retrieves\ninformation about the card registered to the user. The user selects to\npermanently lock the card, and the agent generates the permanently lock card\nrequest. The agent then asks the user whether they would like to reissue a new\ncard for the permanently locked card, and creates a reissue request for the card.\n\n### Reactivate card\n\nThe agent identifies that the user requires additional authentication and sends\na one-time password to verify the user's identity. The user requests to reactivate\na card, and the agent transfers them to a human agent to continue.\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 configuration describing 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### Authentication\n\nIf you have not previously configured external services required for\nauthentication, you will need to configure them to enable authentication of\nusers for this component. See [Authentication webhook setup](/dialogflow/cx/docs/concept/prebuilt-component/authentication#webhook-setup)\nfor detailed instructions.\n\n### Get card details\n\nThe `prebuilt_components_account_services:get_card_details` webhook is used\nby the component to get information about the card(s) registered to a user.\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 Get card details 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_account_services:get_card_details 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### Validate card\n\nThe `prebuilt_components_lock_card:validate_card` webhook is used\nby the component to get information about a specific card registered to a user's\naccount.\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 Validate card 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_lock_card:validate_card 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### Lock card\n\nThe `prebuilt_components_lock_card:lock_card_ticket_number` webhook\nis used by the component to create a request to lock a selected card.\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 Lock card 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_lock_card:lock_card_ticket_number 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### Reissue card\n\nThe `prebuilt_components_lock_card:reissue_card_number` webhook is\nused by the component to create a request to reissue a new or upgraded card.\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 Reissue card 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_lock_card:reissue_card_number 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."]]
