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 carrosséis RCS

Uma mensagem de carrossel no AWS End User Messaging exibe de 2 a 10 rich cards em uma faixa que pode ser rolada horizontalmente. Os destinatários podem percorrer os cartões e escolher sugestões em cartões individuais para agir. Com carrosséis, você pode criar experiências conversacionais e interativas, como catálogos de produtos, menus de serviços, comparações de planos e listas de locais.

Os carrosséis compartilham o mesmo modelo de conteúdo de cartão que os rich cards independentes (consulteEnviando cartões ricos em RCS), mas os cartões de carrossel sempre usam um layout vertical e não suportam a altura da mídia. TALL

Quando usar um carrossel

Use um carrossel quando quiser que os destinatários naveguem e comparem vários itens do mesmo tipo. Entre os casos de uso comuns estão:

Se você precisar exibir um único item com conteúdo rico, use um rich card independente. Para obter detalhes, consulte Enviando cartões ricos em RCS.

Estrutura de carrossel

Você define um carrossel no Content.Carousel objeto dentro do RcsMessageContent parâmetro de uma SendRcsMessage solicitação. O objeto carrossel contém dois campos obrigatórios:

Valores de largura do cartão

Campos de conteúdo do cartão

Cada objeto de cartão na CardContents matriz suporta os seguintes campos:

Sugestões de cartões e sugestões externas

As mensagens do carrossel oferecem suporte a dois níveis de sugestões:

Use sugestões externas para ações de navegação que se apliquem à mensagem geral, como “Voltar ao menu”, “Ajuda” ou “Navegação concluída”. Evite duplicar ações em nível de cartão na lista externa de fichas.

Altura e truncamento do cartão

Todas as cartas em um carrossel são dimensionadas para corresponder à altura da carta mais alta. Se o conteúdo de um cartão exceder a altura máxima de exibição, o cliente de mensagens truncará o conteúdo na seguinte ordem:

Quando o truncamento é aplicado, um indicador “Mais” aparece para que o destinatário possa expandir o cartão para exibição em tela cheia.

Proporções de mídia

A proporção da mídia do cartão depende da combinação da largura e altura do cartão.

Estrutura JSON de carrossel

O JSON a seguir mostra a estrutura do RcsMessageContent parâmetro para uma mensagem de carrossel:

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

Esse valor é passado como uma string JSON no --rcs-message-content parâmetro (CLI) ou no parâmetro (RcsMessageContentSDK). Você também especifica --destination-phone-number e --origination-identity (um pool ou agente RCS) na send-rcs-message solicitação.

Limites de carrossel

Para obter detalhes sobre formato de mídia e entrega, consulteEnviando mensagens de arquivo RCS.