사전 빌드된 인사말 구성요소는 발신자의 전화번호(ANI)를 검색합니다(사용 가능한 경우). 전화번호가 검색되면 구성요소는 전화번호를 사용하여 소프트 인증을 수행하여 등록된 전화번호와 대조하여 확인합니다. 그런 다음 에이전트가 계정 정보를 기반으로 최종 사용자에게 인사합니다.
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
계정 세부정보 가져오기
prebuilt_components_greeting:get_account_details 웹훅은 구성요소에서 ANI를 사용하여 발신자를 식별하는 데 사용됩니다. 구성된 외부 서비스에 발신자 전화번호가 있는 경우 발신자 이름과 이메일을 포함하여 환경을 맞춤설정하는 데 필요한 관련 정보가 검색됩니다.
[[["이해하기 쉬움","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-03-04(UTC)"],[[["\u003cp\u003eThis component authenticates callers by retrieving their phone number (ANI) and validating it against registered numbers in a CRM or similar system.\u003c/p\u003e\n"],["\u003cp\u003eIf the caller's number is identified, the component delivers a personalized greeting message, otherwise, a standard greeting is used.\u003c/p\u003e\n"],["\u003cp\u003eThe component has limitations, including the requirement for phone numbers to be stored in an external CRM and that alternative numbers won't be authenticated.\u003c/p\u003e\n"],["\u003cp\u003eThe \u003ccode\u003eprebuilt_components_greeting:get_account_details\u003c/code\u003e webhook is used to retrieve caller details from an external service for personalization, requiring specific API request and response parameters.\u003c/p\u003e\n"],["\u003cp\u003eConfiguration involves importing the component, setting input parameters like the company name, and configuring the webhook to interact with your external CRM to retrieve caller details.\u003c/p\u003e\n"]]],[],null,["# Greeting prebuilt component\n\nThe greeting\n[prebuilt component](/dialogflow/cx/docs/concept/prebuilt-component)\nretrieves the caller's phone number ([ANI](https://en.wikipedia.org/wiki/Automatic_number_identification)),\nif available. If the phone number is retrieved, the component does a\nsoft-authentication using the phone number, validating it against registered\nphone numbers. The agent then greets the end-user with a personalized message\nbased on their account information.\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### Authenticated end-user\n\nEnd-user is identified based on the calling number and receives a personalized\ngreeting message.\n\n### Unidentified end-user\n\nEnd-user's calling number is not identified and end-user is greeted with the\nstandard greeting message.\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 webhook](/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### Get account details\n\nThe `prebuilt_components_greeting:get_account_details` webhook is used by the\ncomponent to identify the caller using their ANI. If the phone number of the\ncaller exists in the configured external service, then the relevant information\nto personalize the experience is retrieved, including caller name and email.\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 Account 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_greeting:get_account_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### Complete\n\nYour agent and its webhook should now be set up and ready to test."]]
