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

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.

Para agrupar várias cartas em um conjunto rolável, consulte. Enviando carrosséis RCS

Quando usar um rich card

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:

Se sua mensagem exigir apenas texto com sugestões opcionais, use um Enviando mensagens de texto RCS em vez disso. Se você precisar enviar um arquivo sem estrutura de cartão adicional, consulteEnviando mensagens de arquivo RCS.

Componentes de cartões avançados

Um rich card independente consiste nos seguintes componentes. Pelo menos um dosMedia,Title, ou Description é necessário emCardContent.

Orientação do cartão

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

Mídia e alturas

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

Card-level sugestões

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 estruturaSuggestions. 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 ReplyOpenUrl,DialPhone,ShowLocation,RequestLocation, eCreateCalendarEvent), consulteConfigurando sugestões de RCS.

RcsMessageContent estrutura

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:

Enviando um cartão rico

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 renderização de Rich Card varia entre dispositivos Android e iOS. Siga estas recomendações para obter resultados consistentes:

Limites do Rich Card