기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 콘솔에서 리치 RCS 메시지 전송
AWSEnd User Messaging 콘솔은 코드를 작성하지 않고 풍부한 RCS 메시지를 빌드하고 전송하는 데 사용할 수 있는 시각적 메시지 작성기를 제공합니다. 컴포저는 `SendRcsMessage` API에 직접 매핑되며 텍스트 메시지, 파일 메시지, 리치 카드, 캐러셀 등 모든 콘텐츠 유형을 지원합니다. 모든 메시지 유형에 대화형 제안을 연결하고, TTL(time-to-live) 설정을 구성하고, 디바이스가 RCS를 지원하지 않는 수신자에 대해 SMS 또는 MMS 폴백을 설정할 수 있습니다.
RCS **테스트 인터페이스의 아웃바운드 테스트 메시지 탭에서 풍부한 메시지를** 작성하고 전송합니다. `SendRcsMessage` API를 애플리케이션에 통합하기 전에 렌더링 및 전송을 검증할 수 있도록 메시지가 확인된 RBM 테스터로 전송됩니다.
메시지를 구성하면 실시간 전화 미리 보기에 메시지가 수신자의 디바이스에서 렌더링되는 방식이 표시됩니다. 동일한 JSON 페이로드 또는 AWSCLI 명령을 복사하여 애플리케이션 코드에서 동일한 메시지 구조를 사용할 수도 있습니다.
메시지 유형 및 API 구조에 대한 자세한 내용은 섹션을 참조하세요[리치 RCS 메시지 전송](rcs-rich-messaging.md). 제안 유형 및 동작에 대한 자세한 내용은 섹션을 참조하세요[RCS 제안 구성](rcs-suggestions.md).
## 사전 조건
콘솔에서 리치 RCS 메시지를 보내기 전에 다음을 확인합니다.
+ RCS 에이전트가 **테스트** 또는 **활성** 상태입니다.
+ 에이전트와 연결된 확인된 RBM 테스터 전화번호가 하나 이상 있습니다. 설정 지침은 [RCS 메시지 테스트](rcs-testing.md) 섹션을 참조하세요.
+ Amazon S3에서 미디어 파일을 보내려는 경우 S3 버킷에 `sms-voice.amazonaws.com` 읽기 액세스 권한을 부여하는 버킷 정책이 있어야 합니다. 자세한 내용은 [RCS 파일 메시지 전송](rcs-file-messages.md)을 참조하세요.
## 리치 RCS 메시지 전송
다음 절차에 따라 AWSEnd User Messaging 콘솔에서 풍부한 RCS 메시지를 작성하고 전송합니다.
1. 에서 AWSEnd User Messaging 콘솔을 엽니다[https://console.aws.amazon.com/sms-voice/](https://console.aws.amazon.com/sms-voice/).
1. 탐색 창의 **구성**에서 **RCS 에이전트**를 선택합니다.
1. 발신 자격 증명으로 사용할 에이전트를 선택합니다. 에이전트 상태는 **테스트** 중 또는 **활성**이어야 합니다.
1. **테스트** 탭을 선택합니다.
1. **RCS 테스트 인터페이스**에서 **아웃바운드 테스트 메시지** 탭을 선택합니다.
1. **테스트 RCS 메시지 전송** 섹션의 **RBM 테스터 선택**에서 확인된 RBM 테스터 전화번호를 선택합니다.
1. (선택 사항) **구성 세트**에서 메시지 이벤트를 추적할 구성 세트를 선택합니다.
1. **API 선택**에서 **SendRcsMessage**를 선택합니다.
1. **메시지 형식 선택**에서 전송할 메시지 유형을 선택합니다.
+ **텍스트**: 메시지 본문을 입력합니다(최대 3,072자).
+ **파일**: 미디어 소스의 경우 **S3 버킷** 또는 **퍼블릭 URL**을 선택한 다음 전송할 파일의 **S3 URI**(또는 HTTPS URL)를 입력합니다. **S3 찾아보**기를 선택하여 버킷에서 파일을 선택하거나 **보기를** 선택하여 새 브라우저 탭에서 참조된 파일을 엽니다. 최대 파일 크기는 100MB입니다. 선택적으로 비디오 또는 PDF 파일에 대한 썸네일 URL을 제공합니다.
+ **리치 카드**: 다음 카드 필드를 구성합니다. 제목, 설명 또는 미디어 중 하나 이상이 필요합니다.
+ **카드 방향**: `VERTICAL` 또는를 선택합니다`HORIZONTAL`.
+ **카드 제목**: 제목을 입력합니다(최대 200자).
+ **카드 설명**: 설명을 입력합니다(최대 2,000자).
+ **미디어 URL**: 미디어 소스에서 **S3 버킷** 또는 **퍼블릭 URL**을 선택한 다음 **S3 URI**(또는 HTTPS URL)를 입력합니다. **S3 찾아보**기를 선택하여 파일을 선택하거나 **보기를** 선택하여 새 브라우저 탭에서 엽니다. 최대 파일 크기는 100MB입니다.
+ (선택 사항) **미디어 썸네일 URL**: 전체 미디어가 로드되기 전에 표시되는 미리 보기 이미지입니다.
+ (**수평** 방향만 해당) **썸네일 정렬**: `LEFT` 또는 `RIGHT`를 선택하여 썸네일 이미지를 배치합니다.
+ **카드 제안**: 카드 경계 내에서 버튼으로 렌더링되는 제안을 최대 4개까지 추가합니다. 제안 유형은 섹션을 참조하세요[RCS 제안 구성](rcs-suggestions.md).
+ **캐러셀**: 다음을 구성합니다.
+ **카드 너비**: `SMALL` 또는를 선택합니다`MEDIUM`.
+ **미디어 높이(모든 카드)**: `SHORT` 또는를 선택합니다`MEDIUM`. 캐러셀의 모든 카드는 동일한 미디어 높이를 사용합니다.
+ **카드**: 2\~10개의 카드를 추가합니다. 각 카드에는 카드 제목, 카드 설명, 미디어 URL(S3 버킷 또는 퍼블릭 URL, 최대 100MB) 및 최대 4개의 카드 제안이 포함됩니다. 각 카드에는 제목, 설명 또는 미디어 중 하나 이상이 필요합니다.
+ **JSON**: 원시 `RcsMessageContent` JSON 페이로드를 직접 붙여넣습니다. **JSON 형식을** 선택하여 페이로드의 형식을 지정합니다. 콘솔은 구조를 검증하고 전화 미리 보기를 실시간으로 업데이트합니다.
1. (선택 사항) S3 브라우저를 사용하여 미디어 파일을 구성합니다.
1. **S3 찾아보기(Browse S3)**를 선택합니다.
1. 드롭다운 목록에서 버킷을 선택합니다.
1. 접두사(폴더)를 탐색하여 파일을 찾습니다.
1. 파일을 선택합니다. URL 필드는 자동으로 채워집니다.
**참고**
S3 버킷에는 객체에 대한 `sms-voice.amazonaws.com` 읽기 액세스 권한을 부여하는 버킷 정책이 있어야 합니다. 필수 정책은 섹션을 참조하세요[RCS 파일 메시지 전송](rcs-file-messages.md).
1. (선택 사항) 메시지 수준 제안을 추가합니다. **제안** 섹션에서 다음을 수행합니다.
1. **제안 추가를** 선택합니다.
1. **제안 유형**에서 **회신**, **URL 열기**, **전화 걸**기, **위치 표시**, **요청 위치** 또는 **일정 이벤트** 중 하나를 선택합니다.
1. 선택한 유형의 필수 필드를 입력합니다. 모든 제안 유형에는 `Text` 값(최대 25자)과 `PostbackData` (최대 2,048자)이 필요합니다.
1. 반복하여 최대 11개의 메시지 수준 제안을 추가합니다.
메시지 수준 제안은 전체 메시지 아래에 칩 목록으로 렌더링됩니다. 모든 콘텐츠 유형(텍스트, 파일, 리치 카드 또는 캐러셀)에 메시지 수준 제안을 연결할 수 있습니다. 자세한 내용은 [RCS 제안 구성](rcs-suggestions.md)을 참조하세요.
1. (선택 사항) TTL(time-to-live) 설정을 구성합니다. **고급 옵션을** 확장하고 Time **to Live(초)** 필드에 값을 입력합니다. 유효한 값의 범위는 1\~172,800초(48시간)입니다. 최소값은 10초가 권장됩니다.
TTL이 만료되기 전에 메시지가 전송되지 않으면 서비스가 TTL 만료 이벤트를 트리거합니다. 폴백을 구성한 경우 해당 시점에 폴백 메시지가 전송됩니다.
**고급 옵션** 섹션에는 **최고 가격(USD)**, **드라이 런**, **메시지 피드백**, **보호 구성** 및 **컨텍스트**(선택 사항 키-값 메타데이터)도 포함되어 있습니다.
1. (선택 사항) SMS 또는 MMS 대체를 구성합니다. **폴백 구성** 섹션을 확장합니다.
1. **폴백 채널**에서 **SMS** 또는 **MMS**를 선택합니다.
1. **폴백 메시지 본문**에 메시지 텍스트(최대 1,600자)를 입력합니다. 대체 채널을 선택한 경우 메시지 본문이 필요합니다.
1. MMS의 경우 하나 이상의 미디어 URLs.
1. **발신 자격 증명**에 폴백 SMS 또는 MMS 메시지에 사용할 전화번호 또는 발신자 ID를 입력합니다. 이는 RCS 에이전트에서 전송할 때 필요합니다.
RCS를 통해 메시지를 전송할 수 없는 경우(예: 수신자의 디바이스가 RCS를 지원하지 않거나 TTL이 만료되는 경우) 폴백이 트리거됩니다. 자세한 내용은 [리치 RCS 메시지 전송](rcs-rich-messaging.md) 단원을 참조하십시오.
1. (선택 사항) **고급 옵션**에서 **Dry run**을 활성화하여 전송하지 않고 메시지 구조를 검증합니다. 이로 인해 요금이 부과되지 않으며 수신자에게 메시지가 전달되지 않습니다.
1. 작곡기 오른쪽에 있는 전화 미리 보기를 검토합니다. 미리 보기는 실시간으로 업데이트되며 다음을 보여줍니다.
+ 콘텐츠 렌더링(텍스트, 미디어, 카드 레이아웃, 캐러셀 스크롤)
+ 메시지 아래의 제안 칩
+ 카드 내 카드 수준 버튼
**참고**
미리 보기는 Android 렌더링과 비슷합니다. iOS 또는 기타 RCS 클라이언트의 디스플레이는 다를 수 있습니다. 미리 보기는 제안 선택 동작을 시뮬레이션하지 않습니다.
1. **테스트 메시지 전송**을 선택하여 선택한 RBM 테스터에 메시지를 보내거나 다음 옵션 중 하나를 사용합니다.
+ **JSON 복사**: 메시지 JSON을 클립보드에 복사합니다. **RcsMessageContent**를 선택하여 콘텐츠 부분만 복사하거나 **전체 API 요청을** 선택하여 전체 `SendRcsMessage` 요청 본문을 복사합니다.
+ **CLI 명령 복사**: 동등한 `aws pinpoint-sms-voice-v2 send-rcs-message` 명령을 복사합니다.
## 입력 검증
콘솔은 메시지를 구성할 때 실시간 검증을 수행합니다. 유효성 검사 오류는 영향을 받는 필드 옆에 인라인으로 표시됩니다. 다음 표에는 검증 규칙이 요약되어 있습니다.
**콘솔 검증 규칙**
| Field | 규칙 |
| --- | --- |
| 전화번호 | E.164 형식이어야 합니다. |
| 미디어 URL | https:// 또는 로 시작해야 합니다. s3:// |
| 미디어 파일 크기 | 최대 100MB |
| 제안 텍스트 | 최대 25자 |
| 포스트백 데이터 | 최대 2,048자 |
| 카드 제목 | 최대 200자 |
| 카드 설명 | 최대 2,000자 |
| 캐러셀 카드 | 최소 2, 최대 10 |
| 카드 수준 제안 | 카드당 최대 4개 |
| 메시지 수준 제안 | 최대 11 |
| 문자 메시지 본문 | 최대 3,072자 |
| TTL | 1\~172,800초 |
| 폴백 메시지 본문 | 최대 1,600자 |
## 관련 리소스
+ [리치 RCS 메시지 전송](rcs-rich-messaging.md)
+ [RCS 제안 구성](rcs-suggestions.md)
+ [RCS 메시지 테스트](rcs-testing.md)
+ [RCS 파일 메시지 전송](rcs-file-messages.md)