View a markdown version of this page

Envoi de SMS RCS - AWS Messagerie SMS à l'utilisateur final
En quoi les messages texte RCS diffèrent-ils des SMSRcsMessageContent structure pour les messages texteEnvoi d'un message texteSolution de secours par SMS ou MMSLimites de messages texteQuand utiliser les SMS

Les traductions sont fournies par des outils de traduction automatique. En cas de conflit entre le contenu d'une traduction et celui de la version originale en anglais, la version anglaise prévaudra.

Envoi de SMS RCS

A TextMessage est le type de contenu le plus simple que vous pouvez envoyer avec l'SendRcsMessageAPI. Il se compose d'un corps de texte brut (jusqu'à 3 072 caractères) avec des puces de suggestion facultatives qui apparaissent sous forme de boutons interactifs sous le message.

En quoi les messages texte RCS diffèrent-ils des SMS

Les SMS envoyés SendRcsMessage diffèrent de ceux envoyés SendTextMessage (SMS) de deux manières :

  • Puces à suggestion : vous pouvez joindre jusqu'à 11 puces à suggestion à un message texte RCS. Grâce à ces puces, les destinataires peuvent répondre, ouvrir une URL, composer un numéro de téléphone, partager une position ou créer un événement du calendrier en une seule étape. Les SMS ne prennent pas en charge les suggestions.

  • Single-message livraison : un message texte RCS arrive sous la forme d'un message unique, quelle que soit sa longueur (jusqu'à 3 072 caractères). Les opérateurs divisent les messages SMS de plus de 160 caractères en plusieurs segments, qui peuvent arriver en panne ou avec des retards entre les segments.

Pour plus de détails sur tous les types de suggestions disponibles et leurs paramètres, consultezConfiguration des suggestions RCS.

RcsMessageContent structure pour les messages texte

Lorsque vous appelezSendRcsMessage, vous transmettez la charge utile du message en tant que RcsMessageContent paramètre. Pour un message texte, définissez le Content champ sur un TextMessage objet contenant une Body chaîne. Pour inclure des puces de suggestion, ajoutez un Suggestions tableau en tant que frère de premier niveau de. Content

L'extrait de code JSON suivant montre la structure RcsMessageContent d'un message texte avec des suggestions :

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

Dans cet exemple :

  • Content.TextMessage.Bodycontient le texte du message (obligatoire, de 1 à 3 072 caractères).

  • Suggestionsest un tableau de niveau supérieur (facultatif, jusqu'à 11 éléments). Chaque suggestion nécessite un Text champ (jusqu'à 25 caractères) et un PostbackData champ (jusqu'à 2 048 caractères).

Le Suggestions tableau prend en charge six types d'actions : Reply OpenUrlDialPhone,,ShowLocation,RequestLocation, etCreateCalendarEvent. Vous pouvez combiner différents types de suggestions dans un même message. Pour plus de détails sur chaque type, voirConfiguration des suggestions RCS.

Envoi d'un message texte

Pour envoyer un message texte RCS, appelez SendRcsMessage avec les paramètres obligatoires suivants :

  • DestinationPhoneNumber: Le numéro de téléphone du destinataire au E.164 format.

  • OriginationIdentity: ID du pool ou agent AWS RCS qui envoie le message.

  • RcsMessageContent: chaîne JSON Content contenant un TextMessage objet.

Vous appelez l'API à l'aide de l'interface de ligne de commande AWS (aws pinpoint-sms-voice-v2 send-rcs-message) ou d'un kit SDK AWS tel que le client boto3pinpoint-sms-voice-v2.

Solution de secours par SMS ou MMS

Si l'appareil du destinataire ne prend pas en charge le RCS ou est temporairement injoignable sur le canal RCS, vous pouvez configurer le message pour qu'il revienne aux SMS ou MMS. Pour activer le repli, incluez un FallbackConfiguration objet dans votre SendRcsMessage demande. FallbackConfigurationSpécifie le canal de secours (SMSouMMS), le corps du message de secours et l'identité d'origine (un numéro de téléphone ou un identifiant d'expéditeur) à utiliser pour le message de secours.

Le repli est facultatif. Si vous omettez FallbackConfiguration et que le destinataire ne peut pas recevoir le RCS, le message n'est pas remis.

Pour plus d'informations sur la configuration du comportement de secours, consultezEnvoi de messages RCS enrichis.

Limites de messages texte

Ressource Limite Remarques
Corps du message (Body) 3,072 caractère (s) UTF-8 Obligatoire. Doit contenir au moins 1 caractère.
Suggestions par message 11 Total combiné des réponses et des actions.
Texte d'affichage de la suggestion (Text) 25 personnages S'applique à tous les types de suggestions.
Données de postback () PostbackData 2 048 caractères Obligatoire pour tous les types de suggestions.

Quand utiliser les SMS

À utiliser TextMessage pour :

  • Notifications telles que les confirmations de commande, les mises à jour d'expédition et les rappels de rendez-vous.

  • One-time mots de passe et codes de vérification.

  • Des invites conversationnelles qui proposent des options de réponse sous forme de puces de suggestion, permettant des interactions guidées sans saisie de texte libre.

  • Courtes mises à jour de statut lorsque le contenu ne nécessite pas d'images ou de mises en page structurées.

Pour les messages qui nécessitent des images, des vidéos ou des mises en page structurées avec des titres et des descriptions, utilisez plutôt des fiches enrichies ou des carrousels. Consultez Envoi de messages RCS enrichis.