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

RCS 캐러셀 전송

AWSEnd User Messaging의 캐러셀 메시지는 가로로 스크롤 가능한 스트립에 2~10개의 리치 카드를 표시합니다. 수신자는 카드를 스크롤하고 개별 카드에 대한 제안을 선택하여 조치를 취할 수 있습니다. 캐러셀을 사용하면 제품 카탈로그, 서비스 메뉴, 계획 비교, 위치 목록과 같은 대화형 경험을 만들 수 있습니다.

캐러셀은 독립형 리치 카드와 동일한 카드 콘텐츠 모델을 공유하지만( 참조RCS 리치 카드 전송), 캐러셀 카드는 항상 수직 레이아웃을 사용하며 TALL 미디어 높이를 지원하지 않습니다.

캐러셀을 사용해야 하는 경우

수신자가 동일한 유형의 여러 항목을 검색하고 비교하도록 하려면 캐러셀을 사용합니다. 일반적인 사용 사례는 다음과 같습니다.

리치 콘텐츠가 포함된 단일 항목을 표시해야 하는 경우 독립 실행형 리치 카드를 대신 사용합니다. 자세한 내용은 RCS 리치 카드 전송을 참조하세요.

캐러셀 구조

SendRcsMessage 요청의 RcsMessageContent 파라미터 내에서 Content.Carousel 객체에 캐러셀을 정의합니다. 캐러셀 객체에는 두 개의 필수 필드가 있습니다.

카드 너비 값

카드 콘텐츠 필드

CardContents 배열의 각 카드 객체는 다음 필드를 지원합니다.

카드 제안 및 외부 제안

캐러셀 메시지는 두 가지 수준의 제안을 지원합니다.

"메뉴로 돌아가기", "도움말" 또는 "검색 완료"와 같이 전체 메시지에 적용되는 탐색 작업에 대한 외부 제안을 사용합니다. 외부 칩 목록에서 카드 수준 작업을 복제하지 마세요.

카드 높이 및 잘림

캐러셀의 모든 카드는 가장 높은 카드의 높이에 맞게 조정됩니다. 카드의 콘텐츠가 최대 표시 높이를 초과하는 경우 메시징 클라이언트는 다음 순서로 콘텐츠를 잘라냅니다.

잘림이 적용되면 수신자가 카드를 전체 화면 보기로 확장할 수 있도록 "더 보기" 표시기가 나타납니다.

미디어 종횡비

카드 미디어의 종횡비는 카드 너비와 미디어 높이의 조합에 따라 달라집니다.

캐러셀 JSON 구조

다음 JSON은 캐러셀 메시지에 대한 RcsMessageContent 파라미터의 구조를 보여줍니다.

{
  "Content": {
    "Carousel": {
      "CardWidth": "SMALL | MEDIUM",
      "CardContents": [
        {
          "Title": "Card title (max 200 chars)",
          "Description": "Card description (max 2000 chars)",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "SHORT | MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Button label (max 25 chars)",
                "PostbackData": "callback_data"
              }
            }
          ]
        }
      ]
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Outer chip label",
        "PostbackData": "outer_callback"
      }
    }
  ]
}

이 값은 --rcs-message-content 파라미터(CLI) 또는 RcsMessageContent 파라미터(SDK)에서 JSON 문자열로 전달됩니다. send-rcs-message 요청에서 --destination-phone-number 및 --origination-identity (풀 또는 RCS 에이전트)도 지정합니다.

캐러셀 제한

미디어 형식 및 전송 세부 정보는 섹션을 참조하세요RCS 파일 메시지 전송.