사전 빌드된 신용카드 명세서 구성요소는 고객의 인증 레벨을 확인한 후 지정된 인증된 고객에게 일정 기간 동안의 신용카드 명세서를 전송합니다. 고객에게 신용카드가 여러 개 있는 경우 이 구성요소는 고객이 신용카드 명세서를 검색하려는 특정 카드를 확인합니다. 이 구성요소는 사전 정의된 인증 구성요소의 커스텀 버전을 사용하여 카드 소지자를 인증하고 생년월일 수집의 커스텀 버전을 사용하여 명세서 기간의 시작일 및 종료일을 수집합니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 이 구성요소는 데이터를 암호화하지 않습니다.
샘플 대화상자
다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.
단일 신용카드
최종 사용자에게는 하나의 신용카드가 있습니다. 에이전트는 명세서 시작일과 종료일, 사용자가 명세서 암호화를 원하는지 여부를 수집하고 신용카드 명세서를 사용자에게 전송합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 카드 세부정보를 가져오는 동안 잠시 기다려 주세요. 번호에 연결된 1002로 끝나는 카드 번호를 찾았습니다. |
|
| 신용카드 명세서 시작일을 월, 일, 연도순으로 알려주세요. 신용카드 명세서는 최근 180일 동안에 대해서만 제공됩니다. | |
| 에이전트가 사전 빌드된 생년월일 구성요소를 사용하여 명세서 시작일을 수집합니다. | |
| 좋습니다. 신용카드 명세서 시작일이 확인되었습니다. 월, 일, 연도 순으로 신용카드 명세서 종료일을 알려주세요. 신용카드 명세서는 최근 180일 동안에 대해서만 제공됩니다. |
|
| 에이전트가 사전 빌드된 생년월일 구성요소를 사용하여 명세서 종료일을 수집합니다. | |
| 좋습니다. 신용카드 명세서 종료일이 확인되었습니다. 원하는 신용카드 명세서 기간이 2023년 6월 1일부터 2023년 6월 30일까지가 맞나요? |
|
| 예 | |
| 명세서 세부정보를 가져오는 동안 기다려 주세요. 2023년 6월 1일~2023년 6월 30일 사이의 거래를 찾았습니다. 이메일, SMS, WhatsApp 중 어디에서 정보를 수신하시겠어요? |
|
| 이메일로 전송 | |
| 정보를 전달하기 전에 문서를 암호화하길 원하시나요? | |
| 나중에 | |
| 등록된 이메일로 15분 내에 명세서가 전송됩니다. |
여러 신용카드
최종 사용자에게 여러 신용카드가 있는 경우 에이전트는 사용자가 신용카드 명세서를 요청하는 카드를 확인합니다. 에이전트는 명세서 시작일과 종료일, 사용자가 명세서 암호화를 원하는지 여부를 수집하고 신용카드 명세서를 사용자에게 전송합니다.
| 사용자 입력 | 에이전트 응답 |
|---|---|
| 에이전트가 사전 빌드된 인증 구성요소를 사용하여 사용자 인증을 수행합니다. | |
| 감사합니다. 인증이 성공적으로 완료되었습니다. | |
| 카드 세부정보를 가져오는 동안 잠시 기다려 주세요. 귀하의 번호에 연결된 계정이 2개 있는 것으로 확인되었습니다. 말씀하시는 카드의 마지막 네 자리 숫자를 알려주세요. |
|
| 1122 | |
| 카드 번호의 마지막 네 자리는 1122입니다. 맞나요? | |
| 예 | |
| 신용카드 명세서 시작일을 월, 일, 연도순으로 알려주세요. 신용카드 명세서는 최근 180일 동안에 대해서만 제공됩니다. | |
| 에이전트가 사전 빌드된 생년월일 구성요소를 사용하여 명세서 시작일을 수집합니다. | |
| 좋습니다. 신용카드 명세서 시작일이 확인되었습니다. 월, 일, 연도 순으로 신용카드 명세서 종료일을 알려주세요. 신용카드 명세서는 최근 180일 동안에 대해서만 제공됩니다. |
|
| 에이전트가 사전 빌드된 생년월일 구성요소를 사용하여 명세서 종료일을 수집합니다. | |
| 좋습니다. 신용카드 명세서 종료일이 확인되었습니다. 원하는 명세서 기간이 2023년 7월 13일부터 2023년 7월 14일까지가 맞나요? |
|
| 예 | |
| 명세서 세부정보를 가져오는 동안 기다려 주세요. 2023년 7월 13일~2023년 7월 14일 사이의 거래를 찾았습니다. 이메일, SMS, WhatsApp 중 어디에서 정보를 수신하시겠어요? |
|
| SMS | |
| 정보를 전달하기 전에 문서를 암호화하길 원하시나요? | |
| 예 | |
| 등록된 휴대전화로 비밀번호 세부정보가 전송됩니다. 등록된 휴대전화로 15분 내에 명세서가 전송됩니다. |
이름 지정 규칙
이 사전 빌드된 구성요소는 다음 이름 지정 규칙을 사용합니다.
| 기능 | 형식 | 예 |
|---|---|---|
| 정렬 | [구성요소 이름] | 신용카드 명세서 |
| 항목 유형 | prebuilt_components_[component_name]_[entity_type] | prebuilt_components_statement_channel_all |
| 웹훅 | prebuilt_components_[component_name]:[webhook_action] | prebuilt_components_credit_card_statement:request_statement |
입력 매개변수
입력 매개변수는 구성요소의 특정 동작을 구성하는 데 사용되는 매개변수입니다. 매개변수는 흐름 내 하나 이상의 조건에서 구성요소 작동 방식을 결정하는 데 사용됩니다. 흐름 범위 매개변수는 아래 설명된 대로 구성요소의 시작 페이지에서 설정해야 합니다. 세션 범위 매개변수는 호출 흐름 또는 이 구성요소의 시작 페이지에서 설정할 수 있습니다.
이 사전 빌드된 구성요소는 다음 입력 매개변수를 허용합니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.auth_level | (선택사항) 호출자의 인증 레벨을 나타냅니다. | 정수 |
| $session.params.auth_level_req | 사용자가 자신의 신용카드 명세서에 액세스하기 전에 필요한 인증 레벨을 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 1입니다. |
정수 |
| $session.params.account_auth_enabled | 인증 수준에 설명된 대로 사용자를 계좌 소유자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 false입니다. |
부울 |
| $session.params.card_auth_enabled | 인증 수준에 설명된 대로 사용자를 카드 소지자로 인증해야 하는지 여부를 나타냅니다. 이 값은 check auth level 페이지에서 페이지 진입 충족 요건의 매개변수 사전 설정에 구성되어 있습니다. 기본적으로 이 값은 true입니다. |
부울 |
| $session.params.phone_number | (선택사항) 인증에 사용된 고객의 등록된 전화번호입니다. | 문자열 |
| $session.params.credit_card_count | (선택사항) 인증된 사용자와 연결된 신용카드 개수입니다. | 정수 |
| $session.params.last_four_digit_of_card_number | (선택사항) 명세서를 제공해야 하는 고객 카드 번호의 마지막 네 자리 숫자입니다. 고객에게 카드가 하나만 있는 경우 이 정보는 인증 후 자동으로 검색됩니다. 고객에게 카드가 여러 개 있는 경우 고객에게서 특정 카드 번호가 수집됩니다. | 문자열 |
| $session.params.credit_card_statement_max_days | 명세서 시작일에 허용되는 현재 날짜까지의 최대 일수를 지정합니다. 기본적으로 이 값은 -180이며, 이는 명세서 시작일이 현재 날짜로부터 180일 이전까지로 제한된다는 것을 나타냅니다. 이 매개변수는 시작 페이지 true 경로에 구성됩니다. |
정수 |
| $flow.max_retry_count | 최종 사용자에게 유효한 명세서 종료일을 제공하도록 안내할 때 허용되는 재시도 횟수를 지정합니다. 기본값은 3입니다. |
정수 |
이 구성요소의 입력 매개변수를 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 빌드 탭을 선택합니다.
- 흐름 섹션에서 가져온 구성요소를 클릭합니다.
- 페이지 섹션에서 시작 페이지를 클릭합니다.
- 시작 페이지에서 true 경로를 클릭합니다.
- 경로 창에서 필요에 따라 매개변수 사전 설정 값을 수정합니다.
- 저장을 클릭합니다.
출력 매개변수
출력 매개변수는 구성요소를 종료한 후에도 활성 상태로 유지되는 세션 매개변수입니다. 이러한 매개변수에는 구성요소에 의해 수집된 중요한 정보가 포함됩니다. 이 사전 빌드된 구성요소는 다음 출력 매개변수의 값을 제공합니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| auth_level | 호출자의 인증 레벨을 나타냅니다. | 정수 |
| phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| credit_card_count | 등록된 전화번호와 연결된 신용카드 개수입니다. | 정수 |
| last_four_digit_of_card_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 기본 제공 이벤트를 참조하세요. |
문자열 |
기본 설정
이 사전 빌드된 구성요소를 설정하려면 다음 안내를 따르세요.
- 사전 빌드된 구성요소를 가져옵니다.
- Dialogflow 외부 서비스를 설명하는 구성으로 제공된 가변형 웹훅을 구성합니다. 아래 웹훅 설정을 참조하세요.
웹훅 설정
이 구성요소를 사용하려면 포함된 유연한 웹훅을 구성하여 외부 서비스에서 필요한 정보를 검색해야 합니다.
인증
인증에 필요한 외부 서비스를 이전에 구성하지 않았으면 이 구성요소에 대해 사용자 인증을 사용 설정하기 위해 이를 구성해야 합니다. 자세한 내용은 인증 웹훅 설정을 참조하세요.
신용카드 세부정보 확인하기
prebuilt_components_credit_card_statement:credit_card_details 웹훅은 구성요소가 등록된 전화번호의 신용카드 세부정보를 검색하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| credit_card_count | 등록된 전화번호와 연결된 신용카드 개수입니다. | 정수 |
| 신용카드 | 고객 신용카드의 마지막 네 자리 숫자 고객에게 카드가 여러 개 있는 경우 이 값은 null입니다. |
문자열 |
| 이메일 | 사용자의 등록된 이메일입니다. 전화번호에 등록된 이메일이 없는 경우 이 값은 null입니다. |
문자열 |
이 구성요소에 신용카드 세부정보 가져오기 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_credit_card_statement:credit_card_details 웹훅을 선택합니다.
- Dialogflow 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
카드 검증
prebuilt_components_credit_card_statement:validate_date 웹훅은 구성요소에서 등록된 전화번호에 지정된 신용카드가 있는지 확인하는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 제공한 신용카드 번호의 마지막 네 자리 숫자 | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| valid_card | 등록된 전화번호에 대해 지정된 카드가 발견되었는지 여부를 나타냅니다. | 부울 |
이 구성요소에 카드 검증 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_credit_card_statement:validate_card 웹훅을 선택합니다.
- Dialogflow 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
거래 내역 가져오기
prebuilt_components_credit_card_statement:card_transaction_details 웹훅은 구성요소가 사용자의 등록된 전화 번호, 카드 번호의 마지막 네 자리 숫자, 명세서 기간에 따라 카드의 거래 내역을 검색하기 위해 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 선택하고 신용카드 명세서 정보를 받기 위해 확인한 카드 번호의 마지막 네 자리 숫자 | 문자열 |
| $flow.statement_start_date | 'YYYY-MM-DD' 형식의 요청된 명세서 시작일입니다. | 문자열 |
| $flow.statement_end_date | (선택사항) 'YYYY-MM-DD' 형식의 요청된 명세서 시작일입니다. 사용자가 값을 제공하지 않았거나 호출자가 종료일 제공을 거부한 경우 값은 기본적으로 현재 날짜로 지정됩니다. | 문자열 |
API 응답 매개변수
다음 매개변수는 구성요소에서 사용할 API 응답에서 가져옵니다.
| 매개변수 이름 | 설명 | 출력 형식 |
|---|---|---|
| transactions_count | 지정된 신용카드의 주어진 명세서 기간 동안 발견된 거래 수입니다. | 정수 |
이 구성요소에 거래 내역 가져오기 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_credit_card_statement:card_transaction_details 웹훅을 선택합니다.
- Dialogflow 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
명세서 요청
prebuilt_components_credit_card_statement:request_statement 웹훅은 구성요소에서 사용자의 등록된 전화번호, 신용카드의 마지막 네 자리 숫자, 명세서 기간 에 따라 선택한 채널에 신용카드 명세서를 보내는 데 사용됩니다.
API 요청 매개변수
다음 매개변수는 구성요소에서 API 요청에 대한 입력으로 제공됩니다.
| 매개변수 이름 | 설명 | 입력 형식 |
|---|---|---|
| $session.params.phone_number | 사용자를 식별하는 데 사용되는 국가 코드가 포함되지 않은 사용자의 현지 전화번호입니다. | 문자열 |
| $session.params.last_four_digit_of_card_number | 사용자가 선택하고 신용카드 명세서 정보를 받기 위해 확인한 카드 번호의 마지막 네 자리 숫자 | 문자열 |
| $flow.statement_start_date | 'YYYY-MM-DD' 형식의 요청된 명세서 시작일입니다. | 문자열 |
| $flow.statement_end_date | (선택사항) 'YYYY-MM-DD' 형식의 요청된 명세서 시작일입니다. 사용자가 값을 제공하지 않았거나 호출자가 종료일 제공을 거부한 경우 값은 기본적으로 현재 날짜로 지정됩니다. | 문자열 |
| $flow.channel_medium | 사용자가 메시지를 수신하도록 선택한 채널입니다. 유효한 값은 사용자에게 등록된 이메일이 있는지 여부에 따라 prebuilt_components_statement_channel_phone 및 prebuilt_components_statement_channel_all 커스텀 항목으로 정의됩니다. 기본적으로 email, mobile, WhatsApp이 지원됩니다. |
문자열 |
| $flow.encryption_status | 지정된 채널로 전송하기 전 사용자가 문서 암호화를 원하는지 여부를 나타냅니다. 사용자가 값을 제공하지 않거나 호출자가 종료일 제공을 거부하면 값이 기본적으로 true로 지정됩니다. |
부울 |
이 구성요소에 명세서 요청 웹훅을 구성하려면 안내를 펼칩니다.
- Dialogflow CX 콘솔을 엽니다.
- Google Cloud 프로젝트를 선택합니다.
- 에이전트를 선택합니다.
- 관리 탭을 선택합니다.
- 웹훅을 클릭합니다.
- prebuilt_components_credit_card_statement:request_statement 웹훅을 선택합니다.
- Dialogflow 웹훅 URL 필드의 URL을 통합하려는 서비스의 엔드포인트로 바꿉니다. 드롭다운에서 적절한 메서드를 선택합니다.
- 요청 본문을 검토하고 업데이트하여 웹훅에 적합한 요청 형식을 작성합니다.
- 응답 구성을 검토하고 업데이트하여 웹훅의 응답에서 특정 필드를 추출합니다. 구성요소에서 반환된 필드 값에 액세스해야 하므로 매개변수 이름을 수정하지 마세요.
- 필요에 따라 인증 설정을 검토하고 업데이트합니다.
- 저장을 클릭합니다.
완료
이제 에이전트 및 웹훅이 설정되어 테스트할 수 있습니다.