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
<a name="rcs-rich-cards"></a>

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.

**Important**  
Vous pouvez utiliser la messagerie multimédia RCS (y compris les cartes riches) dans tous les pays où le RCS est pris en charge. Pour de plus amples informations, veuillez consulter [Envoi de messages RCS enrichis](rcs-rich-messaging.md).

Pour regrouper plusieurs cartes dans un ensemble défilant, voir. [Envoi de carrousels RCS](rcs-carousels.md)

**Topics**
+ [Quand utiliser une carte riche](#rcs-rich-cards-when)
+ [Composants de cartes riches](#rcs-rich-cards-components)
+ [Orientation de la carte](#rcs-rich-cards-orientation)
+ [Médias et hauteurs](#rcs-rich-cards-media)
+ [Card-level suggestions](#rcs-rich-cards-suggestions)
+ [RcsMessageContent structure](#rcs-rich-cards-structure)
+ [Envoyer une carte riche](#rcs-rich-cards-sending)
+ [Cross-platform rendu](#rcs-rich-cards-rendering)
+ [Limites des cartes Rich](#rcs-rich-cards-limits)

## Quand utiliser une carte riche
<a name="rcs-rich-cards-when"></a>

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 :
+ **Vitrines de produits** : affichez une image, le nom du produit, son prix et un bouton d'achat dans un seul message.
+ **Confirmations de réservation : affichez les** détails de la réservation à l'aide d'un lien vers le calendrier et d'un bouton d'itinéraire.
+ **Détails du rendez-vous** : date, heure, lieu actuels et options de confirmation ou de report.
+ **Offres promotionnelles** : mettez en avant un accord avec les médias et un appel à l'action clair.

Si votre message ne nécessite que du texte avec des suggestions facultatives, utilisez [Envoi de SMS RCS](rcs-text-messages.md) plutôt un. Si vous devez envoyer un fichier sans structure de carte supplémentaire, consultez[Envoi de messages sous forme de fichier RCS](rcs-file-messages.md).

## Composants de cartes riches
<a name="rcs-rich-cards-components"></a>

Une carte riche autonome comprend les composants suivants. Au moins l'un des `Media``Title`, ou `Description` est requis dans`CardContent`.


**Composants de cartes riches**  

| Composant | Obligatoire | Description | 
| --- | --- | --- | 
| Media | Non | Image, GIF ou vidéo affiché sur la carte. Les formats pris en charge incluent JPEG, PNG, GIF et MP4. La taille maximale du fichier est de 100 Mo. | 
| Title | Non | Un court titre pour la carte. 200 caractères maximum. | 
| Description | Non | Le corps du texte fournit des détails supplémentaires. 2 000 caractères maximum. | 
| Suggestions | Non | Jusqu'à 4 actions ou réponses suggérées jointes à la carte. Consultez [Configuration des suggestions RCS](rcs-suggestions.md). | 

## Orientation de la carte
<a name="rcs-rich-cards-orientation"></a>

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

`VERTICAL`  
Le contenu multimédia s'affiche en haut de la carte avec le titre, la description et les suggestions ci-dessous. L'orientation verticale est la valeur par défaut recommandée pour la compatibilité multiplateforme.

`HORIZONTAL`  
Le contenu multimédia s'affiche sur le côté gauche ou droit de la carte avec du texte à côté. La zone multimédia a une largeur fixe de 128 pixels indépendants de la densité (DP). Permet `ThumbnailImageAlignment` de contrôler si le média apparaît à gauche ou à droite.

**Avertissement**  
L'orientation horizontale entraîne la troncature de l'image sur les appareils iOS. Utilisez l'`VERTICAL`orientation pour les déploiements multiplateformes.

## Médias et hauteurs
<a name="rcs-rich-cards-media"></a>

L'`Media`objet contient une valeur `FileUrl` (obligatoire), une valeur facultative `ThumbnailUrl` et une `Height` valeur facultative. `FileUrl`Il 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](rcs-file-messages.md)


**Valeurs de hauteur du support**  

| Height | Size | Description | 
| --- | --- | --- | 
| SHORT | 112 DPS | Écran compact. À utiliser pour les miniatures ou lorsque le contenu du texte est le principal objectif. | 
| MEDIUM | 168 DPS | Affichage équilibré. Valeur par défaut recommandée pour la plupart des cas d'utilisation. | 
| TALL | 264 DPS | Zone d'affichage maximale. À utiliser lorsque le contenu principal est le contenu multimédia. | 

**Note**  
iOS affiche toutes les valeurs de hauteur du support de manière identique, en ignorant le paramètre de hauteur spécifié. `TALL`À utiliser pour optimiser la zone d'affichage sur les appareils Android tout en maintenant un rendu acceptable sur iOS.

## Card-level suggestions
<a name="rcs-rich-cards-suggestions"></a>

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 structure`Suggestions`. `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 `Reply``OpenUrl`,`DialPhone`,`ShowLocation`,`RequestLocation`, et`CreateCalendarEvent`), voir[Configuration des suggestions RCS](rcs-suggestions.md).

## RcsMessageContent structure
<a name="rcs-rich-cards-structure"></a>

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 :
+ `Content.RichCard.StandaloneCard`contient la définition de la carte.
+ `CardOrientation`est obligatoire et accepte `VERTICAL` ou`HORIZONTAL`.
+ `ThumbnailImageAlignment`est facultatif et s'applique uniquement aux cartes horizontales.
+ `CardContent.Suggestions`contient des suggestions au niveau de la carte (maximum 4).
+ Le `Suggestions` tableau de niveau supérieur contient des suggestions au niveau des messages (11 au maximum).

## Envoyer une carte riche
<a name="rcs-rich-cards-sending"></a>

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
<a name="rcs-rich-cards-rendering"></a>

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


**Cross-platform recommandations**  

| Recommendation | Raison | 
| --- | --- | 
| VERTICALOrientation de l'utilisation | L'orientation horizontale entraîne la troncature de l'image sur iOS. | 
| Utiliser la hauteur du TALL support | iOS ignore la valeur de hauteur. TALLmaximise la zone d'affichage sur Android. | 
| Limitez le titre à 3 lignes ou moins | Empêche le recadrage du contenu multimédia sur iOS lorsque les paramètres d'accessibilité sont activés. | 
| Utiliser OpenUrl des suggestions de liens | Les URL figurant dans le texte de description ne sont cliquables sur aucune des plateformes. | 
| Testez les fichiers GIF sur iOS | Vérifiez que le rendu de la première image statique est acceptable. | 

## Limites des cartes Rich
<a name="rcs-rich-cards-limits"></a>


**Limites des cartes Rich**  

| Ressource | Limite | 
| --- | --- | 
| Longueur du titre | 200 caractères | 
| Longueur de la description | 2 000 caractères | 
| Card-level suggestions | 4 par carte | 
| Message-level suggestions | 11 par message | 
| Charge utile totale des messages | 250 KO | 
| Taille du fichier multimédia | 100 Mo | 
| FileUrllongueur | 2 000 caractères |