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 messages sous forme de fichier RCS

Vous pouvez utiliser le type de FileMessage contenu de l'SendRcsMessageAPI pour envoyer des images, des vidéos, des fichiers audio et des PDF sous forme de messages autonomes à vos destinataires. Les messages de fichier apparaissent sous forme de contenu multimédia intégré dans l'application de messagerie du destinataire.

Les messages sous forme de fichiers sont différents des fichiers multimédia sur carte riche. Un message sous forme de fichier fournit un seul élément multimédia en tant que contenu complet du message, tandis que les cartes enrichies combinent le contenu multimédia avec du texte et des suggestions d'actions. Pour plus d'informations sur les cartes riches, consultezEnvoi de cartes RCS Rich.

Vous pouvez joindre des suggestions au niveau des messages (telles que des puces de réponse ou des boutons d'action) aux messages du fichier. Pour plus de détails sur les suggestions, consultezConfiguration des suggestions RCS.

FileMessage structure

L'FileMessageobjet est imbriqué dans le Content champ du RcsMessageContent paramètre. Message-levelSuggestionsêtes un frère ou une sœur de Content (non imbriqué dedans).

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}

Sources d'URL de fichiers

Le FileUrl paramètre accepte deux formats d'URL :

Politique relative aux compartiments S3 pour la livraison de fichiers

Pour permettre à l'utilisateur AWS final de récupérer des fichiers depuis votre compartiment Amazon S3, associez la politique basée sur les ressources suivante au compartiment :

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

YOUR-BUCKETRemplacez-le par le nom de votre compartiment. Pour restreindre l'accès à un préfixe spécifique, remplacez-le /* par le chemin souhaité (par exemple,arn:aws:s3:::YOUR-BUCKET/rcs-media/*).

Types de supports pris en charge et limites de taille

Le tableau suivant répertorie les types de médias pris en charge parFileMessage.

Miniatures

Vous pouvez fournir une image miniature pour les messages vidéo et PDF à l'aide du ThumbnailUrl paramètre. La miniature s'affiche sous forme d'aperçu dans la conversation avant que le destinataire n'ouvre ou ne télécharge le fichier complet.

Envoi d'un message contenant un fichier

Pour envoyer un message de fichier, appelez l'SendRcsMessageAPI avec un FileMessage objet dans le RcsMessageContent paramètre. Vous spécifiez l'identité d'origine (un pool ou un agent AWS RCS) à l'aide du --origination-identity paramètre.

Le code JSON suivant indique la RcsMessageContent valeur d'un message de fichier avec des suggestions :

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

Livraison et repli

Lorsque vous envoyez un message sous forme de fichier, AWS la messagerie utilisateur final tente de le transmettre via le canal RCS. Si l'appareil du destinataire ne prend pas en charge le RCS, ou si le message expire avant sa livraison (en fonction de la TimeToLive valeur), le service peut revenir aux SMS ou aux MMS en fonction de votre configuration de secours.

Vous pouvez configurer la solution de secours par SMS ou MMS au niveau du pool ou par message. Pour plus de détails sur le comportement de secours, consultezEnvoi de messages RCS enrichis.