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

Una tarjeta enriquecida combina contenido multimedia, texto y acciones sugeridas en un único mensaje estructurado. Los destinatarios ven la tarjeta como un elemento de interfaz de usuario nativo en su cliente de mensajería, lo que proporciona una experiencia similar a la de una aplicación. Utilice tarjetas enriquecidas para presentar información que fomente la interacción, como detalles de productos, confirmaciones de reservas u ofertas promocionales.

**importante**  
Puede utilizar la mensajería multimedia enriquecida con RCS (incluidas las tarjetas enriquecidas) en todos los países en los que se admite el RCS. Para obtener más información, consulte [Envío de mensajes RCS enriquecidos](rcs-rich-messaging.md).

Para agrupar varias cartas en un conjunto desplazable, consulte. [Envío de carruseles RCS](rcs-carousels.md)

**Topics**
+ [Cuándo usar una carta rica](#rcs-rich-cards-when)
+ [Componentes de tarjetas enriquecidos](#rcs-rich-cards-components)
+ [Orientación de la tarjeta](#rcs-rich-cards-orientation)
+ [Medios y alturas](#rcs-rich-cards-media)
+ [Card-level sugerencias](#rcs-rich-cards-suggestions)
+ [RcsMessageContent estructura](#rcs-rich-cards-structure)
+ [Envío de una carta enriquecida](#rcs-rich-cards-sending)
+ [Cross-platform renderización](#rcs-rich-cards-rendering)
+ [Límites de cartas enriquecidas](#rcs-rich-cards-limits)

## Cuándo usar una carta rica
<a name="rcs-rich-cards-when"></a>

Las tarjetas enriquecidas son ideales para los mensajes que se benefician de un diseño visual con elementos interactivos. Los casos de uso comunes incluyen:
+ Exhibiciones de **productos: muestra** una imagen, el nombre del producto, el precio y un botón de compra en un solo mensaje.
+ **Confirmaciones de reserva**: muestra los detalles de la reserva con un enlace al calendario y un botón de indicaciones.
+ **Detalles de la cita**: fecha, hora, ubicación actuales y opciones para confirmar o reprogramar.
+ **Ofertas promocionales**: destaque un acuerdo con los medios de comunicación y haga un llamado a la acción claro.

Si tu mensaje solo requiere texto con sugerencias opcionales, usa una [Envío de mensajes de texto RCS](rcs-text-messages.md) en su lugar. Si necesita enviar un archivo sin una estructura de tarjeta adicional, consulte[Envío de mensajes de archivos RCS](rcs-file-messages.md).

## Componentes de tarjetas enriquecidos
<a name="rcs-rich-cards-components"></a>

Una tarjeta enriquecida independiente consta de los siguientes componentes. Al menos uno de`Media`,`Title`, o `Description` es obligatorio en`CardContent`.


**Componentes de tarjetas enriquecidas**  

| Componente | Obligatorio | Description (Descripción) | 
| --- | --- | --- | 
| Media | No | Imagen, GIF o vídeo que se muestra en la tarjeta. Los formatos compatibles incluyen JPEG, PNG, GIF y MP4. El tamaño de archivo máximo es de 100 MB. | 
| Title | No | Un título corto para la tarjeta. Máximo 200 caracteres. | 
| Description | No | El cuerpo del texto proporciona detalles adicionales. Máximo 2000 caracteres. | 
| Suggestions | No | Se adjuntan a la tarjeta hasta 4 acciones o respuestas sugeridas. Consulte [Configuración de sugerencias de RCS](rcs-suggestions.md). | 

## Orientación de la tarjeta
<a name="rcs-rich-cards-orientation"></a>

El `CardOrientation` campo controla la relación de diseño entre el contenido multimedia y el contenido textual. Este campo es obligatorio.

`VERTICAL`  
El contenido multimedia aparece en la parte superior de la tarjeta con el título, la descripción y las sugerencias que aparecen a continuación. La orientación vertical es la opción predeterminada recomendada para la compatibilidad multiplataforma.

`HORIZONTAL`  
El contenido multimedia se muestra en el lado izquierdo o derecho de la tarjeta con el contenido de texto al lado. El área multimedia tiene un ancho fijo de 128 píxeles independientes de la densidad (DP). Se utiliza `ThumbnailImageAlignment` para controlar si el contenido multimedia aparece a la izquierda o a la derecha.

**aviso**  
La orientación horizontal provoca el truncamiento de la imagen en los dispositivos iOS. Utilice la `VERTICAL` orientación para las implementaciones multiplataforma.

## Medios y alturas
<a name="rcs-rich-cards-media"></a>

El `Media` objeto contiene un `Height` valor `FileUrl` (obligatorio)`ThumbnailUrl`, uno opcional y otro opcional. `FileUrl`Debe coincidir con el patrón `^(https://|s3://).+$` y puede tener un máximo de 2000 caracteres. El tamaño máximo del archivo multimedia es de 100 MB.

Para obtener más información sobre los formatos multimedia compatibles, las opciones de entrega y las URL prefirmadas de S3, consulte. [Envío de mensajes de archivos RCS](rcs-file-messages.md)


**Valores de altura del soporte**  

| Alto | Tamaño | Description (Descripción) | 
| --- | --- | --- | 
| SHORT | 112 DP | Pantalla compacta. Úselo para miniaturas o cuando el contenido del texto sea el foco principal. | 
| MEDIUM | 168 DP | Pantalla balanceada. Predeterminado recomendado para la mayoría de los casos de uso. | 
| TALL | 264 DP | Área máxima de visualización. Úselo cuando los medios sean el contenido principal. | 

**nota**  
iOS renderiza todos los valores de altura del soporte de forma idéntica, ignorando el ajuste de altura especificado. Úselo `TALL` para maximizar el área de visualización en los dispositivos Android y, al mismo tiempo, mantener una representación aceptable en iOS.

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

Puedes adjuntar hasta 4 sugerencias a una tarjeta enriquecida si las incluyes en la `CardContent.Suggestions` matriz. Card-level las sugerencias aparecen directamente debajo del contenido de la tarjeta.

Además de las sugerencias a nivel de tarjeta, puedes incluir hasta 11 sugerencias a nivel de mensaje en la matriz de nivel superior de la estructura`Suggestions`. `RcsMessageContent` Message-level las sugerencias aparecen como fichas persistentes debajo de todo el mensaje.

Para ver la lista completa de tipos de sugerencias (incluidos `Reply` `OpenUrl``DialPhone`,`ShowLocation`,`RequestLocation`, y`CreateCalendarEvent`), consulte[Configuración de sugerencias de RCS](rcs-suggestions.md).

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

El siguiente JSON muestra la estructura del `RcsMessageContent` parámetro de una tarjeta enriquecida independiente. Pase este JSON como cadena al `--rcs-message-content` parámetro de la AWS CLI o como `RcsMessageContent` parámetro del 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"
      }
    }
  ]
}
```

En esta estructura:
+ `Content.RichCard.StandaloneCard`contiene la definición de la tarjeta.
+ `CardOrientation`es obligatorio y acepta `VERTICAL` o`HORIZONTAL`.
+ `ThumbnailImageAlignment`es opcional y solo se aplica a las tarjetas horizontales.
+ `CardContent.Suggestions`contiene sugerencias a nivel de tarjeta (máximo 4).
+ La `Suggestions` matriz de nivel superior contiene sugerencias a nivel de mensaje (máximo 11).

## Envío de una carta enriquecida
<a name="rcs-rich-cards-sending"></a>

Usa la acción `SendRcsMessage` de la API para enviar una tarjeta enriquecida. Especifica tu grupo o agente de AWS RCS como parámetro `--origination-identity` y pasa la estructura JSON de tipo rich card como `--rcs-message-content` parámetro.

## Cross-platform renderización
<a name="rcs-rich-cards-rendering"></a>

El procesamiento de tarjetas enriquecidas varía entre los dispositivos Android e iOS. Siga estas recomendaciones para obtener resultados uniformes:


**Cross-platform recomendaciones**  

| Recomendación | Motivo | 
| --- | --- | 
| Utilice VERTICAL la orientación | La orientación horizontal provoca el truncamiento de la imagen en iOS. | 
| Usa TALL la altura del soporte | iOS ignora el valor de altura. TALLmaximiza el área de visualización en Android. | 
| Mantenga el título en 3 líneas o menos | Evita el recorte de contenido multimedia en iOS con la configuración de accesibilidad habilitada. | 
| Usa OpenUrl sugerencias para los enlaces | No se puede hacer clic en las URL del texto de la descripción en ninguna de las plataformas. | 
| Prueba archivos GIF en iOS | Confirme que el primer fotograma estático se renderiza de forma aceptable. | 

## Límites de cartas enriquecidas
<a name="rcs-rich-cards-limits"></a>


**Límites de cartas enriquecidas**  

| Recurso | Límite | 
| --- | --- | 
| Longitud del título | 200 caracteres | 
| Longitud de la descripción | 2000 caracteres | 
| Card-level sugerencias | 4 por tarjeta | 
| Message-level sugerencias | 11 por mensaje | 
| Carga útil total de mensajes | 250 KB | 
| Tamaño del archivo multimedia | 100 MB | 
| FileUrllongitud | 2000 caracteres |