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
TimeToLivevaleur 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
| 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.
| 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
OpenUrlles 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 TTL
TimeToLive, 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
OriginationIdentityde 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.
Ressources connexes
-
Solution de repli entre RCS et SMS à l'aide de pools téléphoniquespour plus d'informations sur le repli automatique basé sur un pool avec.
SendTextMessage -
Configuration de l'expiration des messages RCSpour plus d'informations sur la configuration du protocole TTL et le comportement d'expiration.
-
Envoi de messages RCS enrichispour un aperçu des types de messages riches en RCS et de l'
SendRcsMessageAPI.