Limites dos rich cards RCS
A referência da API de RCS Business Messaging (RBM) do Google define os limites que um rich card precisa respeitar. A API rejeita mensagens fora deles, por isso o criador confere tudo enquanto você digita.
Fonte: Google, referência RBM phones.agentMessages, https://developers.google.com/business-communications/rcs-business-messaging/reference/rest/v1/phones.agentMessages, e guia de envio, https://developers.google.com/business-communications/rcs-business-messaging/guides/build/messages/send (conferido em outubro de 2026).
- Título do card: até 200 caracteres. Descrição: até 2.000 caracteres.
- Sugestões em um card: até 4 respostas ou ações, com até 25 caracteres cada.
- Chips de sugestão abaixo da mensagem: até 11.
- Carrossel: de 2 a 10 cards, com largura SMALL (120 DP) ou MEDIUM (232 DP).
- Altura da mídia: SHORT (112 DP), MEDIUM (168 DP) ou TALL (264 DP). Arquivos de até 100 MB; miniaturas de até 100 kB.
- Dados de postback e URLs de fallback: até 2.048 caracteres. Mensagens só de texto: até 3.072 caracteres.
Card único ou carrossel?
Use um card único quando houver uma ação só: confirmar um agendamento, rastrear uma encomenda, concluir um pagamento. O card vertical coloca a mídia no topo e valoriza uma imagem forte. O horizontal põe uma miniatura ao lado do texto, ótimo para recibos e status; além da mídia, ele precisa de título, descrição ou sugestão.
Use um carrossel quando o cliente precisa escolher: produtos, voos, planos, horários. Mantenha os cards consistentes, todos com mídia ou todos sem, e textos de tamanho parecido, já que os cards do carrossel aparecem com altura uniforme. Coloque a opção mais provável primeiro.
Respostas e ações sugeridas
Uma resposta sugerida devolve um texto fixo ao seu agente junto com dados de postback, então seu bot sabe exatamente qual opção foi tocada. Uma ação sugerida abre apps do próprio celular: discador, navegador ou webview, mapas, agenda ou o seletor de localização para compartilhar a posição.
As sugestões do card ficam presas ao card. Os chips aparecem em uma fileira rolável abaixo da última mensagem e somem quando o cliente toca em um ou responde, então use-os para próximos passos como "Falar com atendente" ou "Parar mensagens". Desde novembro de 2025, ações de abrir URL precisam usar links http:// ou https://.
Remetente verificado e SMS de fallback
Todo agente RCS empresarial é verificado antes do lançamento: Google e operadoras conferem marca, logo e caso de uso, e a conversa mostra o nome da marca com um selo de verificação. Esse sinal de confiança explica boa parte do engajamento maior do RCS em relação ao SMS.
Nem todo celular ou rede suporta RCS, então o tráfego real precisa de fallback com o essencial e um link. Um SMS comporta 160 caracteres GSM-7 ou 70 caracteres UCS-2; textos maiores são divididos em partes de 153 ou 67 caracteres, cada uma cobrada como uma mensagem. Árabe, emojis e até aspas tipográficas forçam UCS-2, por isso o criador conta as partes e pode trocar esses caracteres por versões simples.
Sobre o JSON exportado
A exportação segue o formato do contentMessage de uma AgentMessage do RBM, com standaloneCard ou carouselCard, sugestões dos cards e da mensagem. As URLs de mídia são fictícias e os dados de postback são gerados a partir do texto do botão. É ilustrativo: serve para orientar desenvolvedores ou comparar com a API do seu provedor.
Com a OmniChannels.ai você envia o mesmo card, carrossel e sugestões por uma única API REST ou campanha, com fallback automático para SMS e relatórios de entrega dos dois canais.
