사전 빌드된 신용카드 만료일 수집 구성요소

사전 빌드된 구성요소는 최종 사용자로부터 신용카드 만료일을 캡처합니다.

제한사항

사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.

  • Payment Gateway 통합은 이 구성요소에 포함되지 않습니다.

사용자가 전화 키패드를 사용하여 숫자 값을 입력할 수 있도록 DTMF를 사용 설정합니다.

추가 기능

이 사전 빌드된 구성요소에는 다음과 같은 추가 기능이 제공됩니다.

샘플 대화상자

다음 샘플 대화상자에서는 사전 빌드된 구성요소에서 처리하는 일반적인 시나리오를 보여줍니다. 샘플 대화상자는 전화를 통해 구성요소가 호출될 때 기본 시작 인텐트와 대화 시작 시 첫 번째 에이전트 응답을 트리거하는 동작을 보여줍니다.

입력 완료

최종 사용자가 첫 번째 시도에서 만료일을 제공하고 에이전트에서 이를 수락합니다.

사용자 입력 에이전트 응답
신용카드 만료일(월, 연도순)을 말하거나 입력해 주세요.
01/27
신용카드 만료일이 2027년 1월입니다. 맞나요?
좋습니다. 신용카드 만료일 수집이 완료되었습니다.

재시도

최종 사용자가 첫 번째 시도에서 만료일을 제공합니다. 에이전트에서 수집된 만료일을 다시 확인하자 최종 사용자가 '잘못되었습니다'라고 말합니다. 에이전트가 최종 사용자에게 만료일의 잘못된 부분(전체 날짜, 월 또는 연도)을 확인해 달라고 요청하고 해당 세부정보를 다시 제공해 달라는 메시지를 다시 표시합니다.

사용자 입력 에이전트 응답
신용카드 만료일(월, 연도순)을 말하거나 입력해 주세요.
01/27
신용카드 만료일이 2027년 1월입니다. 맞나요?
잘못됨
죄송하지만 이해하지 못했습니다. 전체 날짜를 변경하시겠어요, 아니면 대신 월이나 연도를 변경하시겠어요?
죄송합니다. 신용카드의 만료 월을 말하거나 입력하세요.
2월
신용카드의 만료 월이 2월입니다. 맞나요?
신용카드 만료일이 2027년 2월입니다. 맞나요?
좋습니다. 신용카드 만료일 수집이 완료되었습니다.

부분 입력

시나리오 - 최종 사용자가 첫 번째 시도에서 만료일을 제공할 수 없습니다. 에이전트는 만료일을 분할하여 월을 요청한 다음에 연도를 요청합니다. 이번에는 최종 사용자가 올바르게 입력하고 에이전트에서 이를 수락합니다.

사용자 입력 에이전트 응답
신용카드 만료일(월, 연도순)을 말하거나 입력해 주세요.
13
죄송합니다. 만료일이 올바르지 않은 것 같습니다. 월을 다시 캡처해 보세요.

신용카드의 만료 월을 말하거나 입력합니다.
1
신용카드의 만료 월이 1월입니다. 맞나요?
예, 맞습니다.
신용카드의 만료 연도를 말하거나 입력하세요.
26
신용카드의 만료 연도가 2026년입니다. 맞나요?
신용카드 만료일이 2026년 1월입니다. 맞나요?
좋습니다. 신용카드 만료일 수집이 완료되었습니다.

인식할 수 없는 입력

최종 사용자가 인식되지 않는 입력을 세 번 제공하면 구성요소에서 흐름을 종료합니다.

사용자 입력 에이전트 응답
신용카드 만료일(월, 연도순)을 말하거나 입력해 주세요.
괜찮아요
죄송합니다. 인식하지 못했습니다. 신용카드 만료일을 다시 말하거나 입력해 주세요.
좋아요
아직도 이해하지 못했습니다. 신용카드의 만료일을 말하고 있는지 확인하세요. 키패드를 사용하여 신용카드 만료일을 입력할 수도 있습니다.
좋음
죄송합니다. 고객님의 답변을 이해하기 어렵습니다.

신용카드 만료일 검증

신용카드 만료일은 '01'과 '12' 사이의 정수 또는 '1월'과 '12월' 사이의 월을 나타내는 문자열을 입력해야 합니다.

신용카드 만료일 연도는 4자리여야 합니다. 입력이 2자리 숫자이면 4자리 연도로 변환됩니다(예:'25'가 '2025'가 됩니다). 또한 연도는 현재로부터 10년 이내여야 합니다.

월과 연도를 포함하는 신용카드 만료일은 현재 월과 연도를 고려하여 미래 날짜여야 합니다.

이름 지정 규칙

이 사전 빌드 구성요소는 다음 이름 지정 규칙을 사용합니다.

기능 형식
흐름 [구성요소 이름] 신용카드 만료일 수집
구성요소별 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_credit_card_expiration_date_collection_collect_date
항목 유형 prebuilt_components_[component_name]_[entity_type_name] prebuilt_components_credit_card_expiration_date_collection_month
매개변수 [param_name] expiration_date

출력 매개변수

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

매개변수 이름 설명 출력 형식
credit_card_expiration_date_collection_credit_card_expiration_date 이 매개변수는 대화 흐름 세션 중에 캡처되는 만료 요소 유형 객체를 반환합니다.
{
"year": integer,
"month": integer
}

기본 설정

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

  1. 사전 빌드된 구성요소를 가져옵니다.

완료

이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.