사전 빌드된 전화번호 수집 구성요소

사전 빌드된 구성요소는 국가 코드와 전화번호를 캡처하고 검증합니다.

제한사항

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

  • 16자리를 초과하는 전화번호는 허용되지 않습니다.

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

추가 기능

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

샘플 대화상자

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

두 단계의 유효한 전화번호

최종 사용자가 먼저 국가 코드를 제공한 다음 전화번호를 제공합니다. 에이전트가 검증하고 수락합니다.

사용자 입력 에이전트 응답
국가 이름이나 코드는 무엇인가요?
+1
알겠습니다. 국가 코드는 +1입니다. 전화번호를 알려주세요.
6502530000
알겠습니다. 언급한 숫자가 +1 6502530000인가요?
예, 올바르게 입력했습니다.
좋습니다. 전화번호 수집이 완료되었습니다.

한 단계의 유효한 전화번호

최종 사용자가 국가 코드와 전화번호를 동시에 제공하면 에이전트가 이를 성공적으로 검증하고 수락합니다.

사용자 입력 에이전트 응답
국가 이름이나 코드는 무엇인가요?
+1 6502530000
알겠습니다. 언급한 숫자가 +1 6502530000인가요?
예, 올바르게 입력했습니다.
좋습니다. 전화번호 수집이 완료되었습니다.

전화번호가 잘못됨

최종 사용자가 한 번에 국가 코드와 전화번호를 제공합니다. 에이전트가 제공된 전화번호가 유효한 길이(16자리 이내)이지만 유효한 전화번호가 아닌 것을 확인합니다. 그러면 에이전트가 최종 사용자에게 전화번호를 제공하라는 메시지를 다시 표시합니다.

사용자 입력 에이전트 응답
국가 이름이나 코드는 무엇인가요?
+1 6502530001
죄송하지만 이 전화번호를 인식할 수 없습니다. 국가 코드를 +1로 수집했습니다. 올바른 전화번호를 입력하세요.
6502530000
알겠습니다. 언급한 숫자가 +1 6502530000인가요?
예, 올바르게 입력했습니다.
좋습니다. 전화번호 수집이 완료되었습니다.

잘못된 국가 코드와 전화번호

최종 사용자가 한 번에 국가 코드와 전화번호를 제공합니다. 에이전트가 제공된 국가 코드와 전화번호가 잘못된 것을 확인합니다. 그러면 에이전트는 최종 사용자에게 국가 코드와 전화번호를 입력하라는 메시지를 다시 표시합니다.

사용자 입력 에이전트 응답
국가 이름이나 코드는 무엇인가요?
+0080000000000
죄송합니다. 입력한 국가 코드 또는 전화번호가 잘못된 것 같습니다. 다시 시작하겠습니다. 국가 이름 또는 코드를 입력하세요.
1
알겠습니다. 국가 코드는 +1입니다. 전화번호가 어떻게 되나요?
6502530000
알겠습니다. 언급한 숫자가 +1 6502530000인가요?
예, 올바르게 입력했습니다.
좋습니다. 전화번호 수집이 완료되었습니다.

인식할 수 없는 입력

최종 사용자가 인식할 수 없는 입력을 세 번 제공하면 구성요소가 흐름을 종료합니다.

사용자 입력 에이전트 응답
국가 이름이나 코드는 무엇인가요?
좋습니다.
죄송합니다. 인식하지 못했습니다. 국가 코드를 다시 말하거나 입력해 주세요.
nice
아직도 이해하지 못했습니다. 국가 코드가 맞는지 확인해 주세요. 음성이 잘 인식되지 않는 경우 키패드를 사용하여 국가 코드를 입력할 수도 있습니다.
good
죄송하지만 응답을 이해하는 데 문제가 있습니다.

전화번호 검증

사전 빌드된 전화번호 구성요소는 IS_PHONE_NUMBER 시스템 함수를 사용하여 전화번호가 유효한 패턴과 일치하는지 확인합니다.

이름 지정 규칙

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

기능 형식
정렬 [구성요소 이름] 전화번호 수집
구성요소별 인텐트 prebuilt_components_[component_name]_[intent_name] prebuilt_components_telephone_number_collection_incorrect_country_code
매개변수 [param_name] telephone_number
항목 유형 prebuilt_components_[component_name]_[intent_name] prebuilt_components_telephone_no_country_code

출력 매개변수

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

매개변수 이름 설명 출력 형식
telephone_number_collection_telephone_number 이 매개변수는 구성요소에서 캡처한 전화번호를 반환합니다. 문자열
telephone_number_collection_country_code 이 매개변수는 구성요소에서 캡처한 국가 코드를 반환합니다. 문자열

기본 설정

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

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

완료

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