Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.

Envío de carruseles RCS

Un mensaje en forma de carrusel en AWS End User Messaging muestra de 2 a 10 tarjetas enriquecidas en una franja desplazable horizontalmente. Los destinatarios pueden desplazarse por las tarjetas y elegir sugerencias en cada una de ellas para realizar alguna acción. Con los carruseles, puede crear experiencias conversacionales e interactivas, como catálogos de productos, menús de servicios, comparaciones de planes y listados de ubicaciones.

Los carruseles comparten el mismo modelo de contenido de tarjetas que las tarjetas enriquecidas independientes (consulteEnvío de tarjetas RCS Rich), pero las tarjetas de carrusel siempre utilizan un diseño vertical y no admiten la altura del soporte. TALL

¿Cuándo usar un carrusel

Usa un carrusel cuando quieras que los destinatarios busquen y comparen varios artículos del mismo tipo. Los casos de uso comunes incluyen:

Si necesitas mostrar un solo artículo con contenido enriquecido, utiliza una tarjeta enriquecida independiente en su lugar. Para obtener más información, consulte Envío de tarjetas RCS Rich.

Estructura de carrusel

El carrusel se define en el Content.Carousel objeto dentro del RcsMessageContent parámetro de una solicitud. SendRcsMessage El objeto de carrusel contiene dos campos obligatorios:

Valores de ancho de la tarjeta

Campos de contenido de tarjetas

Cada objeto de tarjeta de la CardContents matriz admite los siguientes campos:

Sugerencias de tarjetas y sugerencias externas

Los mensajes en carrusel admiten dos niveles de sugerencias:

Utiliza sugerencias externas para las acciones de navegación que se apliquen a todo el mensaje, como «Volver al menú», «Ayuda» o «Terminé de navegar». Evita duplicar las acciones a nivel de las cartas en la lista de fichas externas.

Altura y truncamiento de la tarjeta

Todas las cartas de un carrusel se escalan para que coincidan con la altura de la carta más alta. Si el contenido de una tarjeta supera la altura máxima de visualización, el cliente de mensajería trunca el contenido en el siguiente orden:

Cuando se aplica el truncamiento, aparece el indicador «Más» para que el destinatario pueda ampliar la tarjeta para verla a pantalla completa.

Relaciones de aspecto multimedia

La relación de aspecto del soporte de la tarjeta depende de la combinación del ancho de la tarjeta y la altura del soporte.

Estructura JSON de carrusel

El siguiente JSON muestra la estructura del RcsMessageContent parámetro de un mensaje de carrusel:

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

Este valor se pasa como una cadena JSON en el --rcs-message-content parámetro (CLI) o el RcsMessageContent parámetro (SDK). También especificas --destination-phone-number and --origination-identity (un grupo o un agente de RCS) en la send-rcs-message solicitud.

Límites de carrusel

Para obtener información sobre el formato multimedia y la entrega, consulteEnvío de mensajes de archivos RCS.