Comprendre la messagerie MMS

Les MMS (Multimedia Messaging Service) vous permettent d'envoyer des contenus multimédias tels que des images, des vidéos, des fichiers audio, ainsi que des textes plus longs que ceux qui peuvent être envoyés dans un seul message SMS. Les messages sont envoyés via le réseau mobile sans que le destinataire n'ait besoin d'une connexion data ou wifi.

Les messages MMS peuvent être utilisés dans de nombreux cas, notamment pour le marketing, les campagnes politiques, les promotions et les notifications.

Disponibilité

L'API Messages de Vonage prend actuellement en charge l'envoi de messages MMS aux États-Unis et au Canada. Les numéros courts américains, les numéros 10DLC et les numéros verts compatibles avec les SMS sont actuellement pris en charge pour l'envoi de MMS. Pour les numéros courts américains, les messages MMS peuvent être envoyés aux réseaux AT&T, T-Mobile (anciennement Sprint) et Verizon aux États-Unis. Le débit, la délivrabilité et le volume des messages SMS peuvent varier en fonction du type de numéro utilisé.

10DLC

Pour envoyer des messages MMS via des codes longs à 10 chiffres aux États-Unis, vous devez enregistrer le numéro avec une marque et une campagne 10DLC. Voir le présent document pour en savoir plus sur la configuration des numéros 10DLC (note : le document fait référence à l'API SMS, mais le contenu de la section "10 DLC guidelines" s'applique également à l'API Messages).

Capacités de messagerie

Le canal MMS de l'API Messages prend en charge à la fois la messagerie sortante (messages envoyés par l'entreprise au client) et la messagerie entrante (messages envoyés par le client à l'entreprise, en réponse à un message sortant). Dans ces deux catégories, il existe plusieurs types de messages différents.

Types de messages sortants

Il existe sept types de messages sortants :

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

Tous les types de messages, à l'exception de text peut inclure un média ou un fichier en pièce jointe. Les image, audio, video, vcardet file peuvent inclure une seule pièce jointe d'un type spécifique ; le type content peut inclure plusieurs pièces jointes de n'importe quel type. Tous les fichiers joints doivent être spécifiés dans la charge utile de l'API via une URL accessible au public.

Types de messages entrants

Il existe six types de messages entrants :

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

Tous les types de messages, à l'exception du texte, peuvent inclure une ou plusieurs pièces jointes de type média ou fichier. La pièce jointe principale sera d'un type spécifié par le type de message. Les pièces jointes supplémentaires peuvent être de n'importe quel type. Les pièces jointes sont accessibles via une ou plusieurs URL spécifiées dans la charge utile du webhook du message entrant.

Webhook d'état

Outre les messages sortants et entrants, le canal MMS fournit des messages d'état via un webhook. Ces messages sont déclenchés par des changements dans l'état de livraison d'un message sortant. Les statuts disponibles pour les messages sortants sont les suivants :

• submitted
• delivered
• rejected
• undeliverable

Pour plus de détails sur les messages sortants et entrants, ainsi que sur le webhook d'état, voir la section Spécification de l'API Messages.

Spécifications techniques

Les détails complets de l'authentification, des propriétés de la charge utile JSON, des réponses et des erreurs pour les différents types de messages RCS sortants et entrants, ainsi que les messages d'état, sont contenus dans le document suivant Spécification de l'API Messages.

Il y a d'autres détails techniques à connaître, qui sont détaillés ci-dessous.

Types de supports pris en charge

Pour les types de messages, qui peuvent inclure des médias tels que des images, des vidéos et des fichiers, les types de médias suivants sont pris en charge :

Taille des messages et des supports

Il existe quelques limites de taille et lignes directrices à respecter pour les messages et les médias.

• Limitation du nombre de caractères du texte :
  • 1600 caractères dans le champ de texte d'un message de type texte
  • 300 caractères dans le champ de légende des autres types de messages MMS
• Recommandations sur la taille des fichiers
  • Jusqu'à 200 Ko : Optimiser la diffusion. Éviter les délais de livraison et la compression.
  • Jusqu'à 600 Ko : Prise en charge la plus large. Évitez les rejets ou la non-livraison.
  • 1MB : Codes courts IMI uniquement. Peut entraîner d'importants retards de traitement et de livraison et/ou une compression et une réduction de la qualité du fichier original.

TTL

TTL est le Time-To-Live, c'est-à-dire la durée d'existence d'un message avant qu'il ne soit délivré avec succès. S'il n'est pas delivered dans le délai TTL, le message est considéré comme expiré et sera rejected si le TTL est pris en charge.

Le TTL est défini comme une valeur numérique en secondes dans le fichier ttl de la charge utile JSON. Pour les MMS, la valeur minimale de ttl est 300 secondes (5 minutes), et le maximum est de 259200 (ou 3 jours).

Si la valeur TTL est dépassée, le message reçoit un statut de rejected. A Message Status webhook sera envoyé pour l'informer de ce changement de statut et contiendra les détails de l'erreur pour le code d'erreur 1360.

Plus d'informations

• Spécification de l'API Messages
• Exemple de code : Envoi d'un message MMS Image