계정 잔액 사전 빌드된 구성요소는 고객의 인증 레벨을 확인한 후 인증된 고객에게 계정 잔액 정보를 제공합니다. 고객이 여러 계정을 갖고 있는 경우 구성요소는 고객이 계정 잔액을 검색하려는 특정 계정을 확인합니다. 이 구성요소는 인증 사전 빌드된 구성요소를 사용해서 사용자를 인증합니다.
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
인증
인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 인증 웹훅 설정을 참조하세요.
계정 검증
prebuilt_components_account_services:validate_account 웹훅은 구성요소에서 사용자의 등록된 전화번호 및 제공된 계좌 번호의 마지막 4자리를 기준으로 계좌가 존재하는지 확인하는 데 사용됩니다.
계좌가 존재하는 경우 웹훅에서 계좌 잔액도 반환합니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
매개변수 이름
설명
입력 형식
$session.params.phone_number
사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다.
문자열
$session.params.last_four_digit_of_account_number
사용자가 계정 잔액 정보를 수신하도록 선택하고 확인한 계좌 번호의 마지막 네 자리 숫자입니다.
문자열
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
매개변수 이름
설명
출력 형식
account_found
사용자의 등록된 계좌에 제공된 마지막 4자리 숫자가 포함된 계좌가 있는지 여부를 나타냅니다.
[[["이해하기 쉬움","easyToUnderstand","thumb-up"],["문제가 해결됨","solvedMyProblem","thumb-up"],["기타","otherUp","thumb-up"]],[["이해하기 어려움","hardToUnderstand","thumb-down"],["잘못된 정보 또는 샘플 코드","incorrectInformationOrSampleCode","thumb-down"],["필요한 정보/샘플이 없음","missingTheInformationSamplesINeed","thumb-down"],["번역 문제","translationIssue","thumb-down"],["기타","otherDown","thumb-down"]],["최종 업데이트: 2025-01-21(UTC)"],[[["\u003cp\u003eThis component checks a customer's authentication level and then provides account balance information, confirming the specific account if multiple accounts exist.\u003c/p\u003e\n"],["\u003cp\u003eThe component uses an Authentication prebuilt component to verify users and does not encrypt any data as a limitation.\u003c/p\u003e\n"],["\u003cp\u003eThe component can handle scenarios where a user has a single account or multiple accounts, retrieving and confirming the correct account details.\u003c/p\u003e\n"],["\u003cp\u003eInput parameters, such as authentication level and account details, are used to configure the component's behavior, and output parameters like account balance and phone number are retained after the component's use.\u003c/p\u003e\n"],["\u003cp\u003eTo use this component, you must configure flexible webhooks to integrate with external services, including an authentication webhook and a webhook to validate account information and retrieve the balance.\u003c/p\u003e\n"]]],[],null,["# Account balance prebuilt component\n\nThe account balance\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\nchecks a customer's authentication level, then provides account balance\ninformation to an authenticated customer. If the customer has multiple accounts,\nthe component confirms the specific account the customer would like to retrieve\naccount balance for. This component uses the\n[Authentication](/dialogflow/cx/docs/concept/prebuilt-component/authentication)\nprebuilt component to authenticate users.\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### Single account\n\nEnd-user has a single account and is provided with the account balance.\n\n### Multiple accounts\n\nEnd-user has multiple accounts; agent requests and confirms the last four digits\nof the account number and provides the account balance for that account.\n\n### Multiple accounts with context\n\nEnd-user has multiple accounts, the referred account number is retained from previous intent, and is provided with the account balance.\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### Validate account\n\nThe `prebuilt_components_account_services:validate_account` webhook is used\nby the component to verify that an account exists based on the user's\nregistered phone number and the last four digits of the account number provided.\nThe webhook also returns the account balance, if an account exists.\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 account 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:validate_account 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."]]
