사전 빌드된 계좌 개설 구성요소

사전 빌드된 계좌 개설 구성요소를 사용하면 신규 및 기존 사용자가 새 계좌를 개설하거나 기존 애플리케이션의 상태를 확인할 수 있습니다. 이 구성요소는 사전 빌드된 생년월일 수집, 이름 수집, 전화번호 수집 구성요소를 사용하여 사용자 정보를 수집하고 새 계좌를 개설합니다.

계좌 유형

기본적으로 이 구성요소는 다음 계좌 유형을 지원합니다.

  • 저축 예금
  • 당좌 계좌(현재 계좌라고도 함)
  • 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입니다. 정수

이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 빌드 탭을 선택합니다.
  5. 흐름 섹션에서 가져온 구성요소를 클릭합니다.
  6. 페이지 섹션에서 시작 페이지를 클릭합니다.
  7. 시작 페이지에서 true 경로를 클릭합니다.
  8. 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
  9. 저장을 클릭합니다.

출력 매개변수

출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드 구성요소는 다음 출력 매개변수의 값을 제공합니다.

매개변수 이름 설명 출력 형식
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 기본 제공 이벤트를 참조하세요.
문자열

기본 설정

이 사전 빌드 구성요소를 설정하려면 다음 안내를 따르세요.

  1. 사전 빌드된 구성요소를 가져옵니다.
  2. 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.

웹훅 설정

이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.

전화 인증

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_typeapplication_status에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. 목록(문자열)
account_type 지정된 전화번호와 연결된 각 애플리케이션의 계좌 유형을 포함하는 목록입니다(예: ["savings", "checking", "demat"]). 이 목록의 각 요소는 application_idapplication_status에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. 목록(문자열)
application_status 지정된 전화번호와 연결된 각 애플리케이션의 상태를 포함하는 목록입니다(예: ["in progress", "on hold", "completed"]). 이 목록의 각 요소는 application_idaccount_type에서 색인이 동일한 요소와 같은 애플리케이션을 나타냅니다. 지정된 전화번호와 연결된 애플리케이션이 없으면 이 값은 null입니다. 목록(문자열)

이 구성요소에 전화 통신 확인 웹훅을 구성하려면 안내를 펼칩니다.

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 관리 탭을 선택합니다.
  5. 웹훅을 클릭합니다.
  6. prebuilt_components_open_account:telephone_verification 웹훅을 선택합니다.
  7. 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
  8. 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
  9. 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
  10. 필요에 따라 인증 설정을 검토하고 업데이트합니다.
  11. 저장을 클릭합니다.

애플리케이션 생성

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입니다. 문자열

이 구성요소에 애플리케이션 생성 웹훅을 구성하려면 안내를 펼칩니다.

  1. Dialogflow CX 콘솔을 엽니다.
  2. Google Cloud 프로젝트를 선택합니다.
  3. 에이전트를 선택합니다.
  4. 관리 탭을 선택합니다.
  5. 웹훅을 클릭합니다.
  6. prebuilt_components_open_account:generate_application 웹훅을 선택합니다.
  7. 대화형 에이전트(Dialogflow CX) 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
  8. 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
  9. 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
  10. 필요에 따라 인증 설정을 검토하고 업데이트합니다.
  11. 저장을 클릭합니다.

완료

이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.