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

RCS 에이전트 관리

AWS RCS 에이전트는 RCS 메시징용 브랜드를 나타내는 AWS 최종 사용자 메시징의 최상위 리소스입니다. 테스트 에이전트와 국가 시작 에이전트(RCS for Business IDs. 키워드 및 양방향 메시징 구성은 AWS RCS 에이전트에서 정의됩니다. 브랜드 자산은 각 등록(테스트 에이전트 또는 국가 출시 에이전트)에 정의됩니다. AWS RCS 에이전트가 RCS for Business IDsRCS란 무엇입니까?.

AWS RCS 에이전트는 다음 수명 주기를 따릅니다.

하나의 AWS RCS 에이전트는 하나의 테스트 에이전트(RCS for Business ID)와 여러 국가 시작 에이전트(국가당 하나의 RCS for Business ID)에 매핑됩니다. 콘솔에서 AWS RCS 에이전트를 생성하면 워크플로가 즉시 테스트 에이전트를 생성하도록 안내합니다. 그런 다음 테스트 에이전트의 브랜드 구성을 사용하여 국가 시작 등록 양식을 미리 채워 중복 데이터 입력을 줄입니다.

AWS RCS 에이전트 이해

AWS RCS 에이전트는 관리하는 RCS for Business IDs 다릅니다. 다음 표에는 차이점이 요약되어 있습니다.

에이전트 ID 및 ARN

각 AWS RCS 에이전트에는 형식의 고유 식별자rcs-a1b2c3d4(접두사 rcs- 뒤에 16진수 문자열)가 있습니다. UpdateRcsAgent 및와 같은 API 작업을 호출할 때이 ID를 사용합니다DeleteRcsAgent.

각 AWS RCS 에이전트에는 다음 형식의 AWS 리소스 ARN도 있습니다.

arn:aws:sms-voice:region:account-id:rcs-agent/rcs-agent-id

AWS RCS 에이전트를 SendTextMessage API의 발신 자격 증명으로 지정하거나 에이전트를 전화 풀에 추가할 때 ARN을 사용할 수 있습니다.

수명 주기 상태

AWS RCS 에이전트는 다음 수명 주기 상태를 전환합니다.

2단계 자격 증명 모델 이해

AWS End User Messaging의 RCS는 AWS RCS 에이전트와 하나 이상의 RCS for Business IDs라는 두 가지 수준의 자격 증명 모델을 사용합니다.

하나의 AWS RCS 에이전트에는 다음과 같은 RCS for Business IDs.

다음 다이어그램은 이러한 자격 증명 간의 관계를 보여줍니다.

AWS RCS Agent (rcs-a1b2c3d4)
├── Testing agent (RCS for Business ID)
├── US country launch agent (US RCS for Business ID)
└── CA country launch agent (Canada RCS for Business ID)
        

키워드 및 양방향 메시징 대상은 AWS RCS 에이전트에서 구성되며 연결된 모든 RCS for Business IDs에 적용됩니다. 브랜드 자산은 각 등록(테스트 에이전트 또는 국가 출시 에이전트)마다 다릅니다. AWS RCS 에이전트에는 표시 이름, 삭제 방지 및 옵트아웃 목록과 같은 계정 수준 설정도 있습니다.

AWS RCS 에이전트 생성

AWS End User Messaging 콘솔 또는 CreateRcsAgent API를 사용하여 AWS RCS 에이전트를 생성할 수 있습니다. 에이전트를 생성할 때 콘솔에 표시 이름(태그로 저장되고 API를 통해 볼 수 없거나 수신자의 전화에 표시되지 않는 콘솔 전용 레이블)을 제공하고 삭제 방지 및 옵트아웃 목록 연결과 같은 선택적 설정을 구성합니다. 브랜드 자산은 AWS RCS 에이전트 자체가 아닌 등록에 정의됩니다.

브랜드 자산 요구 사항

브랜드 자산은 RCS 메시지와 함께 수신자에게 표시됩니다. 브랜드 자산은 테스트 등록의 일부로 제출되며, 콘솔은 에이전트 생성 워크플로의 연속으로 제공됩니다. AWS RCS 에이전트를 생성할 때 다음 자산이 필요합니다.

Console

AWS End User Messaging 콘솔은 AWS RCS 에이전트 생성 및 테스트 등록을 단일 안내 워크플로로 제공합니다. step-by-step 콘솔 지침은 단원을 참조하십시오1단계: AWS RCS 에이전트 생성 및 테스트 등록 제출.

AWS CLI

create-rcs-agent 명령을 사용하여 AWS RCS 에이전트를 생성합니다. 브랜드 자산(표시 이름, 설명, 로고, 배너 및 브랜드 색상)은이 명령의 파라미터가 아닙니다. 테스트 등록을 생성할 때 등록 필드로 제출됩니다.

aws pinpoint-sms-voice-v2 create-rcs-agent \
    --deletion-protection-enabled

다음과 같은 선택적 파라미터를 사용할 수 있습니다.

• --deletion-protection-enabled - 삭제 방지 기능이 비활성화될 때까지 에이전트가 삭제되지 않도록 합니다.

• --opt-out-list-name - 기존 옵트아웃 목록을 에이전트와 연결합니다.

• --tags - AWS RCS 에이전트를 구성하고 식별하기 위한 키-값 페어입니다.

AWS RCS 에이전트 업데이트

UpdateRcsAgent API를 사용하여 기존 AWS RCS 에이전트의 설정을 수정합니다. 다음 설정을 업데이트할 수 있습니다.

AWS RCS 에이전트 보기

AWS End User Messaging 콘솔 또는 DescribeRcsAgents API를 사용하여 AWS RCS 에이전트를 볼 수 있습니다.

Console

콘솔에서 AWS RCS 에이전트를 보려면 탐색 창의 구성에서 RCS 에이전트 페이지로 이동합니다. 목록 페이지에는 현재 수명 주기 상태, 에이전트 ID 및 표시 이름을 포함하여 계정의 모든 AWS RCS 에이전트가 표시됩니다.

브랜드 자산, 구성 설정 및 관련 등록을 포함한 세부 정보를 보려면 에이전트를 선택합니다.

AWS CLI

describe-rcs-agents 명령을 사용하여 계정의 모든 AWS RCS 에이전트를 나열합니다.

aws pinpoint-sms-voice-v2 describe-rcs-agents

특정 에이전트에 대한 세부 정보를 검색하려면 --rcs-agent-ids 파라미터를 사용합니다.

aws pinpoint-sms-voice-v2 describe-rcs-agents \
    --rcs-agent-ids rcs-a1b2c3d4

테스트 에이전트 검토

국가 시작 등록을 제출하기 전에 테스트 에이전트 구성을 검토하여 브랜드 자산, 키워드 및 메시징 설정이 올바른지 확인합니다. 테스트 에이전트는 국가 시작 등록을 위한 템플릿 역할을 하므로 진행하기 전에 문제를 해결해야 합니다.

테스트 에이전트를 검토하려면 AWS End User Messaging 콘솔에서 AWS RCS 에이전트로 이동하여 등록 탭을 선택합니다. 테스트 등록에는 로고, 배너 이미지, 브랜드 색상 및 수신자의 디바이스에 표시되는 표시 이름을 포함하여 현재 브랜드 구성이 표시됩니다.

DescribeRegistrationFieldValues API를 사용하여 테스트 등록에 대한 현재 필드 값을 프로그래밍 방식으로 검색할 수도 있습니다.

국가 시작 상태 보기

AWS RCS 에이전트에 대한 국가 시작 등록을 제출한 후 해당 국가의 각 통신 사업자에 대한 승인 상태를 추적할 수 있습니다.

Console

콘솔에서 국가 시작 상태를 보려면 AWS RCS 에이전트의 세부 정보 페이지로 이동하여 국가 시작 상태 탭을 선택합니다. 이 탭에는 시작 등록을 제출한 각 국가의 각 통신 사업자에 대한 승인 상태가 표시됩니다.

AWS CLI

describe-rcs-agent-country-launch-status 명령을 사용하여 캐리어별 시작 상태를 검색합니다.

aws pinpoint-sms-voice-v2 describe-rcs-agent-country-launch-status \
    --rcs-agent-id rcs-a1b2c3d4

응답에는 시작 등록을 제출한 각 국가의 각 통신 사업자에 대한 승인 상태가 포함됩니다.

각 통신 사업자는 에이전트를 독립적으로 검토하고 승인합니다. AWS RCS 에이전트는 해당 국가의 통신사가 에이전트를 승인하는 즉시 해당 국가의 메시지를 보낼 수 있습니다. RCS 메시지 전송을 시작하기 전에 모든 통신사가 승인할 때까지 기다릴 필요는 없습니다. 추가 통신사가 에이전트를 승인하면 해당 국가의 연락이 늘어납니다.

AWS RCS 에이전트 삭제

DeleteRcsAgent API를 사용하여 AWS RCS 에이전트를 영구적으로 삭제합니다. 에이전트를 삭제하면 연결된 모든 RCS for Business IDs(테스트 에이전트 및 모든 국가 시작 에이전트 포함)가 비활성화됩니다.

AWS RCS 에이전트를 삭제하려면 먼저 모든 관련 등록(테스트 및 국가 시작 등록 모두)을 삭제한 다음 삭제 방지를 비활성화해야 합니다. 삭제 방지가 활성화된 경우 DeleteRcsAgent API는 오류를 반환합니다. 삭제 방지를 비활성화하려면 삭제 방지가 로 설정된 UpdateRcsAgent API를 사용합니다false.