Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi de cartes RCS Rich

Une carte enrichie combine du contenu multimédia, du texte et des suggestions d'actions dans un message structuré unique. Les destinataires considèrent la carte comme un élément d'interface utilisateur natif de leur client de messagerie, offrant une expérience similaire à celle d'une application. Utilisez des fiches enrichies pour présenter des informations qui encouragent l'interaction, telles que les détails des produits, les confirmations de réservation ou les offres promotionnelles.

Pour regrouper plusieurs cartes dans un ensemble défilant, voir. Envoi de carrousels RCS

Quand utiliser une carte riche

Les cartes riches conviennent parfaitement aux messages qui bénéficient d'une mise en page visuelle avec des éléments interactifs. Cas d’utilisation courants :

Si votre message ne nécessite que du texte avec des suggestions facultatives, utilisez Envoi de SMS RCS plutôt un. Si vous devez envoyer un fichier sans structure de carte supplémentaire, consultezEnvoi de messages sous forme de fichier RCS.

Composants de cartes riches

Une carte riche autonome comprend les composants suivants. Au moins l'un des MediaTitle, ou Description est requis dansCardContent.

Orientation de la carte

Le CardOrientation champ contrôle la relation de mise en page entre le contenu multimédia et le contenu textuel. Ce champ est obligatoire.

Médias et hauteurs

L'Mediaobjet contient une valeur FileUrl (obligatoire), une valeur facultative ThumbnailUrl et une Height valeur facultative. FileUrlIl doit correspondre au modèle ^(https://|s3://).+$ et peut comporter un maximum de 2 000 caractères. La taille maximale du fichier multimédia est de 100 Mo.

Pour plus de détails sur les formats multimédia pris en charge, les options de diffusion et les URL présignées S3, consultez. Envoi de messages sous forme de fichier RCS

Card-level suggestions

Vous pouvez joindre jusqu'à 4 suggestions à une carte riche en les incluant dans le CardContent.Suggestions tableau. Card-level les suggestions apparaissent directement sous le contenu de la carte.

Outre les suggestions au niveau des cartes, vous pouvez inclure jusqu'à 11 suggestions au niveau du message dans le tableau de niveau supérieur de la structureSuggestions. RcsMessageContent Message-level les suggestions apparaissent sous forme de puces persistantes sous la totalité du message.

Pour la liste complète des types de suggestions (y compris ReplyOpenUrl,DialPhone,ShowLocation,RequestLocation, etCreateCalendarEvent), voirConfiguration des suggestions RCS.

RcsMessageContent structure

Le JSON suivant montre la structure du RcsMessageContent paramètre pour une carte riche autonome. Transmettez ce JSON sous forme de chaîne au --rcs-message-content paramètre dans la AWS CLI ou sous forme de RcsMessageContent paramètre dans le SDK.

{
  "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"
      }
    }
  ]
}

Dans cette structure :

Envoyer une carte riche

Utilisez l'action SendRcsMessage API pour envoyer une carte riche. Spécifiez votre pool ou votre agent AWS RCS en tant que paramètre --origination-identity et transmettez la structure JSON de la carte enrichie en tant que --rcs-message-content paramètre.

Cross-platform rendu

Le rendu riche des cartes varie entre les appareils Android et iOS. Suivez ces recommandations pour obtenir des résultats cohérents :

Limites des cartes Rich