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

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.

Para agrupar varias cartas en un conjunto desplazable, consulte. Envío de carruseles RCS

Cuándo usar una carta rica

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:

Si tu mensaje solo requiere texto con sugerencias opcionales, usa una Envío de mensajes de texto RCS en su lugar. Si necesita enviar un archivo sin una estructura de tarjeta adicional, consulteEnvío de mensajes de archivos RCS.

Componentes de tarjetas enriquecidos

Una tarjeta enriquecida independiente consta de los siguientes componentes. Al menos uno deMedia,Title, o Description es obligatorio enCardContent.

Orientación de la tarjeta

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

Medios y alturas

El Media objeto contiene un Height valor FileUrl (obligatorio)ThumbnailUrl, uno opcional y otro opcional. FileUrlDebe 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

Card-level sugerencias

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 estructuraSuggestions. 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 OpenUrlDialPhone,ShowLocation,RequestLocation, yCreateCalendarEvent), consulteConfiguración de sugerencias de RCS.

RcsMessageContent estructura

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:

Envío de una carta enriquecida

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

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

Límites de cartas enriquecidas