Amazon SNS의 “Unknown error attempting to reach phone” 오류 또는 SMS 전송 시 Pinpoint의 “UNKNOWN” 오류를 해결하려면 어떻게 해야 하나요?

3분 분량

모바일 문자 메시지(SMS 메시지)가 Amazon Simple Notification Service(SNS) 또는 Amazon Pinpoint를 통해 전송되지 않습니다. 그런 다음 Amazon SNS 또는 Amazon Pinpoint의 SMS에서 “Unknown error attempting to reach phone”라는 오류 메시지가 나타납니다.

간단한 설명

SMS 메시지는 타사 다운스트림 애그리게이터, SMS 공급업체 및 이동 통신사를 통해 모바일 장치로 전달됩니다. 즉, Amazon SNS, Amazon Pinpoint 또는 Amazon SNS 또는 Amazon Pinpoint와 통합되는 AWS 서비스와 함께 SMS를 사용하는 경우입니다. 이러한 다운스트림 파트너가 모바일 장치에 연결할 수 없는 경우 "Unknown error attempting to reach phone" 오류가 표시됩니다.
중요: SMS 아키텍처는 설계상 분산되어 있습니다. 애플리케이션에 대한 SMS 메시지 전송의 안정성 및 성능에 대해 가정하지 않는 것이 가장 좋습니다. 자세한 내용은 인터넷 엔지니어링 태스크 포스(IETF)의 RFC 5724를 참조하세요.

해결 방법

사용 사례에 대한 다음 문제 해결 단계를 따르세요.

일반적인 문제 확인

Amazon SNS 또는 Amazon Pinpoint와 관련이 없는 일반적인 문제를 배제합니다.
다음과 같은 이유로 오류가 발생할 수 있습니다.

전화번호가 이동 통신사에 의해 스팸으로 차단되었습니다.
수신자가 차단되었습니다.
메시지 본문이 유효하지 않습니다.
전화번호가 방해 금지(DND) 목록에 있습니다.
휴대폰이 로밍 네트워크에 있습니다.
이동 통신사에서 메시지를 차단하고 있습니다.
휴대폰에서 SMS를 차단하고 있습니다.
휴대폰이 일시적으로 서비스 지역을 벗어났습니다.
휴대폰이 꺼져 있습니다.
휴대폰이 아닌 유선 전화번호입니다.
메시지 본문에 등록되지 않은 URL이 있습니다.
휴대폰 번호가 유효하지 않습니다.
다운스트림 파트너의 네트워크 구성이 특정 번호 또는 지역 번호 집합에 대해 올바르지 않습니다.

SMS 모범 사례 검토

SMS 메시지를 보내는 대상 국가 또는 AWS 리전에 대한 SMS 모범 사례, 규칙 및 규정을 따르고 있는지 확인하세요.
올바른 발신 ID를 사용하고 있는지 확인합니다. 필요한 경우 ID를 등록해야 합니다. 자세한 내용은 지원되는 국가 및 지역(SMS 채널)을 참조하세요.
미국으로 SMS 메시지를 보내는 경우 미국에서 지원되는 발신 번호를 사용하고 있는지 확인하세요.
미국에 수신자 부담 전화번호를 사용하는 경우 전화번호가 등록된 번호인지 확인하세요.
현지 경로를 사용하여 인도에 SMS 메시지를 보내는 경우 먼저 전용 알파벳 발신자 ID를 사전 등록하세요. 그런 다음 DLT 등록 템플릿을 사용합니다. SMS 메시지에 콘텐츠를 추가할 때는 DLT 등록 템플릿의 콘텐츠와 정확히 일치하는지 확인하세요. 자세한 내용은 인도의 발신자 ID 등록 요구 사항을 참조하세요.

단일 장치 배달 문제 해결

장치 수준 SMS 차단, 로밍, 커버리지 격차 및 기타 요인으로 인해 단일 장치 배달 문제가 발생할 수 있습니다.
이러한 문제를 해결하려면 다음과 같이 하세요.

Amazon Pinpoint API를 사용하여 전화번호의 유효성을 검사합니다. 유선 및 VoIP 전화번호를 사용하면 배달 문제가 발생할 수 있습니다.
다른 장치에서 SMS 메시지를 보낸 다음 메시지가 배달되었는지 확인합니다.

이 두 단계가 모두 성공하면 다른 장치에서 테스트하는 것을 고려하세요.
문제가 지속되면 장치 소유자는 이동 통신사에 지원을 요청해야 합니다.

여러 장치 배달 문제 해결

SMS 전송 지연이 여러 장치에 영향을 미치는 경우 다운스트림 애그리게이터, 공급업체, 공급자 및 이동 통신사에 문제가 있을 수 있습니다.

잠재적인 다운스트림 문제를 해결하려면 SMS 메시지를 보내는 데 사용 중인 서비스에 대한 지원 케이스를 만드세요.
지원 케이스에 다음 정보를 제공하세요.

SMS 메시지를 보내는 데 사용하는 리전입니다.
문제가 시작된 시점의 타임스탬프.
3일 이내에 다른 전화번호로 발송된 실패한 SMS 메시지의 메시지 ID가 포함된 SMS 로그 샘플 3개.
(인도만 해당) DLT 등록 법인 ID, 템플릿 ID, SMS 메시지 전송에 사용된 콘텐츠 샘플을 제공합니다.

참고: 이동 통신사는 SMS 정보를 3일 이상 저장하지 않을 수 있습니다.
중요: Amazon CloudWatch Logs의 SMS 배달이 항상 정확한 SMS 배달 시간을 제공하지는 않습니다. 경우에 따라 CloudWatch 로그가 수신되기 전에 SMS 메시지가 배달될 수 있습니다. 배달 로그의 dwellTimeMsUntilDeviceAck 값은 이동 통신사가 메시지를 수락한 시점을 보여주지만 지연된 SMS 메시지에 대한 정보는 제공하지 않습니다. 자세한 내용은 SMS 배달에 대한 CloudWatch 메트릭 및 로그 보기를 참조하세요.