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

RCS リッチカードの送信

リッチカードは、メディア、テキスト、および推奨されるアクションを 1 つの構造化メッセージに結合します。受信者は、メッセージングクライアントでカードをネイティブ UI 要素として認識し、アプリのようなエクスペリエンスを提供します。リッチカードを使用して、製品の詳細、予約の確認、プロモーションオファーなど、やり取りを促す情報を表示します。

複数のカードをスクロール可能なセットにグループ化するには、「」を参照してくださいRCS カルーセルの送信。

リッチカードを使用するタイミング

リッチカードは、インタラクティブな要素を含むビジュアルレイアウトの恩恵を受けるメッセージに適しています。一般的ユースケースには以下が含まれます。

メッセージにオプションの提案を含むテキストのみが必要な場合は、RCS テキストメッセージの送信代わりに を使用します。カード構造を追加せずにファイルを送信する必要がある場合は、「」を参照してくださいRCS ファイルメッセージの送信。

リッチカードコンポーネント

スタンドアロンのリッチカードは、次のコンポーネントで構成されます。ではMedia、、Title、または の少なくとも 1 つDescriptionが必要ですCardContent。

カードの向き

CardOrientation フィールドは、メディアコンテンツとテキストコンテンツのレイアウト関係を制御します。このフィールドは必須です。

メディアと高さ

Media オブジェクトには、 FileUrl (必須）、オプションの ThumbnailUrl、およびオプションの Height 値が含まれます。はパターンと一致するFileUrl必要があり、最大 2,000 文字に^(https://|s3://).+$することができます。最大メディアファイルサイズは 100 MB です。

サポートされているメディア形式、配信オプション、および S3 署名付き URLs「」を参照してくださいRCS ファイルメッセージの送信。

カードレベルの提案

CardContent.Suggestions 配列に含めることで、リッチカードに最大 4 つの候補をアタッチできます。カードレベルの提案は、カードコンテンツのすぐ下に表示されます。

カードレベルの提案に加えて、RcsMessageContent構造の最上位Suggestions配列に最大 11 個のメッセージレベルの提案を含めることができます。メッセージレベルの提案は、メッセージ全体の下に永続的チップとして表示されます。

提案タイプ (Reply、、OpenUrl、、DialPhone、 を含むCreateCalendarEvent) ShowLocationの完全なリストについてはRequestLocation、「」を参照してくださいRCS の提案の設定。

RcsMessageContent 構造

次の JSON は、スタンドアロンのリッチカードの RcsMessageContentパラメータの構造を示しています。この JSON を CLI の --rcs-message-contentパラメータに文字列として、または SDK AWSの 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 デバイスによって異なります。一貫した結果を得るには、次の推奨事項に従ってください。

リッチカードの制限