**지원 종료 공지:** 2026년 10월 30일에 Amazon Pinpoint에 대한 지원이 AWS 종료됩니다. 2026년 10월 30일 이후에는 Amazon Pinpoint 콘솔 또는 Amazon Pinpoint 리소스(엔드포인트, 세그먼트, 캠페인, 여정, 분석)에 더 이상 액세스할 수 없습니다. 자세한 내용은 [Amazon Pinpoint 지원 종료](https://docs.aws.amazon.com/console/pinpoint/migration-guide)를 참조하세요. **참고:** SMS, 음성, 모바일 푸시, OTP 및 전화번호 검증과 관련된 APIs는이 변경의 영향을 받지 않으며 AWS 최종 사용자 메시징에서 지원됩니다.
기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# Amazon Pinpoint 음성 채널
**참고**
Amazon Pinpoint는 사용 설명서 문서를 업데이트했습니다. AWS End User Messaging SMS 및 음성 리소스를 생성, 구성 및 관리하는 방법에 대한 최신 정보는 새로운 [https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html) 참조하세요.
다음 주제가 새로운 [https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html](https://docs.aws.amazon.com//sms-voice/latest/userguide/what-is-service.html)로 이동되었습니다.
[Amazon Pinpoint 음성 샌드박스](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice)
[지원되는 국가 및 리전(음성 채널)](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-voice-support-by-country.html)
[Amazon Pinpoint에서 풀 관리](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-pool.html)
[음성 채널 모범 사례](https://docs.aws.amazon.com//sms-voice/latest/userguide/best-practices.html#voice-best-practices)
음성 채널을 사용해 텍스트 스크립트에서 음성 메시지를 생성한 다음, 휴대폰을 통해 이러한 메시지를 고객에게 전송할 수 있습니다. 음성 채널은 SMS 메시지를 수신할 수 없는 전화번호를 가진 고객(예: 유선 또는 VoIP 서비스를 사용하는 고객)에게 연락할 수 있는 좋은 방법입니다.
Amazon Pinpoint를 사용하여 음성 메시지를 보내려면 먼저 프로젝트에서 음성 채널을 활성화하고 메시지를 보낼 전용 전화번호를 임대해야 합니다. Amazon Pinpoint를 사용하여 음성 메시지를 보내는 방법에 따라 계정의 특정 설정을 변경할 수도 있습니다. 예를 들어 보낼 수 있는 음성 메시지의 수를 늘리기 위해 프로덕션 액세스를 요청할 수 있습니다.
**Topics**
+ [Amazon Pinpoint 음성 채널 설정](channels-voice-setup.md)
+ [Amazon Pinpoint 음성 채널 관리](channels-voice-manage.md)
+ [음성 채널 문제 해결](channels-voice-troubleshooting.md)
# Amazon Pinpoint 음성 채널 설정
Amazon Pinpoint를 사용하여 음성 메시지를 보내려면 먼저 새 Amazon Pinpoint 프로젝트를 만듭니다. 그런 다음 해당 프로젝트의 음성 채널을 활성화하고 음성 메시지를 보낼 전용 전화 번호(*긴 코드*라고 함)를 요청합니다. *긴 코드*는 기반을 둔 국가 또는 리전에 따라 최대 15자리로 구성된 표준 전화 번호입니다. 이 전화번호는 *전용* 전화번호입니다. 즉, Amazon Pinpoint 계정에서만 사용하도록 예약되어 있습니다. 다양한 국가 또는 리전에 기반을 둔 현지 전화 번호를 임대할 수 있습니다.
**작은 정보**
기존 프로젝트에 대해 음성 채널을 활성화할 수도 있습니다. 이렇게 하려면 Amazon Pinpoint 콘솔의 **SMS 및 음성** 설정 페이지를 사용하세요. 자세한 내용은 [Amazon Pinpoint 음성 채널 관리](channels-voice-manage.md) 단원을 참조하십시오.
음성 채널에 대해 선택한 설정은 프로젝트의 SMS 채널에도 적용됩니다. 프로젝트에서 음성 메시지와 SMS 메시지를 모두 보내려면 두 채널의 목표를 지원하는 설정을 선택합니다. SMS 채널 활성화 및 사용에 대한 자세한 내용은 [Amazon Pinpoint SMS 채널](channels-sms.md) 단원을 참조하십시오.
**새 프로젝트의 음성 채널을 설정하려면**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. **모든 프로젝트** 페이지에서 **프로젝트 생성**을 선택합니다.
1. **프로젝트 이름**에 이름을 입력한 다음 **생성**을 선택합니다.
**참고**
프로젝트 이름에는 최대 64개의 영숫자가 포함될 수 있습니다. 이 이름에는 쉼표(,) 마침표(.), 단가 기호(@), 밑줄(\$1), 등호(=) 및 더하기 기호(\$1)와 같은 문자도 포함할 수 있습니다.
1. **프로젝트 기능**의 **SMS 및 음성** 섹션에서 **구성**을 선택합니다.
1. **이 프로젝트에 대해 SMS 채널 활성화**를 선택합니다.
1. **고급 구성** 섹션을 확장한 후 **전화번호 요청**을 선택합니다.
1. **전화번호 정의** 페이지의 **국가**에서 수신자가 위치한 국가를 선택합니다. 한 번에 한 국가만 선택할 수 있지만 필요한 경우 나중에 더 추가할 수 있습니다.
1. 전화번호의 사용 사례를 지정합니다. 다음 옵션 중 하나를 선택할 수 있습니다.
+ **프로모션** - 마케팅 메시지 또는 비즈니스나 서비스를 홍보하는 메시지를 보내려면 이 옵션을 선택합니다.
+ **트랜잭션** - 암호 재설정이나 트랜잭션 알림과 같이 시간에 민감한 메시지를 보내려면 이 옵션을 선택합니다.
일부 국가와 리전에서는 선택하는 값에 따라 전송하는 각 메시지에 대해 지불하는 요금이 결정될 수 있습니다. 트랜잭션 메시지는 높은 전달 가능성에 최적화되어 있기 때문에 많은 국가에서 비용이 더 많이 듭니다. 프로모션 메시지는 비용 효율성에 최적화되어 있습니다. SMS 요금에 대한 자세한 내용은 [Amazon Pinpoint 요금](https://aws.amazon.com/pinpoint/pricing/)을 참조하세요.
1. **요약** 섹션에는 번호에 대한 정보가 표시됩니다. **월별 요금**은 단일 번호에 대한 비용을 보여 줍니다.
1. **수량**에서 구매하려는 번호의 수량을 선택합니다. 단일 요청으로 최대 10개의 번호를 구매할 수 있습니다. 나중에 번호를 추가로 구입할 수 있습니다. **소계**가 업데이트되어 구매하는 전화번호 수량의 월별 총 요금이 표시됩니다.
1. (선택 사항) 전화번호를 추가로 구매하려면 **국가 또는 리전 추가**를 선택하고, 긴 코드가 필요한 모든 국가에 대한 요청을 정의할 때까지 이전 단계를 반복합니다.
1. 전화번호 구매를 완료하면 **다음**을 선택합니다.
1. **검토 및 요청** 페이지에는 각 대상 국가의 번호 요청 세부 정보가 표시됩니다.
1. **총 비용**에는 선택한 모든 국가의 모든 번호에 대한 총 비용이 표시됩니다.
1. 준비가 되면 **요청**을 선택합니다. 그렇지 않으면 **이전**을 선택하여 뒤로 돌아가 변경할 수 있습니다. **요청**을 선택한 후에는 더 이상 변경할 수 없습니다.
# Amazon Pinpoint 음성 채널 관리
Amazon Pinpoint 콘솔을 사용하여 프로젝트의 음성 채널을 활성화하고 Amazon Pinpoint 계정의 음성 채널에 적용되는 설정을 관리할 수 있습니다. 예를 들어 계정에 대한 프로덕션 액세스 권한을 요청하거나 음성 메시지 전송을 위한 전용 전화 번호를 요청할 수 있습니다.
## 음성 채널 활성화
Amazon Pinpoint를 사용하여 음성 메시지를 보내려면 먼저 하나 이상의 프로젝트에 대해 음성 채널을 활성화해야 합니다. 새 프로젝트를 만들고 음성 채널을 활성화하는 방법은 [Amazon Pinpoint 음성 채널 설정](channels-voice-setup.md) 단원을 참조하십시오. 기존 프로젝트에 대해 음성 채널을 활성화하려면 다음 단계를 완료하십시오.
음성 채널에 대해 선택한 설정은 프로젝트의 SMS 채널에도 적용됩니다. 프로젝트에서 음성 메시지와 SMS 메시지를 모두 보내려면 두 채널의 목표를 지원하는 설정을 선택합니다. 자세한 내용은 [Amazon Pinpoint SMS 채널](channels-sms.md)를 참조하세요.
**기존 프로젝트에 대해 음성 채널을 활성화하려면**
1. [https://console.aws.amazon.com/pinpoint/](https://console.aws.amazon.com/pinpoint/)에서 Amazon Pinpoint 콘솔을 엽니다.
1. **모든 프로젝트** 페이지에서 음성 채널을 활성화할 프로젝트를 선택합니다.
1. 탐색 창의 **설정**에서 **SMS 및 음성**을 선택합니다.
1. **SMS 및 음성** 페이지의 **SMS 설정** 옆에 있는 **편집**을 선택합니다.
1. **이 프로젝트에 대해 이메일 채널 활성화**를 선택합니다.
1. **변경 내용 저장**을 선택합니다.
1. **SMS 및 음성** 페이지의 **번호 설정**에서 표를 참조하여 계정에 이미 연결된 전화 번호를 사용하여 음성 메시지를 보낼 수 있는지 여부를 확인합니다. 있는 경우 **음성** 열에 음성 메시지를 보내는 데 사용할 수 있는 각 전화 번호 옆에 **활성화됨**이 표시됩니다. 없는 경우 *AWS End User Messaging SMS 사용 설명서*의 [전화번호 요청](https://docs.aws.amazon.com//sms-voice/latest/userguide/phone-numbers-request.html)을 참조하세요.
# 음성 채널 문제 해결
Amazon Pinpoint 음성 메시지 로깅에 대해서는 [Amazon Pinpoint SMS 및 Voice v1 API의 Amazon Pinpoint 음성 메시지에 대한 로깅을 설정하려면 어떻게 해야 합니까?](https://repost.aws/knowledge-center/pinpoint-voice-message-logging-setup)를 참조하세요.
## Voice
****문제 및 해결 방법****
+ 기본적으로 Amazon Pinpoint 프로젝트의 음성 채널은 꺼져 있습니다. 프로젝트에 음성이 켜져 있는지 확인하려면 프로젝트 아래의 **설정** 페이지를 선택합니다. SMS 및 음성의 **기능**에서 두 기능이 각각 꺼져 있는지, 켜져 있는지 확인할 수 있습니다. **관리** 옵션에서 SMS를 켤 수 있지만 다음 명령을 실행하여 음성 채널을 켤 수 있습니다.
```
aws pinpoint update-voice-channel --application-id AppId --voice-channel-request Enabled=true
```
+ TooManyRequests 예외
+ 계정이 샌드박스에 있는 경우 24시간 동안 메시지 20개 제한이 있습니다. 이 제한은 *AWS End User Messaging SMS 사용 설명서*의 [음성 샌드박스](https://docs.aws.amazon.com//sms-voice/latest/userguide/sandbox.html#sandbox-voice)에서 늘릴 수 있습니다.
+ Amazon Pinpoint 음성 채널은 24시간 동안 단일 수신자당 메시지 5개의 하드 제한이 있습니다. 이 값은 하드 제한이며 늘릴 수 없습니다.