Configuration de la messagerie MMS avec SMS Gateway
SMS Gateway peut envoyer ou recevoir des images vers et depuis Voice Gateway (VGW), Watson Assistant (WA) ou un moteur d'orchestration de service (SOE).
Le MMS (Multimedia Messaging Service) est un moyen d'envoyer du multimédia, tel que des images, par l'intermédiaire de canaux de messagerie textuelle. Les utilisateurs peuvent envoyer et recevoir des messages MMS via SMS Gateway, s'ils
configurent leur(s) numéro(s) de téléphone avec Twilio Programmable SMS. Twilio impose des restrictions sur la taille, le nombre et le type de contenu des messages MMS. Actuellement, Twilio prend intégralement
en charge les formats d'image .jpeg, .gif et .png et accepte d'autres types de contenu MIME. Les utilisateurs peuvent inclure jusqu'à 10 images dans une même demande de message, mais la taille
totale du message ne doit pas dépasser 5 Mo. La messagerie MMS avec SMS Gateway n'est prise en charge que pour les numéros de téléphone aux Etats-Unis et au Canada.
Prise en charge des MMS sortants
Lorsqu'un moteur d'orchestration de service ou Watson Assistant envoie un message MMS à l'utilisateur (avec ou sans message texte SMS), une ou plusieurs URL de support publiques sont envoyées à Twilio. Twilio ne prend pas en charge les URL non publiques.
Activez les MMS à partir d'un moteur d'orchestration de service ou de Watson Assistant avec SMS Gateway
Le moteur d'orchestration de service ou Watson Assistant ajoute une commande d'action smsActSendMedia qui inclut le paramètre mediaURL. Pour plus d'informations, voir API de SMS Gateway
Activez les MMS avec la demande de canal de communication.
Le moteur d'orchestration de service ou Watson Assistant configuré dans Watson Assistant met à jour l'action vgwActSendSMS existante et ajoute le paramètre mediaURL à cette action. Pour plus d'informations,
voir Balises d'action et variables d'état dans l'API Voice Gateway
Les API de canal de communication REST existantes sont mises à jour avec une variable de demande smsMediaURL facultative. La variable de demande smsMediaURL spécifie l'URL publique du support envoyé dans un message
MMS. Pour plus d'informations, voir Utilisation de l'API REST pour le contrôle des sessions SMS
Prise en charge des MMS entrants
Lorsque SMS Gateway reçoit une demande MMS d'un fournisseur SMS, la variable d'état smsMedia est ajoutée au contexte de la demande. SMS Gateway envoie ensuite la demande directement à Watson Assistant ou au moteur d'orchestration
de service, ou la relaye à Voice Gateway via la demande de canal de communication. Si Voice Gateway est activé, il ajoute la variable d'état vgwSMSMedia au contexte et envoie la demande à Watson Assistant ou au moteur d'orchestration
de service. Pour plus d'informations, voir API de SMS Gateway et Balises d'action et variables d'état dans l'API Voice Gateway.
L'exemple suivant illustre le contexte d'une demande de message MMS d'un fournisseur SMS, qui contient deux URL d'image. SMS Gateway ajoute la variable d'état smsMedia et un paramètre mediaContentType pour chaque URL. Il envoie ensuite la demande au moteur d'orchestration de service ou à WA, ou à VGW via une demande de canal de communication.
"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"}
]
Traitement des incidents dans
Si vous utilisez Twilio pour envoyer des messages MMS via SMS Gateway, les supports sont stockés dans votre compte Twilio. Pour en savoir plus sur la gestion des images, et leur suppression, visitez la page Media Resource de Twilio.
Si une demande MMS est correctement envoyée au fournisseur SMS, mais qu'elle ne parvient pas à atteindre l'utilisateur, vérifiez le journal des erreurs dans le compte de fournisseur MMS associé à la demande (par exemple, Twilio).
Certaines erreurs courantes
Les comptes Twilio sont autorisés à envoyer au maximum 10 URL de support dans un message MMS. Un message MMS qui contient plus de 10 URL génère une erreur, comme illustré dans l'exemple ci-après.
Error = {\"code\": 21623, \"message\": \"The number of media URLs 13 exceeds the max allowed (10)\", \"more_info\": \"https://www.twilio.com/docs/errors/21623\"
Twilio ne prend intégralement en charge que les formats d'image .jpeg, .gif et .png, mais d'autres types de contenu peuvent être acceptés. Si un message MMS contient un type de contenu inacceptable,
l'erreur ci-après est générée.
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.
Pour plus d'informations sur les types de contenu, voir Accepted Content Types for Media dans la documentation Twilio.