사전 빌드된 계좌 개설 구성요소를 사용하면 신규 및 기존 사용자가 새 계좌를 개설하거나 기존 애플리케이션의 상태를 확인할 수 있습니다. 이 구성요소는 사전 빌드된 생년월일 수집, 이름 수집, 전화번호 수집 구성요소를 사용하여 사용자 정보를 수집하고 새 계좌를 개설합니다.
계정 유형
기본적으로 이 구성요소는 다음 계좌 유형을 지원합니다.
- 저축 예금
- 당좌 계좌(현재 계좌라고도 함)
- Demat 계좌
- 월급 계좌
지원되는 계좌 유형은 prebuilt_components_open_account_account_type 커스텀 항목을 수정하여 추가하거나 삭제할 수 있습니다.
제한사항
사전 빌드 구성요소에는 일반적인 사전 빌드 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
새 사용자
에이전트는 사용자의 전화번호를 수집하고 사용자가 계좌에 등록되어 있지 않음을 확인합니다. 그런 다음 에이전트가 사용자의 성명 및 생년월일을 비롯한 세부정보를 수집하고 사용자가 제공한 전화번호로 전송되는 애플리케이션을 생성합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 검증 목적으로 사용할 전화번호를 제공해 주세요. | |
| 에이전트가 사전 빌드된 전화번호 수집 구성요소를 사용하여 사용자 전화번호 수집합니다. | |
| 좋습니다. 전화 번호 수집이 완료되었습니다. 계좌 개설을 원하신다고 문의해 주셔서 감사합니다. |
|
| 에이전트가 사전 빌드된 이름 수집 구성요소를 사용하여 사용자의 전체 이름 수집 | |
| John Doe 님, 감사합니다. | |
| 에이전트가 사전 빌드된 생년월일 수집 구성요소를 사용하여 사용자 전화번호 수집 | |
| 좋습니다. Google에서 생년월일을 수집했습니다. 어떤 유형의 계좌를 개설하려고 하시나요? 저축 예금, 당좌 예금, 급여 또는 디맷(demat)을 말하면 됩니다. |
|
| 당좌 계좌 | |
| 새 당좌 계좌를 개설하고 싶으신지 확인하겠습니다. 맞으신가요? | |
| 예 | |
| 정보를 제공해 주셔서 감사합니다. 애플리케이션을 생성하는 동안 기다려 주세요. 애플리케이션 ID는 81037입니다. 등록된 휴대전화 번호에 제공된 링크를 클릭하여 신청을 완료하세요. |
기존 사용자
에이전트는 사용자가 이전에 인증되었음을 식별하고 사용자가 열려는 계좌 유형을 확인합니다. 에이전트는 사용자에게 애플리케이션을 만들고 사용자의 등록된 전화번호로 안내를 보냅니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 새 계좌 개설 문의를 주셔서 감사합니다. 어떤 유형의 계좌를 개설하려고 하시나요? 저축 예금, 당좌 예금, 급여 또는 디맷(demat)을 말하면 됩니다. |
|
| 저축 예금 계좌입니다. | |
| 새 저축 예금 계좌를 개설하고 싶으신지 확인하겠습니다. 맞으신가요? | |
| 예, 맞습니다. | |
| 정보를 제공해 주셔서 감사합니다. 애플리케이션을 생성하는 동안 기다려 주세요. 애플리케이션 ID는 21430입니다. 등록된 휴대전화 번호에 제공된 링크를 클릭하여 신청을 완료하세요. |
기존 애플리케이션
에이전트는 사용자가 이전에 단일 애플리케이션을 열었음을 식별하고 사용자에게 현재 상태를 표시합니다. 사용자가 새 계좌를 위해 다른 애플리케이션을 열지 않습니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 검증 목적으로 사용할 전화번호를 제공해 주세요. | |
| 에이전트가 사전 빌드된 전화번호 수집 구성요소를 사용하여 사용자 전화번호 수집합니다. | |
| 좋습니다. 전화번호 수집이 완료되었습니다. 저축계좌 개설을 위한 ID 12234의 신청을 처리하는 중입니다. 다른 계좌를 개설하시겠어요? |
|
| 아니요 | |
| 알겠습니다. 연락해 주셔서 감사합니다. |
이름 지정 규칙
이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 흐름 | [구성요소 이름] | 계좌 개설 |
| 구성요소별 인텐트 | prebuilt_components_[component_name]_[intent_name] | prebuilt_components_open_account_account_type |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_open_account_account_type |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_open_account:generate_application |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.auth_level | (선택사항) 호출자의 인증 레벨을 나타냅니다. | 정수 |
| $session.params.phone_number | (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. | 문자열 |
| $session.params.min_age_limit | 새 계좌를 개설하는 사용자에게 허용되는 최소 연령을 지정합니다. 기본값은 18입니다. |
정수 |
| $session.params.max_age_limit | 새 계좌를 개설하는 사용자에게 허용되는 최대 연령을 지정합니다. 기본값은 100입니다. |
정수 |
| $flow.max_dob_retry_count | 유효한 생년월일을 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_account_type | 사용자가 열려는 계좌 유형을 수집할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
| $flow.max_retry_another_account | 사용자가 선택한 계좌 유형을 변경하려고 할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 2입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| transfer_reason | 이 매개변수는 성공하지 않은 경우 흐름이 종료된 이유를 나타냅니다. 반환된 값은 다음 중 하나입니다.agent: 최종 사용자가 대화 중 특정 시점에서 에이전트를 요청했습니다.denial_of_information: 최종 사용자가 구성 요소에서 요청한 정보 공유를 거부했습니다.max_no_input: 대화가 입력되지 않은 이벤트에 대한 최대 재시도 횟수에 도달했습니다. no-input 기본 제공 이벤트를 참조하세요.max_no_match: 대화가 일치하지 않는 이벤트의 최대 재시도 횟수에 도달했습니다. no-match 기본 제공 이벤트를 참조하세요.webhook_error: 웹훅 오류가 발생했습니다. webhook.error 기본 제공 이벤트를 참조하세요. webhook_not_found: 웹훅 URL에 연결할 수 없습니다. webhook.error.not-found 기본 제공 이벤트를 참조하세요. |
문자열 |
기본 설정
이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
전화 인증
prebuilt_components_open_account:telephone_verification 웹훅은 구성요소에서 사용자의 전화번호와 연결된 등록된 계좌 및 이전 애플리케이션에 대한 정보를 가져오는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| account_count | 등록된 전화번호와 연결된 계좌의 개수입니다. 이러한 계좌에는 자체 계좌 및 사용자에게 위임장이 있는 계좌가 포함됩니다. 지정된 전화번호와 연결된 계좌가 없으면 이 값은 null입니다. |
정수 |
| user_first_name | 등록된 사용자의 이름입니다. 전화번호가 등록된 계좌와 연결되어 있지 않으면 이 값은 null입니다. |
문자열 |
| user_last_name | 등록된 사용자의 성입니다. 전화번호가 등록된 계좌와 연결되어 있지 않으면 이 값은 null입니다. |
문자열 |
| user_dob | 'YYYY-MM-DD' 형식의 등록된 사용자의 생년월일입니다. 전화번호가 등록된 계좌와 연결되어 있지 않으면 이 값은 null입니다. |
문자열 |
| application_count | 등록된 전화번호와 연결된 애플리케이션의 개수입니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. |
정수 |
| application_id | 지정된 전화번호와 연결된 각 애플리케이션의 애플리케이션 ID를 포함하는 목록입니다(예: ["00000", "11111", "22222"]). 이 목록의 각 요소는 account_type 및 application_status에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. |
목록(문자열) |
| account_type | 지정된 전화번호와 연결된 각 애플리케이션의 계좌 유형을 포함하는 목록입니다(예: ["savings", "checking", "demat"]). 이 목록의 각 요소는 application_id 및 application_status에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. |
목록(문자열) |
| application_status | 지정된 전화번호와 연결된 각 애플리케이션의 상태를 포함하는 목록입니다(예: ["in progress", "on hold", "completed"]). 이 목록의 각 요소는 application_id 및 account_type에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. |
목록(문자열) |
이 구성요소에 전화 통신 확인 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_open_account:telephone_verification 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
애플리케이션 생성
prebuilt_components_open_account:generate_application 웹훅은 구성요소에서 새 계좌 신청을 생성하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| user_first_name | 사용자의 이름 | 문자열 |
| user_last_name | 사용자의 성입니다. | 문자열 |
| user_dob | 'YYYY-MM-DD' 형식의 사용자 생년월일입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| application_id | 새 계좌 신청에 대해 생성된 애플리케이션 ID입니다. | 문자열 |
이 구성요소에 애플리케이션 생성 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_open_account:generate_application 웹훅을 선택합니다.
- 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.