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.

Réception de contenus RCS entrants

Les utilisateurs peuvent envoyer du contenu multimédia (images, vidéos, fichiers audio et documents) dans le cadre de conversations RCS avec votre agent. Lorsque vous configurez le stockage multimédia entrant, la messagerie utilisateur AWS final télécharge le contenu multimédia depuis le fournisseur RCS, le charge dans votre compartiment Amazon S3 et publie une notification sur votre rubrique bidirectionnelle Amazon SNS avec l'emplacement S3 et les métadonnées du fichier.

Pour obtenir des informations générales sur la réception de messages RCS entrants (texte, localisation et réponses aux suggestions), consultez. Réception de messages RCS entrants Pour plus d'informations sur l'envoi de contenu multimédia aux utilisateurs, consultezEnvoi de messages RCS enrichis.

Comment fonctionne le contenu multimédia entrant

Lorsqu'un utilisateur envoie un fichier multimédia dans le cadre d'une conversation RCS, AWS la messagerie utilisateur final traite le message en suivant les étapes suivantes :

Pour les types LOCATION de SUGGESTION message et les types de message, aucun téléchargement S3 n'a lieu. Le contenu est diffusé directement dans le corps de notification du SNS. Pour plus de détails sur ces types de messages, consultezRéception de messages RCS entrants.

Configuration du stockage multimédia entrant

Pour recevoir du contenu multimédia entrant, configurez les champs suivants sur votre agent RCS à l'aide de l'UpdateRcsAgentAPI. Two-way la messagerie doit être activée sur l'agent avant de configurer le stockage multimédia.

Le compartiment S3 et le rôle IAM sont requis conjointement. Si vous en spécifiez un, vous devez spécifier les deux.

Format de clé S3

Les objets multimédia sont stockés avec le format de clé suivant, où le nom du fichier d'origine est ajouté après un # séparateur :

{prefix}/rcs/{messageId}#{fileName}

Par exemple, si vous définissez le préfixe de clé surinbound-media, un fichier multimédia peut être stocké sous la forme suivante :

inbound-media/rcs/msg-abc123def456#photo_2026.jpg

Création du rôle IAM pour les médias entrants

Créez un rôle IAM qui permet au service de messagerie de l'utilisateur AWS final de télécharger des fichiers multimédia dans votre compartiment S3. Le rôle nécessite une politique de confiance qui permet au service de l'assumer, et une politique d'autorisation qui accorde s3:PutObject l'accès à votre compartiment.

Politique d’approbation

La politique de confiance suivante permet au AWS responsable du service de messagerie utilisateur final d'assumer ce rôle. Remplacez 123456789012 par votre identifiant de AWS compte.

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "sts:AssumeRole",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

Stratégie d'autorisation

La politique d'autorisation suivante accorde au rôle l'accès pour écrire des objets dans votre compartiment S3. my-rcs-media-bucketRemplacez-le par le nom de votre compartiment.

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Action": [
                "s3:PutObject"
            ],
            "Resource": "arn:aws:s3:::my-rcs-media-bucket/*"
        }
    ]
}

Configuration du stockage multimédia (CLI)

La commande AWS CLI suivante configure le stockage multimédia entrant sur un agent RCS existant :

aws pinpoint-sms-voice-v2 update-rcs-agent \
    --rcs-agent-id rcs-agent-1234567890abcdef0 \
    --two-way-media-s3-bucket-name my-rcs-media-bucket \
    --two-way-media-s3-key-prefix "inbound-media" \
    --two-way-media-s3-role arn:aws:iam::123456789012:role/RcsInboundMediaRole \
    --region us-east-1

Charge utile des notifications multimédia entrantes

Lorsque AWS la messagerie de l'utilisateur final reçoit un fichier multimédia, elle publie une notification sur votre rubrique SNS bidirectionnelle. La notification est un objet JSON dont messageBody le champ contient un document JSON sous forme de chaînes indiquant le statut du média et, en cas de succès, l'emplacement S3 et les métadonnées du fichier.

L'exemple suivant montre une notification multimédia entrante réussie :

{
    "originationNumber": "+14255551234",
    "destinationNumber": "rcs-cb1e6e519e9049fabf8c0ae38e4d876b",
    "messageBody": "{\"mediaStatus\":\"SUCCESS\",\"s3Bucket\":\"my-rcs-media-bucket\",\"s3Key\":\"inbound-media/rcs/msg-abc123def456#photo_2026.jpg\",\"mimeType\":\"image/jpeg\",\"fileName\":\"photo_2026.jpg\",\"fileSizeBytes\":1211843}",
    "inboundMessageId": "8821d750-4bc5-4cb1-a8c3-c3d64a38d019"
}

La notification de niveau supérieur contient les champs suivants :

Le messageBody JSON contient les champs suivants :

Gestion des défaillances liées au téléchargement de fichiers multimédias

Si AWS la messagerie utilisateur final ne peut pas télécharger ou stocker le contenu multimédia du fournisseur RCS, le service publie tout de même une notification sur votre rubrique SNS bidirectionnelle. Il messageBody contient une défaillance mediaStatus (UPLOAD_FAILEDouROLE_ASSUME_FAILED) et une mediaStatusMessage description de la cause, sans champs de localisation S3.

Par exemple, un échec de l'attribution d'un rôle IAM produit le messageBody contenu suivant :

{
    "mediaStatus": "ROLE_ASSUME_FAILED",
    "mediaStatusMessage": "Media received but could not assume the configured IAM role",
    "mimeType": "image/heic",
    "fileName": "IMG_7115.heic",
    "fileSizeBytes": 1211843
}

Les causes courantes des échecs de téléchargement de contenu multimédia sont les suivantes :

Pour résoudre les problèmes de livraison, vérifiez que les politiques de confiance et d'autorisation de votre rôle IAM sont correctement configurées et que le compartiment S3 existe et est accessible depuis le service. Surveillez les CloudWatch indicateurs de votre agent pour détecter les échecs de téléchargement de contenu multimédia.

Types de médias acceptés

AWS La messagerie destinée aux utilisateurs finaux accepte les types MIME de médias entrants suivants :

Bonnes pratiques