As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

# Enviando cartões ricos em RCS
<a name="rcs-rich-cards"></a>

Um rich card combina mídia, texto e ações sugeridas em uma única mensagem estruturada. Os destinatários veem o cartão como um elemento de interface de usuário nativo em seu cliente de mensagens, proporcionando uma experiência semelhante à de um aplicativo. Use cartões avançados para apresentar informações que incentivem a interação, como detalhes do produto, confirmações de reservas ou ofertas promocionais.

**Importante**  
Você pode usar o RCS rich media messaging (incluindo rich cards) em todos os países em que o RCS é suportado. Para obter mais informações, consulte [Enviando mensagens ricas de RCS](rcs-rich-messaging.md).

Para agrupar várias cartas em um conjunto rolável, consulte. [Enviando carrosséis RCS](rcs-carousels.md)

**Topics**
+ [Quando usar um rich card](#rcs-rich-cards-when)
+ [Componentes de cartões avançados](#rcs-rich-cards-components)
+ [Orientação do cartão](#rcs-rich-cards-orientation)
+ [Mídia e alturas](#rcs-rich-cards-media)
+ [Card-level sugestões](#rcs-rich-cards-suggestions)
+ [RcsMessageContent estrutura](#rcs-rich-cards-structure)
+ [Enviando um cartão rico](#rcs-rich-cards-sending)
+ [Cross-platform renderização](#rcs-rich-cards-rendering)
+ [Limites do Rich Card](#rcs-rich-cards-limits)

## Quando usar um rich card
<a name="rcs-rich-cards-when"></a>

Os cartões avançados são adequados para mensagens que se beneficiam de um layout visual com elementos interativos. Entre os casos de uso comuns estão:
+ **Vitrines de produtos**: exiba uma imagem, nome do produto, preço e um botão de compra em uma mensagem.
+ **Confirmações de reserva**: mostre os detalhes da reserva com um link de calendário e um botão de direções.
+ **Detalhes do compromisso**: data, hora, local e opções atuais para confirmar ou reagendar.
+ **Ofertas promocionais**: destaque um acordo com a mídia e um claro apelo à ação.

Se sua mensagem exigir apenas texto com sugestões opcionais, use um [Enviando mensagens de texto RCS](rcs-text-messages.md) em vez disso. Se você precisar enviar um arquivo sem estrutura de cartão adicional, consulte[Enviando mensagens de arquivo RCS](rcs-file-messages.md).

## Componentes de cartões avançados
<a name="rcs-rich-cards-components"></a>

Um rich card independente consiste nos seguintes componentes. Pelo menos um dos`Media`,`Title`, ou `Description` é necessário em`CardContent`.


**Componentes de cartões avançados**  

| Componente | Obrigatório | Description | 
| --- | --- | --- | 
| Media | Não | Uma imagem, GIF ou vídeo exibido dentro do cartão. Os formatos compatíveis incluem JPEG, PNG, GIF e MP4. O tamanho máximo do arquivo é de 100 MB. | 
| Title | Não | Um pequeno título para o cartão. Máximo de 200 caracteres. | 
| Description | Não | Corpo do texto fornecendo detalhes adicionais. Máximo de 2.000 caracteres. | 
| Suggestions | Não | Até 4 ações ou respostas sugeridas anexadas ao cartão. Consulte [Configurando sugestões de RCS](rcs-suggestions.md). | 

## Orientação do cartão
<a name="rcs-rich-cards-orientation"></a>

O `CardOrientation` campo controla a relação do layout entre mídia e conteúdo de texto. Este campo é obrigatório.

`VERTICAL`  
A mídia é exibida na parte superior do cartão com título, descrição e sugestões abaixo. A orientação vertical é o padrão recomendado para compatibilidade entre plataformas.

`HORIZONTAL`  
A mídia é exibida no lado esquerdo ou direito do cartão com conteúdo de texto ao lado. A área de mídia tem uma largura fixa de 128 pixels independentes de densidade (DP). Use `ThumbnailImageAlignment` para controlar se a mídia aparece à esquerda ou à direita.

**Atenção**  
A orientação horizontal causa truncamento da imagem em dispositivos iOS. Use a `VERTICAL` orientação para implantações em várias plataformas.

## Mídia e alturas
<a name="rcs-rich-cards-media"></a>

O `Media` objeto contém um `Height` valor `FileUrl` (obrigatório)`ThumbnailUrl`, um opcional e um opcional. Eles `FileUrl` devem corresponder ao padrão `^(https://|s3://).+$` e podem ter no máximo 2.000 caracteres. O tamanho máximo do arquivo de mídia é 100 MB.

Para obter detalhes sobre formatos de mídia compatíveis, opções de entrega e URLs pré-assinados do S3, consulte. [Enviando mensagens de arquivo RCS](rcs-file-messages.md)


**Valores de altura da mídia**  

| Altura | Tamanho | Description | 
| --- | --- | --- | 
| SHORT | 112 DP | Tela compacta. Use para miniaturas ou quando o conteúdo do texto for o foco principal. | 
| MEDIUM | 168 DP | Tela balanceada. Padrão recomendado para a maioria dos casos de uso. | 
| TALL | 264 DP | Área máxima de exibição. Use quando a mídia for o conteúdo principal. | 

**nota**  
O iOS renderiza todos os valores de altura da mídia de forma idêntica, ignorando a configuração de altura especificada. Use `TALL` para maximizar a área de exibição em dispositivos Android e, ao mesmo tempo, manter a renderização aceitável no iOS.

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

Você pode anexar até 4 sugestões a um rich card incluindo-as na `CardContent.Suggestions` matriz. Card-level as sugestões aparecem diretamente abaixo do conteúdo do cartão.

Além das sugestões em nível de cartão, você pode incluir até 11 sugestões em nível de mensagem na matriz de nível superior da estrutura`Suggestions`. `RcsMessageContent` Message-level as sugestões aparecem como chips persistentes abaixo da mensagem inteira.

Para ver a lista completa dos tipos de sugestões (incluindo `Reply``OpenUrl`,`DialPhone`,`ShowLocation`,`RequestLocation`, e`CreateCalendarEvent`), consulte[Configurando sugestões de RCS](rcs-suggestions.md).

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

O JSON a seguir mostra a estrutura do `RcsMessageContent` parâmetro para um rich card independente. Passe esse JSON como uma string para o `--rcs-message-content` parâmetro na AWS CLI ou como parâmetro `RcsMessageContent` no 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"
      }
    }
  ]
}
```

Nessa estrutura:
+ `Content.RichCard.StandaloneCard`contém a definição do cartão.
+ `CardOrientation`é obrigatório e aceita `VERTICAL` ou`HORIZONTAL`.
+ `ThumbnailImageAlignment`é opcional e se aplica somente aos cartões horizontais.
+ `CardContent.Suggestions`contém sugestões em nível de cartão (máximo 4).
+ A `Suggestions` matriz de nível superior contém sugestões em nível de mensagem (máximo 11).

## Enviando um cartão rico
<a name="rcs-rich-cards-sending"></a>

Use a ação `SendRcsMessage` da API para enviar um rich card. Especifique seu pool ou agente AWS RCS como `--origination-identity` e passe a estrutura JSON do rich card como parâmetro. `--rcs-message-content`

## Cross-platform renderização
<a name="rcs-rich-cards-rendering"></a>

A renderização de Rich Card varia entre dispositivos Android e iOS. Siga estas recomendações para obter resultados consistentes:


**Cross-platform recomendações**  

| Recomendação | Motivo | 
| --- | --- | 
| Use a VERTICAL orientação | A orientação horizontal causa truncamento da imagem no iOS. | 
| Use a altura da TALL mídia | O iOS ignora o valor da altura. TALLmaximiza a área de exibição no Android. | 
| Mantenha o título em 3 linhas ou menos | Impede o corte de mídia no iOS com as configurações de acessibilidade ativadas. | 
| Use OpenUrl sugestões para links | Os URLs no texto da descrição não são clicáveis em nenhuma das plataformas. | 
| Teste a mídia GIF no iOS | Confirme se o primeiro quadro estático é renderizado de forma aceitável. | 

## Limites do Rich Card
<a name="rcs-rich-cards-limits"></a>


**Limites do Rich Card**  

| Recurso | Limite | 
| --- | --- | 
| Comprimento do título | 200 caracteres | 
| Comprimento da descrição | 2.000 caracteres | 
| Card-level sugestões | 4 por cartão | 
| Message-level sugestões | 11 por mensagem | 
| Carga útil total da mensagem | 250 KB | 
| Tamanho do arquivo de mídia | 100 MB | 
| FileUrlcomprimento | 2.000 caracteres |