Amazon SNS에서 발생하는 모바일 문자 메시지(SMS) 장애를 해결하려면 어떻게 해야 하나요?

해결 방법

CloudWatch Logs 활성화

SMS 메시지 로그를 활성화하려면 CloudWatch Logs 보기를 참조하십시오. 자세한 내용은 SMS 메시지에 대한 Amazon SNS 주제 전송 로그에 액세스하려면 어떻게 해야 하나요?를 참조하십시오.

전송 상태 로그 및 SMS 전송 실패 로그 검토

전송 상태 로그에서 "status": "FAILURE" 오류 메시지를 검토합니다. 전송 상태 로그에 실패 오류가 있는 경우 수신한 오류 메시지를 기반으로 문제를 해결하십시오. 자세한 내용은 SMS 전송 실패 이유를 참조하십시오.

"providerResponse": "No Quota left for account" 오류

SMS 전송 실패 로그에 이 오류 메시지가 보인다면 월간 SMS 사용 할당량을 초과한 것입니다.

참고: 또한 CloudWatch SMSMonthToDateSpentUSD 지표를 확인하여 월간 SMS 사용 할당량 초과 여부를 확인할 수도 있습니다.

월간 SMS 사용 할당량을 초과했다면 Amazon SNS에서 SMS 메시지 사용 한도 증가를 요청합니다.

중요: SMS 사용 할당량이 늘어났다는 확인을 받은 후에는 AWS 계정 사용 할당량을 조정해야 합니다. Amazon SNS 콘솔에서 SMS 설정을 업데이트하지 않으면 SMS 사용 한도가 증가하지 않습니다.

"providerResponse": "delivery would exceed maxprice" 오류

AWS SDK를 사용하여 SMS 메시지를 전송하는 경우 SMS 전송 실패 로그에서 "providerResponse": "delivery would exceed maxprice" 오류가 있는지 확인하십시오. SMS 전송 실패 로그에 이 오류가 보이면 AWS.SNS.SMS.MaxPrice 메시지 속성에 설정된 가격 제한을 초과한 것입니다.

참고: 또한 CloudWatch PublishSize 지표를 확인하여 메시지 크기 할당량을 초과했는지 확인할 수도 있습니다. Amazon SNS에서 메시지 전송 시 사용자가 설정한 최고 가격을 넘는 비용이 발생할 경우 메시지가 전송되지 않습니다.

최대 메시지 가격 한도를 초과했다면 AWS.SNS.SMS.MaxPrice 값을 높이거나, SMS 메시지의 크기를 줄입니다. 자세한 내용은 Amazon SNS를 사용하여 휴대폰에 SMS 메시지 게시를 참조하십시오.

"providerResponse": "Your account requires additional review prior to being able to send SMS messages" 오류

SMS 전송 실패 로그에 이 오류 메시지가 표시된다면 AWS에서 해당 계정의 SMS 메시지 전송을 승인하지 않은 것입니다.

참고: 남용을 방지하기 위해 AWS는 사용자가 SMS 메시지를 전송하기 전에 사용 할당량과 사용 사례를 승인해야 합니다.

AWS에서 계정의 SMS 메시지 전송을 승인하지 않은 경우 AWS Support Center에서 서비스 할당량 증가를 여십시오.

중요: 사례 유형에 계정 및 결제 또는 기술이 아닌 서비스 한도 증가를 선택해야 합니다.

해당 리전이 발신 자격 증명을 지원하는지 확인

메시지를 보내는 국가 또는 AWS 리전에서 지원하는 발신 자격 증명을 사용해야 합니다.

예를 들어, 미국 수신자 전화번호로 메시지를 보내려면 해당 리전에서 지원되는 미국 발신 번호(TFN/10DLC/ShortCode)가 있어야 합니다. 또는 캐나다 수신자 전화번호로 메시지를 보내려면 해당 리전에 지원되는 캐나다 발신 번호(LongCode/ShortCode)가 있어야 합니다.

자세한 내용은 AWS End User Messaging SMS를 사용한 SMS 메시징 지원 국가 및 리전을 참조하십시오.