View a markdown version of this page

Configuration de la solution de secours par SMS ou MMS par message - AWS Messagerie SMS à l'utilisateur final

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.

Configuration de la solution de secours par SMS ou MMS par message

Lorsque vous envoyez un message RCS, il est possible que l'appareil du destinataire ne soit pas compatible avec le RCS ou que le message expire avant d'être livré. Grâce à la fonction de repli par message, vous pouvez spécifier un autre contenu SMS ou MMS que AWS la messagerie de l'utilisateur final diffuse automatiquement lorsque le message RCS ne parvient pas au destinataire. Vous configurez le repli sur chaque SendRcsMessage demande en incluant le FallbackConfiguration paramètre.

Quand le repli se déclenche

AWSLa messagerie destinée à l'utilisateur final déclenche le message de secours dans deux situations :

  • Panne RCS immédiate : l'appareil ou l'opérateur du destinataire ne prend pas en charge le RCS, ou le canal RCS rejette le message.

  • Expiration du TTL : vous définissez une TimeToLive valeur et le message n'est pas délivré avant l'expiration du délai. Pour plus d'informations sur l'expiration des messages, consultezConfiguration de l'expiration des messages RCS.

Si vous ne l'incluez pas FallbackConfiguration dans la demande et que le message RCS échoue ou expire, aucun message de secours n'est envoyé.

Per-message solution de repli par rapport à une solution de repli basée sur un pool

Per-message fallback on est SendRcsMessage différent de la solution de repli automatique basée sur un pool disponible avec. SendTextMessage Pour plus de détails sur la solution de repli basée sur le pool, voir. Solution de repli entre RCS et SMS à l'aide de pools téléphoniques

Comparaison des mécanismes de repli
Fonctionnalité Pool-based solution de repli () SendTextMessage Per-message solution de repli () SendRcsMessage
Configuration Automatique lorsqu'un pool contient à la fois un agent RCS et des identités SMS Explicite : vous incluez FallbackConfiguration dans chaque demande
Chaîne Fallback SMS (sélectionné par le pool) SMS ou MMS (à vous de choisir) Channel
Contenu de secours Même corps de message Vous fournissez un contenu distinct adapté aux SMS ou aux MMS
Sélection de l'identité Le pool sélectionne l'identité d'origine Vous spécifiez un numéro de téléphone ou un identifiant d'expéditeur
Déclencheur RCS non pris en charge (basé sur le délai d'expiration) Défaillance immédiate du RCS ou expiration du TTL

FallbackConfiguration structure

Le FallbackConfiguration paramètre est un seul objet de la SendRcsMessage demande. Vous définissez le Channel champ pour indiquer s'il s'agit d'un SMS ou d'un MMS, puis vous fournissez les champs de contenu correspondants.

FallbackConfiguration champs
Champ Type Obligatoire Description
Channel String Oui Le canal de secours. Valeurs valides : SMS ou MMS.
MessageBody String Conditionnel Le corps du texte du message de secours. 1 600 caractères maximum. Obligatoire quand Channel c'est le casSMS. CarMMS, au moins l'un MessageBody des deux MediaUrls doit être fourni.
MediaUrls Liste de chaînes Conditionnel Une ou plusieurs URL multimédia pour un MMS de secours. CarMMS, au moins l'un MessageBody des deux MediaUrls doit être fourni.
OriginationIdentity String Conditionnel Identité d'origine du message de secours. Accepte un numéro de téléphone ou un identifiant d'expéditeur (par valeur, ID ou ARN) ; vous ne pouvez pas spécifier de pool ou d'agent RCS. Si vous omettez ce champ et que le message d'origine a été envoyé via un pool, le service sélectionne un numéro approprié dans ce pool.
Important

La MessageBody limite de remplacement est de 1 600 caractères. C'est plus court que la limite de 3 072 caractères pour le corps du RCS. TextMessage Créez votre contenu de secours en fonction des contraintes de caractères des SMS ou MMS.

Le JSON suivant montre la structure d'un FallbackConfiguration objet pour une solution de secours par SMS :

{ "Channel": "SMS", "MessageBody": "Your order has shipped. Track at https://example.com/track/12345", "OriginationIdentity": "+18005550199" }

Le JSON suivant montre la structure d'une solution de secours MMS :

{ "Channel": "MMS", "MessageBody": "Your order has shipped.", "MediaUrls": ["https://cdn.example.com/shipping-confirmation.jpg"], "OriginationIdentity": "+18005550199" }

Configuration de la solution de secours par SMS

Pour revenir aux SMS, configurez Channel SMS et fournissez unMessageBody. Étant donné que les SMS ne prennent pas en charge les puces à suggestion ou les cartes enrichies, incluez toutes les URL importantes sous forme de texte brut dans le corps du message.

Configuration de la solution de secours MMS

Pour revenir aux MMS, définissez Channel MMS et saisissez une ou plusieurs URL multimédia. MediaUrls Utilisez le MMS fallback lorsque votre message RCS contient du contenu visuel (tel qu'une carte enrichie avec une image) et que vous souhaitez préserver l'expérience visuelle des destinataires qui ne supportent pas le RCS.

Combiner la solution de secours avec l'expiration des messages

Lorsque vous définissez les deux TimeToLive et que vous FallbackConfiguration répondez à une demande, AWS la messagerie utilisateur final tente de transmettre le RCS pendant la durée du TTL. Si le message n'est pas délivré avant l'expiration du délai, le service envoie le message de secours. Ce modèle est utile pour les contenus urgents tels que les mots de passe à usage unique ou les rappels de rendez-vous.

Pour plus d'informations sur la configuration de l'expiration des messages, consultezConfiguration de l'expiration des messages RCS.

L'exemple suivant définit un TTL de 60 secondes avec remplacement par SMS :

{ "DestinationPhoneNumber": "+12065550100", "OriginationIdentity": "rcs-agent-1234567890", "RcsMessageContent": "{\"Content\":{\"TextMessage\":{\"Body\":\"Your verification code is 483291.\"}}}", "TimeToLive": 60, "FallbackConfiguration": { "Channel": "SMS", "MessageBody": "Your verification code is 483291.", "OriginationIdentity": "+18005550199" } }

Bonnes pratiques

  • Rédigez le contenu de secours séparément. Le contenu RCS enrichi (puces à suggestions, cartes enrichies, carrousels) ne se traduit pas directement en SMS ou en MMS. Rédigez un message de secours concis et autonome plutôt que de réutiliser le corps du RCS mot pour mot.

  • Incluez les URL sous forme de texte brut dans la solution de secours SMS. Remplacez les puces de suggestion interactives (telles que OpenUrl les actions) par des URL intégrées dans le. MessageBody

  • Utilisez le MMS fallback pour le contenu visuel. Si votre message RCS comporte une carte enrichie ou un carrousel avec des images, MMS fallback préserve le contexte visuel pour les destinataires sans support RCS.

  • Définissez un TTL raisonnable. Lorsque vous combinez le repli avec le TTLTimeToLive, choisissez un TTL qui équilibre les tentatives de livraison avec la rapidité. Pour les messages urgents, un TTL de 30 à 60 secondes donne une brève fenêtre de livraison RCS avant de revenir en arrière. Pour les messages généraux, une fenêtre plus longue (de quelques minutes à quelques heures) donne au canal RCS plus de chances de réussir.

  • Vérifiez votre identité d'origine. La configuration OriginationIdentity de remplacement doit être un numéro de téléphone ou un identifiant d'expéditeur enregistré dans votre compte de messagerie utilisateur AWS final et capable d'envoyer des SMS ou des MMS vers le pays de destination.