이 사전 빌드된 구성요소는 국가 코드와 전화번호를 캡처하고 검증합니다.
제한사항
사전 빌드된 구성요소에는 일반적인 사전 빌드된 구성요소 제한사항 외에도 다음과 같은 제한사항이 있습니다.
- 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 | 이 매개변수는 구성요소에서 캡처한 국가 코드를 반환합니다. | 문자열 |
기본 설정
이 사전 빌드된 구성요소를 설정하려면 다음 안내를 따르세요.
완료
이제 에이전트가 설정되었고 테스트할 준비가 되었습니다.