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 carrousels RCS

Dans AWS End User Messaging, un message en forme de carrousel affiche 2 à 10 cartes enrichies sur une bande défilant horizontalement. Les destinataires peuvent faire défiler les cartes et choisir des suggestions sur des cartes individuelles pour passer à l'action. Avec les carrousels, vous pouvez créer des expériences conversationnelles et interactives telles que des catalogues de produits, des menus de services, des comparaisons de plans et des listes de points de vente.

Les carrousels utilisent le même modèle de contenu de carte que les cartes riches autonomes (voirEnvoi de cartes RCS Rich), mais les cartes de carrousel utilisent toujours une disposition verticale et ne prennent pas en charge la hauteur du support. TALL

Quand utiliser un carrousel

Utilisez un carrousel lorsque vous souhaitez que les destinataires parcourent et comparent plusieurs articles du même type. Cas d’utilisation courants :

Si vous devez afficher un seul élément avec du contenu enrichi, utilisez plutôt une carte riche autonome. Pour en savoir plus, consultez Envoi de cartes RCS Rich.

Structure du carrousel

Vous définissez un carrousel dans l'Content.Carouselobjet dans le RcsMessageContent paramètre d'une SendRcsMessage demande. L'objet du carrousel contient deux champs obligatoires :

Valeurs de largeur des cartes

Champs de contenu de la carte

Chaque objet de carte du CardContents tableau prend en charge les champs suivants :

Suggestions de cartes et suggestions extérieures

Les messages du carrousel prennent en charge deux niveaux de suggestions :

Utilisez les suggestions extérieures pour les actions de navigation qui s'appliquent à l'ensemble du message, telles que « Retour au menu », « Aide » ou « Terminé la navigation ». Évitez de dupliquer les actions au niveau de la carte dans la liste des puces externes.

Hauteur et troncature de la carte

Toutes les cartes d'un carrousel sont mises à l'échelle pour correspondre à la hauteur de la carte la plus haute. Si le contenu d'une carte dépasse la hauteur d'affichage maximale, le client de messagerie tronque le contenu dans l'ordre suivant :

Lorsque la troncature est appliquée, un indicateur « Plus » apparaît afin que le destinataire puisse étendre la carte en mode plein écran.

Ratios d'aspect des médias

Le rapport hauteur/largeur du support de carte dépend de la combinaison de la largeur de la carte et de la hauteur du support.

Structure JSON du carrousel

Le JSON suivant montre la structure du RcsMessageContent paramètre d'un message de carrousel :

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

Cette valeur est transmise sous forme de chaîne JSON dans le --rcs-message-content paramètre (CLI) ou le RcsMessageContent paramètre (SDK). Vous spécifiez également --destination-phone-number et --origination-identity (un pool ou un agent RCS) dans la send-rcs-message demande.

Limites de carrousel

Pour le format multimédia et les détails de livraison, voirEnvoi de messages sous forme de fichier RCS.