사전 빌드된 인사말 구성요소는 발신자의 전화번호(ANI)를 검색합니다(사용 가능한 경우). 전화번호가 검색되면 구성요소는 전화번호를 사용하여 소프트 인증을 수행하여 등록된 전화번호와 대조하여 확인합니다. 그런 다음 에이전트가 계정 정보를 기반으로 최종 사용자에게 인사합니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 고객 전화번호가 CRM(고객 관계 관리) 시스템 또는 다른 서비스에서 유지된다고 가정합니다.
- 보조 전화번호를 사용하는 기존 고객은 이 구성요소에서 인증되지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
인증된 최종 사용자
최종 사용자는 전화번호를 기준으로 식별되며 맞춤설정된 인사말 메시지를 수신합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| [발신자 이름] 님께 [회사 이름]에 문의해 주셔서 감사합니다. 당사는 귀하의 금융 건강을 위해 최선을 다하고 있습니다. 무엇을 도와드릴까요? |
확인되지 않은 최종 사용자
최종 사용자의 전화번호가 식별되지 않으며 최종 사용자에게 표준 인사말이 표시됩니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| [회사 이름]에 문의해 주셔서 감사합니다. 당사는 귀하의 금융 건강을 위해 최선을 다하고 있습니다. 무엇을 도와드릴까요? |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 인사말 |
| 매개변수 | [param_name] | ani_auth |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_greeting:get_account_details |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $flow.company_name | 인사말 프롬프트에서 동적으로 사용될 회사 이름을 캡처합니다. | 문자열 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| ani_auth | 이 파라미터는 ANI 기반 인증 결과를 캡처합니다. 기본값은 false입니다. | 부울 |
| auth_level | 호출자의 인증 레벨을 나타냅니다. 기본값은 null입니다. -1은 사용자가 ANI로 인증되지 않았음을 나타냅니다. 0은 ANI 인증에 성공했음을 나타냅니다. | 정수 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
계정 세부정보 가져오기
prebuilt_components_greeting:get_account_details 웹훅은 구성요소에서 ANI를 사용하여 발신자를 식별하는 데 사용됩니다. 구성된 외부 서비스에 발신자 전화번호가 있는 경우 발신자 이름과 이메일을 포함하여 환경을 맞춤설정하는 데 필요한 관련 정보가 검색됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| phone_number | 발신자의 전화번호(ANI) | 정수 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| user_first_name | 맞춤형 인사말을 제공하는 데 사용되는 최종 사용자의 이름입니다. | 문자열 |
이 구성요소에 대해 계정 세부정보 웹훅 가져오기 구성을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_greeting:get_account_details 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
에이전트와 웹훅이 설정되었습니다. 이제 테스트를 진행할 수 있습니다.