Tipos de mensagens de texto e multimídia do RCS

Ao usar o RCS com a Messages API do Vonage, você pode enviar mensagens ricas e de grande impacto que elevam a experiência do cliente muito além do SMS padrão. Este guia se concentra nos tipos de mensagens RCS que transmitem texto e mídia, ajudando você a entender quando e como usar cada um deles de forma eficaz.

Os seguintes tipos de texto e mensagens multimídia RCS são compatíveis com a Messages API:

  • text
  • image
  • video
  • file

Cada tipo de mensagem possui os mesmos requisitos (to, from, channel, message_type) e opcional (webhook_url, client_ref, ttl, failover) parâmetros.

Mensagens de texto

As mensagens de texto são o tipo de mensagem RCS mais básico e flexível. Elas são mais indicadas para mensagens simples, informativas ou urgentes que não exigem mídia. Use-as para enviar atualizações ou alertas de serviço, mensagens transacionais sem promoções visuais ou confirmações de pedidos.

Existem algumas limitações para mensagens de texto:

  • O text O parâmetro está limitado a 3.072 caracteres.
{
   "message_type": "text",
   "text": "Hello from Vonage!",
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

Mensagens RCS com um message_type de text também aceitam um suggestions matriz como parâmetro de nível superior. A matriz pode conter até onze objetos de sugestão que definem respostas e/ou ações sugeridas.

Mensagens com imagens

As mensagens com imagens permitem que você envie recursos visuais de alta resolução, como gráficos promocionais, códigos QR ou capturas de tela, para promover uma interação mais envolvente. Use-as para anunciar um novo produto, convidar para um evento visual ou complementar o conteúdo com guias visuais.

Existem algumas limitações para mensagens com imagens:

  • A URL da imagem deve estar acessível ao público.
  • A imagem fornecida deve ser uma JPG ou PNG.
{
   "message_type": "image",
   "image": {
      "url": "https://example.com/image.jpg"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

Mensagens em vídeo

As mensagens em vídeo permitem que você envie pequenos vídeos que transmitem ideias mais complexas de uma forma envolvente. Use mensagens em vídeo para demonstrações de produtos e tutoriais, anúncios de eventos ou mensagens personalizadas.

Existem algumas limitações nas mensagens de vídeo:

  • O vídeo fornecido deve estar em um .mp4, .webm, ou .m4v formato
  • Mantenha os vídeos curtos e otimizados para dispositivos móveis
{
   "message_type": "video",
   "video": {
      "url": "https://example.com/video.webm"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

Arquivar mensagens

As mensagens com anexos permitem que você envie documentos para download, como PDFs, facilitando o compartilhamento de formulários, faturas ou materiais de referência. Use as mensagens com anexos para enviar bilhetes eletrônicos, contratos, faturas, documentos de integração ou quaisquer formulários jurídicos.

Existem limitações para o envio de mensagens:

  • Apenas o formato PDF é compatível.
  • O arquivo deve estar hospedado em uma URL acessível ao público.
  • Leve em consideração o tamanho do arquivo no que diz respeito ao uso de dados móveis e ao desempenho.
{
   "message_type": "file",
   "file": {
      "url": "https://example.com/file.pdf"
   },
   "to": "447700900000",
   "from": "Vonage",
   "channel": "rcs"
}

Trechos de código

A seguir, apresentamos uma lista de trechos de código para o envio de solicitações de mensagens de diferentes tipos:

Leitura complementar