翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

RCS カルーセルの送信

AWSエンドユーザーメッセージングのカルーセルメッセージは、2～10 個のリッチカードを水平にスクロール可能なストライプに表示します。受信者はカードをスクロールし、個々のカードの提案を選択してアクションを実行できます。カルーセルを使用すると、製品カタログ、サービスメニュー、プラン比較、ロケーションリストなどの会話型およびインタラクティブなエクスペリエンスを作成できます。

カルーセルはスタンドアロンのリッチカードと同じカードコンテンツモデルを共有しますが (「」を参照RCS リッチカードの送信)、カルーセルカードは常に垂直レイアウトを使用し、TALLメディアの高さをサポートしていません。

カルーセルを使用するタイミング

受信者が同じタイプの複数の項目を参照して比較する場合は、カルーセルを使用します。一般的ユースケースには以下が含まれます。

リッチコンテンツを含む単一の項目を表示する必要がある場合は、代わりにスタンドアロンのリッチカードを使用します。詳細については、「RCS リッチカードの送信」を参照してください。

カルーセル構造

SendRcsMessage リクエストの RcsMessageContentパラメータ内の Content.Carousel オブジェクトでカルーセルを定義します。カルーセルオブジェクトには 2 つの必須フィールドがあります。

カード幅の値

カードコンテンツフィールド

CardContents 配列内の各カードオブジェクトは、次のフィールドをサポートしています。

カード提案と外部提案

カルーセルメッセージは、次の 2 つのレベルの提案をサポートします。

「メニューに戻る」、「ヘルプ」、「閲覧完了」など、メッセージ全体に適用されるナビゲーションアクションには外部提案を使用します。外部チップリストでカードレベルのアクションを複製することは避けてください。

カードの高さと切り捨て

カルーセル内のすべてのカードは、最も高いカードの高さに合わせてスケーリングされます。カードの内容が最大表示高さを超えると、メッセージングクライアントは次の順序でコンテンツを切り捨てます。

切り捨てが適用されると、受取人がカードを全画面表示に展開できるように、「詳細」インジケータが表示されます。

メディアアスペクト比

カードメディアのアスペクト比は、カードの幅とメディアの高さの組み合わせによって異なります。

カルーセル 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 ファイルメッセージの送信。