View a markdown version of this page

RCS 메시지 테스트 - AWS 최종 사용자 메시징 SMS
테스트 에이전트란 무엇입니까?테스트 디바이스 추가테스터 초대 흐름테스트 디바이스 보기테스트 메시지 전송SMS 대체 테스트RCS 테스트 문제 해결

기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.

RCS 메시지 테스트

프로덕션 환경에서 RCS 메시징을 시작하기 전에 테스트 에이전트를 사용하여 통합을 테스트할 수 있습니다. 테스트 에이전트는 AWS RCS 에이전트에 대한 테스트 등록을 제출할 때 생성되는 RCS for Business ID입니다. 프로덕션과 동일한 전체 API 액세스를 제공하지만 등록된 테스트 디바이스로만 메시지 전송을 제한합니다. 테스트에는 통신 사업자 승인이 필요하지 않습니다.

이 장에서는 테스트 디바이스를 관리하는 방법과 일반적인 문제를 해결하는 방법을 포함하여 테스트 에이전트 자체에 중점을 둡니다. 첫 번째 AWS RCS 에이전트 생성 및 테스트 메시지 전송에 대한 step-by-step 연습은 섹션을 참조하세요RCS 시작하기. AWS RCS 에이전트 생성 및 테스트 등록 제출에 대한 자세한 내용은 섹션을 참조하세요RCS 에이전트 관리.

중요

테스트 메시지는 표준 RCS 요금으로 청구됩니다. 테스트 에이전트는 통합을 검증하기 위한 테스트 환경을 제공하지만 테스트 디바이스에 대한 메시지 전송에는 프로덕션 메시지와 동일한 요금이 발생합니다.

테스트 에이전트란 무엇입니까?

테스트 에이전트는 AWS RCS 에이전트에 대한 테스트 등록을 제출할 때 AWS End User Messaging이 생성하는 RCS for Business ID입니다. 테스트 에이전트를 사용하면 다음을 수행할 수 있습니다.

  • 통신 사업자 승인 없이 등록된 테스트 디바이스에 RCS 메시지 전송

  • SendTextMessage API를 사용하여 프로덕션에서 사용하는 것과 동일한 API인 테스트 메시지를 보냅니다.

  • 테스트 워크플로에 대한 풀, 구성 세트, 옵트아웃 목록, 키워드 및 기타 AWS 최종 사용자 메시징 기능 구성

  • 자동 응답 키워드로 메시지를 전송하여 양방향 메시징 테스트

  • 승인된 SMS 전화번호를 사용하거나 사용하지 않고 SMS 대체 동작 테스트

테스트 에이전트에 등록한 테스트 디바이스는 해당 AWS RCS 에이전트의 모든 국가에서 작동합니다. 국가별로 테스트 디바이스를 별도로 등록할 필요는 없습니다. 반대로 테스트 에이전트는 해당 국가의 국가 시작 등록을 제출했는지 여부에 관계없이 모든 국가의 테스트 디바이스에 메시지를 보낼 수 있습니다.

테스트 디바이스 추가

테스트 RCS 메시지를 전송하려면 먼저 하나 이상의 테스트 디바이스를 확인된 대상 번호로 등록해야 합니다. AWS End User Messaging 콘솔 또는 CreateVerifiedDestinationNumber API를 사용하여 테스트 디바이스를 추가할 수 있습니다.

Console

콘솔에서 테스트 디바이스는 AWS RCS 에이전트 생성 워크플로의 일부로 추가됩니다. step-by-step 콘솔 지침은 단원을 참조하십시오2단계: 테스트 디바이스 추가.

AWS CLI

create-verified-destination-number 명령을 --rcs-agent-id 파라미터와 함께 사용하여 AWS RCS 에이전트에 테스트 디바이스를 등록합니다.

aws pinpoint-sms-voice-v2 create-verified-destination-number \
    --destination-phone-number +12065550100 \
    --rcs-agent-id rcs-a1b2c3d4
참고

--origination-identity 파라미터는 필요하지 않습니다. --rcs-agent-id를 지정하면 명령은 해당 에이전트에 대한 RCS 테스트를 위해 전화번호를 등록합니다. 생략--rcs-agent-id하고 --origination-identity 대신를 사용하면 명령은 SMS 확인을 위해 OTP SMS를 전송합니다. 두 파라미터는 상호 배타적입니다.

테스터 초대 흐름

테스트 디바이스를 추가하면 AWS End User Messaging은 RBM Tester Management라는 RCS 에이전트로부터 테스터 초대를 보냅니다. 초대에는 수락하거나 거부할 수 있는 버튼이 포함되어 있습니다. 120초 대기 요구 사항 및 iOS별 동작을 포함하여 테스터 초대 흐름에 대한 자세한 내용은 섹션을 참조하세요2단계: 테스트 디바이스 추가.

테스트 디바이스 보기

AWS End User Messaging 콘솔 또는 DescribeVerifiedDestinationNumbers API를 사용하여 AWS RCS 에이전트에 등록된 테스트 디바이스를 볼 수 있습니다.

Console

콘솔에서 등록된 테스트 디바이스를 보려면 AWS RCS 에이전트의 세부 정보 페이지로 이동하여 테스트 탭을 선택합니다. 탭에는 확인 상태 및 전화번호를 포함하여 에이전트와 연결된 모든 확인된 대상 번호가 표시됩니다.

AWS CLI

describe-verified-destination-numbers 명령을 사용하여 AWS RCS 에이전트의 테스트 디바이스를 나열합니다. 와 함께 --filters 파라미터를 사용하여 RCS 테스트 디바이스만 rcs-agent-id 표시합니다.

aws pinpoint-sms-voice-v2 describe-verified-destination-numbers \
    --filters Name=rcs-agent-id,Values=rcs-a1b2c3d4

테스트 에이전트에 등록한 테스트 디바이스는 해당 AWS RCS 에이전트에 대해 전역적으로 작동합니다. 한 AWS 리전에 등록된 테스트 디바이스는 AWS RCS 에이전트를 사용할 수 있는 모든 AWS 리전에서 전송된 테스트 메시지를 수신할 수 있습니다.

테스트 메시지 전송

테스트 디바이스가 테스터 초대를 수락한 후 RCS 메시지를 보낼 수 있습니다. AWS End User Messaging 콘솔 또는 SendTextMessage API를 사용하여 테스트 메시지를 보낼 수 있습니다.

Console
콘솔을 사용하여 테스트 메시지를 보내려면

  1. AWS End User Messaging 콘솔을 엽니다.

  2. 탐색 창의 구성에서 RCS 에이전트를 선택합니다.

  3. 테스트할 AWS RCS 에이전트를 선택합니다.

  4. 테스트 탭을 선택합니다.

  5. 테스트 메시지 전송 섹션의 목록에서 확인된 테스트 디바이스를 선택합니다.

  6. 메시지 텍스트를 입력합니다.

  7. 문자 메시지 전송을 선택합니다.

AWS CLI

send-text-message 명령을 사용하여 확인된 대상 번호로 테스트 메시지를 보냅니다. AWS RCS 에이전트 ARN을 발신 자격 증명으로 지정합니다.

aws pinpoint-sms-voice-v2 send-text-message \
    --destination-phone-number +12065550100 \
    --origination-identity arn:aws:sms-voice:us-east-1:123456789012:rcs-agent/rcs-a1b2c3d4 \
    --message-body "Hello from RCS testing!"

SMS 대체 테스트

RCS 전송이 불가능한 경우 SMS 폴백 동작을 테스트하여 메시지가 SMS를 통해 전송되었는지 확인할 수 있습니다. 승인된 SMS 번호가 없는 테스트 및 전체 end-to-end 흐름을 포함하여 SMS 폴백 테스트에 대한 전체 지침은 섹션을 참조하세요SMS 대체 테스트.

RCS 테스트 문제 해결

다음 섹션에서는 RCS 메시지를 테스트할 때 발생할 수 있는 일반적인 문제와 이를 해결하는 방법을 설명합니다.

테스트 디바이스가 RCS 메시지를 수신하지 않음

테스트 디바이스가 RCS 메시지를 수신하지 않는 경우 다음을 확인합니다.

  • 테스트 디바이스가 테스터 초대를 수락했는지 확인합니다. DescribeVerifiedDestinationNumbers API를 rcs-agent-id 필터와 함께 사용하여 디바이스의 확인 상태를 확인합니다.

  • 테스트 디바이스에 RCS가 활성화되어 있는지 확인합니다. Android에서는 RCS 또는 Chat 기능에 대한 메시징 앱 설정을 확인합니다. iPhone에서 RCS에는 iOS 18 이상이 필요합니다.

  • 테스트 디바이스에 활성 데이터 연결이 있는지 확인합니다. RCS 메시지는 SMS 채널이 아닌 데이터를 통해 전달됩니다.

  • E.164 형식으로 올바른 전화번호로 전송하는지 확인합니다.

RCS 대신 SMS로 전송된 메시지

테스트 메시지가 RCS 대신 SMS로 전달되는 경우 다음을 확인하세요.

  • AWS RCS 에이전트 ARN 또는 AWS RCS 에이전트를 발신 자격 증명으로 포함하는 풀을 사용하여 메시지를 전송하는지 확인합니다. SMS 전화번호만 지정하면 SMS를 통해 메시지가 전송됩니다.

  • 테스트 디바이스가 테스터 초대를 수락했고 올바른 AWS RCS 에이전트의 확인된 대상 번호로 등록되었는지 확인합니다.

  • 전송 이벤트를 확인하여 메시지가 처음에 RCS를 통해 시도되었고 SMS로 다시 전송되었는지 또는 SMS를 통해 직접 전송되었는지 확인합니다.

테스터 초대를 받지 못함

테스트 디바이스가 테스터 초대를 받지 못하면 다음을 확인하세요.

  • 테스트 디바이스를 추가한 후 테스터 초대가 도착하는 데 최대 20분이 걸릴 수 있습니다. 20분 후에도 초대가 도착하지 않으면 테스트 디바이스를 제거하고 다시 추가합니다.

  • 전화번호가 올바른 E.164 형식이고 유효한 휴대폰 번호인지 확인합니다.

  • 테스트 디바이스에 활성 데이터 연결이 있고 RCS가 활성화되어 있는지 확인합니다.

iOS: 알 수 없는 발신자의 테스터 초대

iOS 디바이스(iPhone iOS 18 이상)에서는 RBM Tester Management의 테스터 초대가 메시지 앱의 알 수 없는 발신자 폴더로 필터링될 수 있습니다. 이는 알 수 없는 연락처의 메시지에 대한 기본 iOS 동작입니다.

초대를 찾으려면:

iOS에서 테스터 초대를 찾으려면

  1. iPhone에서 메시지 앱을 엽니다.

  2. 왼쪽 상단 모서리에서 필터를 탭합니다(또는 메시지 목록에서 오른쪽으로 살짝 밀기).

  3. 알 수 없는 발신자를 탭합니다.

  4. RBM 테스터 관리 메시지를 찾아 테스터로 만들기를 탭하여 초대를 수락합니다.