Entendendo as mensagens MMS

O MMS (Serviço de Mensagens Multimídia) permite enviar conteúdo multimídia, como imagens, vídeos e áudio, além de textos mais longos do que os que podem ser enviados em uma única mensagem SMS. As mensagens são entregues pela rede móvel, sem que o destinatário precise ter uma conexão de dados ou Wi-Fi.

Existem muitos casos de uso possíveis para mensagens MMS, incluindo marketing, campanhas políticas, promoções e notificações.

Disponibilidade

Atualmente, a Messages API da Vonage oferece suporte ao envio de mensagens MMS nos EUA e no Canadá. US Short Codes, números 10DLC e números gratuitos habilitados para SMS são atualmente compatíveis com o envio de MMS. No caso dos US Short Codes, as mensagens MMS podem ser enviadas para as redes da AT&T, T-Mobile (anteriormente Sprint) e Verizon nos EUA. A taxa de transmissão, a capacidade de entrega e os volumes de mensagens SMS podem variar dependendo do tipo de número utilizado.

10DLC

Para enviar mensagens MMS por meio de códigos longos de 10 dígitos nos EUA, você precisará registrar o número em uma marca e campanha 10DLC. Consulte este documento para saber mais sobre como configurar números 10DLC (observação: o documento faz referência à SMS API, mas o conteúdo da seção sobre as diretrizes do 10DLC também se aplica à Messages API).

Recursos de mensagens

O canal MMS 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 vários tipos diferentes de mensagens.

Tipos de mensagens de saída

Existem sete tipos de mensagens de saída:

• text
• image
• audio
• video
• vcard
• file
• content

Todos os tipos de mensagem, exceto text pode incluir um anexo de mídia ou arquivo. O image, audio, video, vcard, e file Os tipos podem incluir um único anexo de um tipo específico; o content O tipo de mensagem pode incluir vários anexos de qualquer tipo. Todos os arquivos anexados devem ser especificados na carga útil da API por meio de uma URL acessível ao público.

Tipos de mensagens recebidas

Existem seis tipos de mensagens recebidas:

• text
• image
• audio
• video
• vcard
• file

Todos os tipos de mensagem, exceto as de texto, podem incluir um ou mais anexos de mídia ou arquivos. O anexo principal será do tipo especificado pelo tipo de mensagem. Quaisquer anexos adicionais podem ser de qualquer tipo. O acesso aos anexos é feito por meio de (um) URL(s) especificado(s) na carga útil do webhook da mensagem recebida.

Webhook de status

Além das mensagens enviadas e recebidas, o canal MMS 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
• 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.

Especificações Técnicas

Todos 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; eles estão descritos a seguir.

Tipos de mídia compatíveis

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

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:

• 1.600 caracteres no total, incluindo texto e legendas: exibição ideal.
• Máximo de 3.000 caracteres: evite rejeições ou falhas na entrega.

Recomendações quanto ao tamanho dos arquivos:

• Até 200 KB: Otimize a entrega. Evite atrasos na entrega e compressão.
• Até 600 KB: compatibilidade mais ampla. Evite rejeições ou falhas na entrega.

TTL

TTL significa Time-To-Live, ou seja, por quanto tempo uma mensagem deve permanecer ativa antes de ser entregue com sucesso. Se isso não ocorrer delivered com sucesso dentro do tempo de TTL, a mensagem é considerada expirada e será rejected se o TTL for compatível.

O TTL é definido como um valor numérico em segundos no ttl parâmetro da carga útil JSON. Para MMS, o mínimo ttl o valor é 300 segundos (5 minutos), e o máximo é 259200 (ou 3 dias).

Se o valor do TTL for excedido, a mensagem recebe o status de rejected. A Webhook de status de mensagem será enviado informando sobre essa mudança de status e conterá os detalhes do erro para código de erro 1360.

Mais informações

• Especificação da Messages API
• Exemplo de código: Enviar uma mensagem MMS com imagem