기계 번역으로 제공되는 번역입니다. 제공된 번역과 원본 영어의 내용이 상충하는 경우에는 영어 버전이 우선합니다.
# 리치 RCS 메시지 전송
AWSEnd User Messaging의 `SendRcsMessage` API 작업을 사용하면 RCS(Rich Communication Services)를 통해 풍부한 대화형 콘텐츠를 수신자에게 보낼 수 있습니다. 리치 RCS 메시지는 일반 텍스트 외에도 리치 카드, 캐러셀, 미디어 파일 및 수신자가 조치를 취하기로 선택한 제안을 포함합니다. 이러한 대화형 요소는 단방향 알림을 수신자가 약속을 확인하거나, 제품 카탈로그를 찾아보거나, 대화를 떠나지 않고 위치를 공유하도록 하는 등 양방향 대화 환경으로 전환합니다.
이미지 및 작업 버튼이 있는 제품 카드, 일정 제안이 포함된 예약 확인, 파일 첨부 파일 또는 수신자가 스크롤하는 다중 항목 캐러셀과 같이 시각적으로 풍부한 대화형 콘텐츠를 제공해야 하는 `SendRcsMessage` 경우를 사용합니다. 각 `SendRcsMessage` 요청에는 텍스트 콘텐츠에 대한 별도의 텍스트 본문이 포함되며, 디바이스가 RCS를 지원하지 않는 수신자를 위한 선택적 SMS 또는 MMS 폴백이 포함될 수 있습니다.
서식이 많지 않은 일반 텍스트 메시지의 경우 `SendTextMessage` API 작업을 대신 사용합니다.는 텍스트 콘텐츠만 `SendTextMessage` 허용하므로 요청이 더 간단해지고 수신자 기능에 따라 RCS와 SMS 중에서 자동으로 선택하는 메시징 풀과 함께 작동합니다. 자세한 내용은 [RCS 메시지 전송](rcs-send-message.md)을 참조하세요.
**중요**
RCS가 지원되는 모든 국가에서 `SendRcsMessage`와 함께 RCS 메시징을 사용할 수 있습니다. 현재 목록은 섹션을 참조하세요[RCS 지원 국가](rcs-supported-countries.md).
**Topics**
+ [사전 조건](#rcs-rich-messaging-prerequisites)
+ [SendTextMessage와 SendRcsMessage 중에서 선택](#rcs-rich-messaging-choosing)
+ [콘텐츠 유형](#rcs-rich-messaging-content-types)
+ [제안](#rcs-rich-messaging-suggestions)
+ [SendRcsMessage 요청 개요](#rcs-rich-messaging-api)
+ [메시지 크기 및 개수 제한](#rcs-rich-messaging-limits)
+ [전송 이벤트 및 수신자 작업](#rcs-rich-messaging-events)
+ [모범 사례](#rcs-rich-messaging-best-practices)
+ [문자 메시지](rcs-text-messages.md)
+ [파일 메시지](rcs-file-messages.md)
+ [리치 카드](rcs-rich-cards.md)
+ [캐러셀](rcs-carousels.md)
+ [제안](rcs-suggestions.md)
+ [메시지 만료](rcs-message-expiration.md)
+ [메시지당 대체](rcs-fallback-per-message.md)
+ [메시지 이벤트](rcs-events.md)
+ [인바운드 미디어](rcs-inbound-media.md)
+ [모범 사례](rcs-best-practices.md)
+ [콘솔 리치 메시징](rcs-console-rich-messaging.md)
## 사전 조건
리치 RCS 메시지를 보내기 전에의 RCS 설정 단계를 완료합니다[RCS 시작하기](rcs-getting-started.md). **활성** 상태의 등록된 AWS RCS 에이전트 외에도 다음을 확인합니다.
+ 프로덕션 수신자에게 전송하기 전에 풍부한 콘텐츠를 검증하려면 등록된 테스트 디바이스를 테스트 에이전트에 추가하고 테스트 메시지를 전송합니다. 자세한 내용은 [RCS 메시지 테스트](rcs-testing.md)을 참조하세요.
+ 전송 상태 이벤트를 수신하도록 이벤트 대상(Amazon SNS 주제 또는 Amazon Data Firehose 전송 스트림)을 구성합니다. 수신자 선택은 포스트백 이벤트로 애플리케이션에 전달되므로 메시지에 제안과 같은 대화형 요소가 포함된 경우 이벤트 대상이 필요합니다. 자세한 내용은 [AWS End User Messaging SMS의 이벤트 대상](configuration-sets-event-destinations.md)을 참조하세요.
+ SMS 또는 MMS 폴백을 구성하고 SMS 펌프 위험이 있는 대상으로 전송하는 경우 보호 구성을 연결하여 폴백 메시지에 옵트아웃 및 국가 규칙을 적용합니다. 자세한 내용은 [AWS 최종 사용자 메시징 SMS의 사기 방지](protect.md)을 참조하세요.
## SendTextMessage와 SendRcsMessage 중에서 선택
두 API 작업 모두 RCS를 통해 메시지를 전송할 수 있지만 용도는 다릅니다.는 `SendTextMessage` 모든 메시지를 SMS로 전송할 수 있으며 RCS를 통해 메시지를 전송할 수도 있으므로 요청 계약이 더 간단해집니다.는 풍부한 RCS 콘텐츠를 `SendRcsMessage` 수임하고 미디어 및 구조화된 콘텐츠 유형, TTL(time-to-live)을 통한 메시지 만료, 메시지당 SMS 또는 MMS 폴백을 포함하여가 보유하지 `SendTextMessage` 않은 기능을 추가합니다.
**SendTextMessage와 SendRcsMessage 비교**
| 기능 | SendTextMessage | SendRcsMessage |
| --- | --- | --- |
| 메시지 콘텐츠 | 일반 텍스트만 | 텍스트, 파일, 리치 카드 및 캐러셀, 각각 선택적 제안 사항 포함 |
| 전송 채널 | RCS 또는 SMS | RCS, 선택적 SMS 또는 MMS 대체 포함 |
| 채널 선택 | 풀은 수신자 기능별로 RCS 또는 SMS를 자동으로 선택합니다. | RCS 먼저 구성한 SMS 또는 MMS 대체 |
| 폴백 | 자동, 풀 기반 | 메시지당 명시적 |
| 발신 ID | 풀, 전화번호, 발신자 ID 또는 AWS RCS 에이전트 | 풀 또는 AWS RCS 에이전트 |
| 메시지 만료(TTL) | 아니요 | 예 |
| 계약 요청 | 더 간단합니다. SMS 및 MMS 전송과 동일한 API | 별도의 텍스트 본문 및 콘텐츠 유형이 있는 전용 RCS API |
풀 기반 자동 채널 선택을 원하거나 코드 변경을 최소화하면서 기존 SMS 워크플로를 마이그레이션하려는 경우 일반 텍스트 알림을 `SendTextMessage` 선택합니다. 리치 카드, 캐러셀, 미디어 파일 또는 제안이 `SendRcsMessage` 필요한 경우, 정의된 메시지당 폴백을 원하는 경우 또는 시간에 민감한 콘텐츠에 대해 TTL 기반 만료가 필요한 경우를 선택합니다.
## 콘텐츠 유형
`RcsMessageContent` 파라미터에는 정확히 하나의 콘텐츠 유형을 가진 `Content` 객체와 선택적 메시지 수준 `Suggestions` 목록이 포함되어 있습니다. 단일 요청으로 여러 콘텐츠 유형을 결합할 수 없습니다.
**RCS 콘텐츠 유형**
| 콘텐츠 유형 | 설명 | 추가 정보 |
| --- | --- | --- |
| TextMessage | 최대 3,072자의 텍스트 본문, 선택적 제안 사항. SMS 메시지와 달리 RCS 문자 메시지에는 제안이 포함될 수 있으며 세그먼트로 분할되지 않고 단일 메시지로 전달됩니다. | [RCS 문자 메시지 전송](rcs-text-messages.md) |
| FileMessage | HTTPS 또는 Amazon S3 URL에서 참조하는 단일 미디어 파일(이미지, 비디오, 오디오 또는 PDF). | [RCS 파일 메시지 전송](rcs-file-messages.md) |
| RichCard | 선택적 미디어, 제목, 설명 및 최대 4개의 제안이 포함된 구조화된 카드입니다. | [RCS 리치 카드 전송](rcs-rich-cards.md) |
| 캐러셀 | 각각 고유한 미디어, 텍스트 및 제안이 있는 2\~10개의 카드로 구성된 스크롤 가능한 세트입니다. | [RCS 캐러셀 전송](rcs-carousels.md) |
## 제안
제안은 수신자가 조치를 취하기로 선택한 대화형 칩입니다. 모든 콘텐츠 유형에 제안을 추가할 수 있습니다. 메시지 수준 제안은 전체 메시지(최대 11개)에 적용되고 카드 수준 제안은 개별 리치 카드 또는 캐러셀 카드(최대 4개)에 적용됩니다.AWSEnd User Messaging은 회신, 링크, 전화번호 다이얼링 또는 위치 공유와 같은 작업 등 6가지 제안 유형을 지원합니다. 제안 유형, 파라미터 및 제안 탭 수신 방법의 전체 목록은 섹션을 참조하세요[RCS 제안 구성](rcs-suggestions.md).
## SendRcsMessage 요청 개요
`SendRcsMessage` 요청은 다음 키 파라미터를 사용합니다.
**주요 SendRcsMessage 파라미터**
| 파라미터 | 필수 | 설명 |
| --- | --- | --- |
| DestinationPhoneNumber | 예 | 와 같은 E.164 형식의 수신자 전화번호입니다\+12065550100. |
| OriginationIdentity | 예 | 전송할 풀 또는 AWS RCS 에이전트의 ID 또는 ARN입니다. 에이전트는 활성 상태여야 합니다. |
| RcsMessageContent | 아니요 | 메시지 콘텐츠입니다. TextMessage, FileMessageRichCard, 또는 중 정확히 하나가 있는 Content 객체Carousel와 선택적 최상위 Suggestions 목록을 포함합니다. |
| FallbackConfiguration | 아니요 | RCS 전송에 실패할 경우 보낼 SMS 또는 MMS 메시지입니다. 필수 Channel (SMS 또는 MMS), MessageBody, MMSMediaUrls의 경우 선택 사항, 전화번호 또는 발신자 IDOriginationIdentity인가 포함됩니다. |
| TimeToLive | 아니요 | 메시지가 전송되지 않은 경우 메시지가 만료되기 전의 초 단위 시간입니다. 최소값은 1초이고 최대값은 172,800초(48시간)입니다. 10초 이상의 값을 사용하는 것이 좋습니다. |
| MessageFeedbackEnabled | 아니요 | 메시지에 대한 메시지 피드백을 활성화true하려면 로 설정합니다. 수신자가 메시지를 수신하면 PutMessageFeedback 작업을 호출하여 메시지 상태를 업데이트합니다. |
응답이 성공하면 전송 상태 이벤트의 상관 `MessageId` 관계를 지정하는 데 사용하는이 반환됩니다.
**참고**
에 대한 폴백`SendRcsMessage`은를 통해 메시지별로 구성됩니다`FallbackConfiguration`. 전체 대체 동작은 섹션을 참조하세요[메시지당 SMS 또는 MMS 폴백 구성](rcs-fallback-per-message.md).
## 메시지 크기 및 개수 제한
**RCS 메시지 제한**
| Limit | 값 |
| --- | --- |
| 텍스트 메시지 본문 | 3,072자 |
| 리치 카드 제목 | 200자 |
| 리치 카드 설명 | 2,000자 |
| 미디어 파일 크기 | 100MB |
| 미디어 URL 길이 | 2,000자 |
| 메시지당 제안 사항 | 11 |
| 카드당 제안 사항 | 4 |
| 제안 표시 텍스트 | 25자 |
| 포스트백 데이터 | 2,048자 |
| 캐러셀 카드 | 카드 2\~10개 |
| Time-to-live | 1초\~172,800초(48시간) |
모든 콘텐츠 유형에 대한 RCS 제한 및 제한은 섹션을 참조하세요[메시징 제한 및 제한](sms-limitations.md).
## 전송 이벤트 및 수신자 작업
AWSEnd User Messaging은 전송, 읽기, 실패, 만료 및 포스트백 이벤트를 포함하여 메시지 전송 상태 및 수신자 작업을 보고하는 이벤트를 생성합니다. 포스트백 이벤트는 수신자가 제안을 선택하고 `PostbackData` 값을 포함할 때 생성됩니다. 이러한 이벤트를 Amazon SNS 주제, Amazon Data Firehose 전송 스트림 또는 Amazon CloudWatch Logs로 라우팅합니다. 자세한 내용은 [RCS 메시지 이벤트](rcs-events.md)을 참조하세요.
## 모범 사례
풍부한 RCS 메시지를 대화형 대화형 경험으로 설계합니다. 일회용 암호와 같은 시간에 민감한 콘텐츠`TimeToLive`의 경우를 설정하고, 디바이스가 RCS를 지원하지 않더라도 수신자에게 도달해야 하는 메시지에 대해 SMS 또는 MMS 폴백을 구성하고, 제안 레이블을 짧게 유지하고(제한은 25자), 애플리케이션이 추가 조회 없이 응답을 라우팅할 수 `PostbackData` 있도록에 구조화된 식별자를 포함합니다. 자세한 지침은 섹션을 참조하세요[RCS 모범 사례](rcs-best-practices.md).