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

RCS 리치 카드 전송

리치 카드는 미디어, 텍스트 및 제안된 작업을 하나의 구조화된 메시지로 결합합니다. 수신자는 카드를 메시징 클라이언트의 기본 UI 요소로 보고 앱과 같은 경험을 제공합니다. 리치 카드를 사용하여 제품 세부 정보, 예약 확인 또는 프로모션 제안과 같은 상호 작용을 장려하는 정보를 제공합니다.

여러 카드를 스크롤 가능한 세트로 그룹화하려면 섹션을 참조하세요RCS 캐러셀 전송.

리치 카드를 사용해야 하는 경우

리치 카드는 대화형 요소가 있는 시각적 레이아웃의 이점을 활용하는 메시지에 매우 적합합니다. 일반적인 사용 사례는 다음과 같습니다.

메시지에 선택적 제안이 포함된 텍스트만 필요한 경우 RCS 문자 메시지 전송 대신를 사용합니다. 추가 카드 구조 없이 파일을 전송해야 하는 경우 섹션을 참조하세요RCS 파일 메시지 전송.

리치 카드 구성 요소

독립 실행형 리치 카드는 다음 구성 요소로 구성됩니다. 에는 MediaTitle, 또는 중 하나 이상이 Description 필요합니다CardContent.

카드 방향

CardOrientation 필드는 미디어와 텍스트 콘텐츠 간의 레이아웃 관계를 제어합니다. 이 필드는 필수 항목입니다.

미디어 및 높이

Media 객체에는 FileUrl (필수), 선택적 및 ThumbnailUrl선택적 Height 값이 포함됩니다. 는 패턴과 일치해야 FileUrl 하며 최대 2,000자일 ^(https://|s3://).+$ 수 있습니다. 최대 미디어 파일 크기는 100MB입니다.

지원되는 미디어 형식, 전송 옵션 및 S3 미리 서명된 URLsRCS 파일 메시지 전송.

카드 수준 제안

CardContent.Suggestions 배열에 포함시켜 리치 카드에 최대 4개의 제안을 연결할 수 있습니다. 카드 수준 제안은 카드 콘텐츠 바로 아래에 표시됩니다.

카드 수준 제안 외에도 RcsMessageContent 구조의 최상위 Suggestions 배열에 최대 11개의 메시지 수준 제안을 포함할 수 있습니다. 메시지 수준 제안은 전체 메시지 아래에 영구 칩으로 표시됩니다.

제안 유형의 전체 목록(Reply, , OpenUrl, RequestLocation, DialPhone ShowLocation및 포함CreateCalendarEvent)은 섹션을 참조하세요RCS 제안 구성.

RcsMessageContent 구조

다음 JSON은 독립형 리치 카드의 RcsMessageContent 파라미터 구조를 보여줍니다. 이 JSON을 AWSCLI의 --rcs-message-content 파라미터에 문자열로 전달하거나 SDK의 RcsMessageContent 파라미터로 전달합니다.

{
  "Content": {
    "RichCard": {
      "StandaloneCard": {
        "CardOrientation": "VERTICAL",
        "CardContent": {
          "Title": "Your card title",
          "Description": "Additional details about the card content.",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Confirm",
                "PostbackData": "confirm_action"
              }
            },
            {
              "OpenUrl": {
                "Text": "View details",
                "PostbackData": "view_details",
                "Url": "https://www.example.com/details"
              }
            }
          ]
        }
      }
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Help",
        "PostbackData": "help_menu"
      }
    }
  ]
}

이 구조에서:

리치 카드 전송

SendRcsMessage API 작업을 사용하여 리치 카드를 전송합니다. 풀 또는 AWSRCS 에이전트를 로 지정--origination-identity하고 리치 카드 JSON 구조를 --rcs-message-content 파라미터로 전달합니다.

교차 플랫폼 렌더링

리치 카드 렌더링은 Android 디바이스와 iOS 디바이스에 따라 다릅니다. 일관된 결과를 얻으려면 다음 권장 사항을 따르세요.

리치 카드 한도