A seguir você encontra algumas recomendações para criação de conteúdo RCS. As orientações a seguir são baseadas no conteúdo oferecido pelo Google, sobre a plataforma RCS Business Messaging.
⚠️ Atenção: Com a API da Zenvia, você integra de forma prática o canal RCS na comunicação da sua empresa. A chamada de API para o RCS é a mesma para ambos os tipos: Basic e Rich Text. Para mais detalhes, confira a seção RCS da documentação de todas as APIs da Zenvia.
Um agente corresponde a um perfil de marca, uma entidade conversacional utilizada para trocar mensagens com usuários. Os agentes podem enviar mensagens com conteúdo diversos, como:
- Texto;
- Mídia;
- Sugestão de resposta (botões);
- Sugestão de ações (botões);
- Rich cards;
- Carrossel de rich cards.
Tipos de RCS
Atualmente, o Google disponibiliza três tipos de RCS. São eles:
- RCS Básico: RCS Básico: nesta versão não há conteúdo multimídia (imagens, vídeos, áudios etc) ou outros recursos típicos do RCS completo. Por ser uma opção mais simples, somente é possível enviar mensagens em texto com 160 caracteres. Esta mensagem contará com a identificação normal do canal, como validação da marca e hotsite, além de status de entrega e leitura da mensagem. Caso envie mais que 160 caracteres e tenha um agente Notificação/Single integrado, então a mensagem será entregue como Notificação/Single. Se o destinatário não for compatível com o RCS, a mensagem será entregue como SMS automaticamente.
- RCS Rich Text - Notificação: é a modalidade de RCS mensagem única, onde o cliente poderá realizar disparos ricos e a cobrança é gerada no momento da entrega.
- RCS Rich Text - Conversa: nesta versão há o recebimento do MO, e é aberta uma sessão de conversa que se mantém aberta por 24 horas. Caso a interação inicie pelo cliente a sessão é aberta imediatamente.
A seguir, veja mais detalhes sobre o envio e criação de conteúdo RCS.
Texto
As mensagens mais simples são feitas de texto. As mensagens de texto podem ser utilizadas para comunicar informações sem a necessidade de recursos visuais, interação complexa ou resposta.
Mídia
Quando você envia uma mensagem com uma imagem ou vídeo, é necessário fornecer uma URL publicamente acessível para o conteúdo. A plataforma RBM armazena arquivos em cache por 60 dias, e a API retorna um ID de arquivo para incluir nas mensagens aos usuários. Após 60 dias, os arquivos são removidos do cache.
Botões de resposta
É possível enviar botões de sugestões com mensagens para orientar as ações subsequentes dos usuários. A lista de botões só é exibida quando a mensagem associada está no final da conversa. Quaisquer mensagens subsequentes na conversa (de um usuário ou de seu agente) sobrescreverão a lista de botões. Os botões podem ser sugestão de resposta ou sugestão de ações. As listas de botões contêm no máximo 11 botões de sugestão. Cada rótulo pode ter no máximo 25 caracteres.
Sugestões de resposta
Sugestão de respostas orientam os usuários nas conversas, fornecendo respostas às quais seu agente sabe como reagir. Seu agente envia respostas sugeridas em botões ou em rich cards. Quando um usuário clica em uma resposta sugerida, seu agente recebe um evento que contém o texto da resposta e os dados de postback. As respostas sugeridas têm no máximo 25 caracteres.
Sugestões de ações
Sugestão de ações orientam os usuários nas conversas, utilizando funcionalidades nativas de seus dispositivos Android. É possível sugerir que os usuários:
- Disquem um número;
- Abram um local em um mapa;
- Compartilhem um local;
- Abram uma URL;
- Criem um evento de calendário.
Seu agente envia ações sugeridas em botões ou em rich cards. Quando um usuário toca em uma ação sugerida, seu agente recebe um evento que contém os dados de postback da ação. As ações sugeridas têm no máximo 25 caracteres.
Discar um número
A ação de discar orienta o usuário a discar um número de telefone especificado pelo agente. Os números de telefone precisam incluir um +, o código do país e o código de área, mas NÃO devem incluir separadores. Exemplo de número correto: +551140040000.
Abrir uma localização
A ação de abrir uma localização exibe um local no aplicativo de mapa padrão do usuário. Você pode especificar a localização por latitude e longitude ou com uma consulta baseada na localização atual do usuário. Você também pode definir um rótulo personalizado para o pin que é exibido no aplicativo de mapa. Para clientes com o aplicativo Mensagenss do Android, é possível que o botão de localização abra uma busca no mapa, em vez de uma localização pré-definida. Exemplo: Em vez de abrir um determinado endereço de uma loja, o botão abre uma busca pela loja mais próxima.
Compartilhar um local
Esta ação permite que o usuário compartilhe seu local com seu agente. (A localização que o usuário compartilha não é necessariamente a localização do usuário.)
Abrir URL
Esta ação abre o navegador da web do usuário na URL especificada. Se um aplicativo estiver registrado como padrão para a URL, o aplicativo será aberto, e o ícone da ação será o ícone do aplicativo.
Criar um evento de calendário
Esta ação abre o aplicativo de calendário do usuário e cria um evento com as informações especificadas: início do evento, final do evento, título e descrição.
Rich cards
Quando você precisa enviar um bloco de informações, mídia ou sugestões relacionadas, deve enviar um rich card. Os rich cards permitem o envio de várias unidades de informação em uma única mensagem. Os rich cards podem conter os seguintes itens (com as seguintes limitações):
- Imagem (JPG, JPEG ou PNG, até 5 MB)
- Vídeo (MP4, MPEG, MPEG4, M4V, H263 ou WEBM, até 5MB)
- Thumbnail (JPG, JPEG ou PNG, até 25 KB)
- Título (até 200 caracteres)
- Descrição (até 2000 caracteres)
- Uma lista de respostas sugeridas e ações sugeridas (até 4)
Um rich card pode conter qualquer um ou todos os itens listados, mas um cartão deve conter pelo menos uma imagem, vídeo ou título para ser válido. Um rich card pode conter no máximo quatro ações sugeridas e respostas sugeridas. Seu agente pode enviar vários rich cards juntos em um carrossel de rich cards.
Tamanho do card
Os cards se expandem verticalmente para caber no conteúdo. Os rich cards têm altura mínima de 112 DP e altura máxima de 344 DP. Se o conteúdo de um cartão não for grande o suficiente para preencher a altura mínima do cartão, o cartão se expande e preenche a altura extra com espaço em branco. A mídia em rich cards deve caber em uma das três alturas:
- Curto: 112 DP
- Médio: 168 DP
- Alto: 264 DP
Se a mídia não se ajustar às dimensões dentro do cartão dada a altura selecionada, a visualização da mídia é escolhida ampliando e cortando os meios de comunicação.
Carrossel de rich card
Quando você precisar apresentar a um usuário várias opções para escolher, use um carrossel de rich card. Os carrosséis reúnem vários rich cards, permitindo que os usuários comparem itens e reajam a cada um individualmente. Os carrosséis podem conter no mínimo dois e no máximo dez rich cards. Os rich cards em carrosséis devem estar em conformidade com os requisitos gerais de rich card para conteúdo e altura.
Truncamento
Assim como os rich cards, muitos fatores (como resolução da tela, densidade de pixels e preferências do usuário) afetam a aparência dos cartões para os usuários finais. Em um carrossel, no entanto, a altura dos primeiros cartões define a altura de todos os cartões no carrossel, e a altura do cartão afeta o título, a descrição e o truncamento da sugestão. Se um dispositivo não puder exibir todos os elementos de um cartão devido a restrições de exibição ou altura do cartão, a plataforma RBM trunca o cartão até que ele possa ser exibido no dispositivo, usando a seguinte lógica:
- Reduz a descrição para uma linha;
- Reduz o título a uma linha;
- Omite sugestões que não cabem no cartão, a partir do final da lista definida;
- Omite a descrição;
- Omite o título.
Para evitar truncamento, mantenha os títulos e as descrições o mais curtos possível.
- Para mídia média ou alta, use até duas sugestões.
- Para mídia curta, use até três sugestões.
- Para encaixar quatro sugestões, não inclua mídia no cartão.
- Mantenha os cartões aproximadamente equivalentes em termos de tamanho e comprimento do conteúdo e, se necessário, carregue o carrossel com cartões maiores para evitar truncamento nos cartões seguintes.
💡 Dica: confira aqui a documentação original do Google RCS Business Messaging.