Configurando o sistema de mensagens MMS com SMS Gateway
SMS Gateway pode enviar ou receber imagens para e do Voice Gateway (VGW), Watson Assistant (WA) ou um Service Orchestration Engine (SOE).
O Serviço de Mensagens Multimídia (MMS) é uma maneira padrão de enviar multimídia, como imagens, por meio de canais de sistema de mensagens de texto. Os usuários podem enviar e receber mensagens MMS através do SMS Gateway se configurarem seu número
(ou números) de telefone com Twilio Programmable SMS. O Twilio impõe restrições no tamanho, no número e no tipo de conteúdo de mensagens MMS. Atualmente, o Twilio oferece suporte completo para os formatos
de imagem .jpeg, .gif e .png, além de aceitar outros tipos de conteúdo MIME. Os usuários podem incluir até 10 imagens em uma única solicitação de mensagem, mas o tamanho total da mensagem não deve exceder
5 MB. O sistema de mensagens MMS com SMS Gateway é suportado apenas para números de telefone nos EUA e no Canadá.
Suporte ao MMS de saída
Quando um Service Orchestration Engine ou Watson Assistant envia uma mensagem MMS para o usuário (com ou sem uma mensagem de texto SMS), uma ou mais URLs de mídia publicamente acessíveis são enviadas para o Twilio. O Twilio não suporta URLs não públicas.
Ative o MMS a partir do SOE ou Watson Assistant com SMS Gateway
O SOE ou WA inclui um comando de ação smsActSendMedia que inclui o parâmetro mediaURL. Para obter mais informações, consulte API para SMS Gateway
Ative o MMS com solicitação de Canal
O SOE ou WA configurado no Watson Assistant atualiza a ação vgwActSendSMS existente e inclui o parâmetro mediaURL nessa ação. Para obter mais informações, consulte Tags de ação e variáveis
de estado na API do Voice Gateway
As APIs de Canal REST existentes são atualizadas com uma variável da solicitação smsMediaURL opcional. A variável da solicitação smsMediaURL especifica a URL publicamente acessível da mídia enviada em uma mensagem MMS.
Para obter mais informações, consulte Usando a API de REST para controlar sessões SMS
Suporte ao MMS de entrada
Quando o SMS Gateway recebe uma solicitação MMS de um provedor de SMS, a variável de estado smsMedia é incluída no contexto de solicitação. SMS Gateway então envia a solicitação diretamente para o WA ou SOE ou a retransmite para o Voice
Gateway via solicitação do Canal. Se o Voice Gateway estiver ativado, ele incluirá a variável de estado vgwSMSMedia no contexto e enviará a solicitação para o WA ou SOE. Para obter mais informações, consulte API para SMS Gateway e Tags de ação
e variáveis de estado na API do Voice Gateway.
O exemplo a seguir mostra o contexto de uma solicitação de mensagem MMS do Provedor de SMS contendo duas URLs de imagem. O SMS Gateway inclui a variável de estado smsMedia e um parâmetro mediaContentType em cada URL. Ele
então envia a solicitação para o SOE ou WA ou para o VGW por meio da Solicitação de Canal.
"smsMedia":[
{"mediaURL":"https://api.twilio.com/2010-04-01/Accounts/ACxxxxxxxxxxxxxxxcac7a6f05427c4bff3/Messages/MM7d78f699365a682f2441cd45496cb3d9/Media/ME61e988e5132dac150axxxxxfaea4a364",
"mediaContentType":"image/jpeg"},
{"mediaURL":"https://api.twilio.com/2010-04-01/Accounts/ACxxxxxxxxxxxxxxxcac7a6f05427c4bff3/Messages/MM7d78f699365a682f2441cd45496cb3d9/Media/MEaaf3424e479605cbdxxxxx7360cf6ede",
"mediaContentType":"image/jpeg"}
]
Resolução de problemas do
Se estiver usando o Twilio para enviar ou receber mensagens MMS por meio do SMS Gateway, a mídia será armazenada em sua conta do Twilio. Para saber mais sobre como gerenciar imagens, e como excluí-las, visite a página Recurso de Mídia do Twilio.
Se uma solicitação MMS for enviada com sucesso para o provedor de SMS, mas não chegar ao usuário, verifique o log de erro na conta do provedor de MMS associada à solicitação (por exemplo, Twilio).
Alguns erros comuns
As contas do Twilio são ativadas para enviar no máximo 10 URLs de mídia em uma mensagem MMS. Uma mensagem MMS contendo mais de 10 URLs produz um erro, conforme mostrado no exemplo a seguir.
Error = {\"code\": 21623, \"message\": \"The number of media URLs 13 exceeds the max allowed (10)\", \"more_info\": \"https://www.twilio.com/docs/errors/21623\"
O Twilio oferece suporte completo apenas para os formatos de imagem .jpeg, .gif e .png, embora outros tipos de conteúdo possam ser aceitos. Se uma mensagem MMS tiver um tipo de conteúdo inaceitável, ocorrerá
o seguinte erro.
Error
12300 Twilio is unable to process the Content-Type of the provided URL. Please see the <a href="/docs/api/twiml/">Twilio Markup XML Documentation</a> for more information on valid Content-Types.
Para obter mais informações sobre tipos de conteúdo, consulte Tipos de conteúdo aceitos para mídia do Twilio.