Entendendo as mensagens RCS

Atualmente, as mensagens RCS são oferecidas na Alemanha e no Reino Unido (RU), bem como em mais de 10 outros países nas regiões da EMEA, América do Norte e América do Sul. Caso deseje utilizar as mensagens RCS em países não listados especificamente, entre em contato com nossa Equipe de vendas

RCS, ou Serviços de Comunicação Avançados, é um protocolo de comunicação para o envio de mensagens para e entre dispositivos conectados a uma rede de telefonia celular. As mensagens RCS podem incluir texto, fotos, vídeos e arquivos, bem como elementos interativos, como respostas sugeridas e botões de ação sugeridos.

Existem algumas semelhanças com as mensagens MMS, mas também algumas diferenças importantes:

  • Entrega de mensagens:
    • O conteúdo das mensagens MMS é transmitido pela rede de celular
    • O envio de mensagens RCS requer uma conexão com a internet (seja por meio de dados móveis ou Wi-Fi)
  • Tamanho do arquivo:
    • As mensagens RCS também permitem o envio de arquivos de tamanho maior do que as mensagens MMS, seja de imagens, vídeos ou outros arquivos
  • Interatividade e conteúdo rico:
    • As mensagens RCS oferecem a possibilidade de maior interatividade por meio de ações e respostas sugeridas
    • As mensagens RCS oferecem conteúdo rico na forma de layouts de cartão e carrossel

Em termos de funcionalidade, as mensagens RCS se assemelham mais aos canais OTT (over-the-top), como WhatsApp, Facebook Messenger, ou Viber. Um importante diferencial em relação a esses outros canais é que o RCS pode ser suportado nativamente, sem a necessidade de instalar aplicativos de terceiros. Existem atualmente algumas limitações em termos de compatibilidade com dispositivos (consulte o Suporte a dispositivos RCS (seção mais adiante neste documento).

Messages API do canal RCS

O canal RCS da Messages API do Vonage utiliza os servidores RBM (RCS Business Messaging) do Google e oferece suporte a grande parte das funcionalidades fornecidas pelo RBM do Google.

Como se trata de um serviço de terceiros, é necessário realizar algumas configurações e procedimentos de integração antes de você poder começar a enviar mensagens RCS por meio da Messages API. Consulte o Configurando um agente RBM para mensagens RCS mais adiante neste documento.

Recursos de mensagens do RCS

O canal RCS da Messages API oferece suporte tanto às mensagens de saída (mensagens enviadas pela empresa ao cliente) quanto às mensagens de entrada (mensagens enviadas pelo cliente à empresa, em resposta a uma mensagem de saída). Dentro dessas duas categorias, existem muitos tipos diferentes de mensagens.

Tipos de mensagens de saída

Existem cinco tipos de mensagens de saída:

  • text
  • image
  • video
  • file
  • cards
  • carousel

O text, image, video e file Os tipos de mensagem podem ser usados para enviar diversos tipos de mensagens RCS; consulte Tipos de mensagens de texto e multimídia do RCS para mais informações. O card e carousel Os tipos de mensagem podem ser usados para enviar mensagens RCS mais complexas, como rich cards e carrosséis. Para saber mais sobre como usar esses tipos de mensagem, consulte Tipos de mensagens de Rich Cards do RCS e Fichas de sugestões do RCS.

Tipos de mensagens recebidas

Existem nove tipos de mensagens recebidas:

  • text
  • image
  • video
  • audio
  • file
  • vcard
  • location
  • reply
  • button

O reply e button Os tipos de mensagens recebidas são acionados em resposta às interações dos clientes com mensagens de saída que contêm sugestões de resposta e sugestões de ação.

Webhook de status

Além das mensagens enviadas e recebidas, o canal RCS fornece mensagens de status por meio de um webhook. Essas mensagens são acionadas por alterações no status de entrega de uma mensagem enviada. Os status disponíveis para mensagens enviadas são:

  • submitted
  • delivered
  • read
  • rejected
  • undeliverable

Mais detalhes sobre as mensagens enviadas e recebidas, bem como sobre o webhook de status, podem ser encontrados no Especificação da Messages API.

Suporte a dispositivos RCS

O sistema de mensagens RCS é compatível com Android, iOS e alguns outros tipos de dispositivos.

Ao enviar mensagens RCS, talvez seja interessante incluir uma verificação da compatibilidade do dispositivo como parte do seu fluxo de trabalho de mensagens. Consulte o Guia de verificação de compatibilidade do dispositivo para mais informações.

Especificações Técnicas

Os detalhes sobre autenticação, propriedades da carga JSON, respostas e erros para os diversos tipos de mensagens RCS de saída e de entrada, bem como mensagens de status, estão contidos em Especificação da Messages API.

Há alguns outros detalhes técnicos que devem ser levados em conta.

Tipos de mídia compatíveis

Para os tipos de mensagem que podem incluir mídia, como imagens, vídeos e arquivos, os seguintes tipos de mídia são suportados.

Media type Document type Extension Works with rich cards
application/pdf PDF .pdf No
image/jpeg JPEG .jpeg, .jpg Yes
image/gif GIF .gif Yes
image/png PNG .png Yes
video/h263 H263 video .h263 Yes
video/m4v M4V video .m4v Yes
video/mp4 MP4 video .mp4 Yes
video/mpeg4 MPEG-4 video .mp4, .m4p Yes
video/mpeg MPEG video .mpeg Yes
video/webm WEBM video .webm Yes

Tamanhos de mensagens e arquivos de mídia

Existem alguns limites de tamanho e orientações que devem ser observados em relação às mensagens e aos arquivos de mídia.

  • Limite de caracteres do texto: 3.000 utf-8 personagens
  • O limite máximo de caracteres na URL para o envio de arquivos de mídia é de 2.000 caracteres
  • O tamanho máximo de toda a mensagem RCS convertida em string é de 250 KB. Isso inclui o texto que compõe a carga útil JSON ao enviar mensagens estruturadas.
  • O tamanho máximo de um arquivo de mídia que pode ser enviado por meio de uma mensagem RCS é de 100 MB.

Outros detalhes técnicos

  • Criptografia: Atualmente, a criptografia de ponta a ponta não é compatível com o RBM (a Messages API do Vonage utiliza o Google RBM para mensagens RCS) para mensagens comerciais. As conversas pessoais no aplicativo Google Messages contam com criptografia de ponta a ponta, mas as mensagens do RBM passam pelos servidores do Google para fins de conformidade regulatória e segurança. O Google, no entanto, emprega medidas de segurança como criptografia TLS, criptografia de dados em repouso e controles de acesso para proteger as mensagens do RBM. Consulte Medidas de segurança do Google RCS para mais informações.
  • Limite de taxas: O limite de taxa padrão ativado para o canal RCS é de 75 solicitações por segundo (por chave de API). Esse limite pode ser aumentado mediante solicitação.
  • Aceitar/Recusar: Entre em contato com seu gerente de contas ou Suporte para habilitar as funcionalidades de aceitação e recusa.

Configurando um agente RBM para mensagens RCS

Para começar a usar o sistema de mensagens RCS com o agente RBM, siga estas duas etapas:

  1. Registre seu agente no modo desenvolvedor:
  • Entre em contato com seu gerente de conta para solicitar a ativação do Modo Desenvolvedor para o seu agente RBM (atualmente, as mensagens RCS estão disponíveis apenas para contas gerenciadas).
  • O Modo de Desenvolvedor permite que você teste exaustivamente a funcionalidade de mensagens RCS e garanta uma integração perfeita com seus sistemas.
  • Use este modo para desenvolver e aperfeiçoar sua implementação antes de colocá-la em produção.
  1. Iniciar a verificação e a execução do agente:
  • Depois de testar com sucesso sua API no Modo Desenvolvedor, você está pronto para enviar tráfego RCS em produção.
  • Para iniciar o processo de verificação e ativação do agente, entre em contato com seu gerente de contas (atualmente, o sistema de mensagens RCS está disponível apenas para contas gerenciadas).
  • Eles vão orientá-lo nas etapas necessárias para verificar seu agente e ativar o serviço de mensagens RCS em tempo real para sua empresa.

Diretrizes para o logotipo

Depois de criar seu agente, você pode atualizar sua identidade visual, incluindo o nome de exibição, a descrição, as cores e imagens como o logotipo da sua empresa:

An example of a Vonage branded RCS conversation.

Para garantir a melhor experiência possível ao usuário, recomendamos que você siga estas orientações para o seu logotipo e imagens de banner:

  • Logotipo: Seu logotipo aparecerá quando seu agente enviar uma mensagem a um usuário, bem como na tela “Informações e opções” (conforme mostrado acima). Todos os logotipos são recortados em formato circular, mesmo que a imagem original seja retangular; portanto, certifique-se de que a imagem enviada tenha a aparência desejada após o recorte. Recomendamos deixar espaço suficiente ao redor do logotipo para o recorte e testar a imagem nos modos claro e escuro para garantir a clareza visual.
  • Imagens de banner: Estas são as imagens retangulares exibidas na tela “Informações e opções”, que ficam atrás do seu logotipo. Para obter melhores resultados, elas devem ter uma proporção de 45:14; lembre-se de que o logotipo se sobreporá parcialmente a essa imagem.

Você pode usar os modelos cujos links constam abaixo como orientação para as imagens do seu logotipo e banner:

Mais informações