

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.

# Exemple d'envoi d'un message MMS à l'aide de la messagerie SMS AWS destinée à l'utilisateur final
<a name="send-mms-message"></a>

Si vous utilisez une ressource partagée, vous devez utiliser le nom Amazon Resource Name (ARN) complet de la ressource. Vous pouvez utiliser l'API AWS CLI ou AWS End User Messaging SMS and voice v2 pour envoyer des MMS à vos clients.

Utilisez la [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI commande pour envoyer un message MMS. Pour plus d'informations sur la configuration du AWS CLI, consultez la section Configuration de [l'interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) dans le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).

**Important**  
Les fonctionnalités MMS ne sont disponibles que dans certains pays. Pour plus d'informations sur les pays pris en charge pour les SMS et les MMS, consultez [Pays et régions pris en charge pour la messagerie SMS avec messagerie AWS à l'utilisateur final](phone-numbers-sms-by-country.md) et[Pays et régions pris en charge pour la messagerie MMS dans les SMS destinés aux utilisateurs AWS finaux](phone-numbers-mms-by-country.md).  
Pour vérifier si votre identité d'origine est compatible avec les MMS, consultez. [Afficher le statut et les fonctionnalités d'un numéro de téléphone dans AWS la messagerie SMS à l'utilisateur final](phone-numbers-status.md)   
Pour utiliser une ressource partagée, vous devez utiliser le nom complet de la ressource Amazon (ARN).

## Conditions préalables
<a name="send-mms-message-prerequisite"></a>

Avant de commencer, les conditions suivantes doivent être remplies :
+ Vous devez disposer d'une identité d'origine [compatible avec l'envoi d'un message MMS](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title). 
+ Vous devez télécharger vos fichiers multimédia dans un compartiment Amazon S3 dont l'identité d'origine est Région AWS identique à celle de votre identité d'origine compatible avec les MMS, voir. [Configuration d'un compartiment Amazon S3 pour les fichiers MMS](#send-mms-message-bucket)

  Pour obtenir la liste des types et des tailles de fichiers pris en charge, voir [ Types de fichiers MMS, taille et limites de caractères  Découvrez la taille des fichiers MMS, les limites relatives aux types de fichiers et le nombre maximal de chartes qu'un MMS peut contenir.  types de fichiers MMSTaille du fichier MMSlimite de caractères en mms  Un seul fichier multimédia MMS peut atteindre 2 Mo pour tous les types d'images (gif, jpeg, png) et 600 Ko pour tous les types de fichiers multimédia audio et vidéo. Le corps du message texte d'un MMS peut contenir 1600 caractères de n'importe quel jeu de caractères. Contrairement aux SMS, les messages MMS ne sont pas divisés en plusieurs parties lorsqu'ils sont envoyés. Si vous envoyez un message texte volumineux, vous pouvez obtenir un meilleur débit en envoyant un message MMS, car il n'est pas divisé en plusieurs parties. 


****  

| Type de fichier | Types MIME | Taille maximale du fichier | 
| --- | --- | --- | 
| Format d'échange graphique |  `image/gif`  | 2 Mo | 
| Groupe conjoint d'experts en photographie |  `image/jpeg`  | 2 Mo | 
| Carte graphique réseau portable  |  `image/png`  | 2 Mo | 
| Format de fichier image de balise |  `image/tiff`  | 600 KO | 
| Projet de partenariat de troisième génération  |  `audio/3gpp`, `video/3gpp`  | 600 KO | 
| Projet de partenariat de troisième génération 2  |  `audio/3gpp2`, `video/3gpp2`  | 600 KO | 
| Multidébit adaptatif |  `audio/amr`  | 600 KO | 
| MPEG-4 |  `audio/mp4`, `video/mp4`  | 600 KO | 
| Groupe d'experts de l'image animée |  `audio/mpeg` Seuls MP3 les fichiers sont pris en charge pour `audio/mpeg`  | 600 KO | 
| Ogg |  `audio/ogg`  | 600 KO | 
| QuickTime |  `video/quicktime`  | 600 KO | 
| WebM |  `video/webm`  | 600 KO | 
| iCalendar |  `text/calendar`  | 600 KO | 
| vCard |  `text/vcard`, `text/x-vcard`  | 600 KO | 
| PDF (Portable Document Format) |  `application/pdf`  | 600 KO |  ](mms-limitations-character.md#mms-limitations-character.title)
+ Le S3 URIs de chaque fichier MMS. 
+ L'identité utilisée pour appeler `send-media-message` doit disposer d'un accès en lecture au compartiment Amazon S3 qui contient vos fichiers multimédia. Pour plus d'informations sur la configuration de l'accès en lecture, consultez les [exemples de politiques basées sur l'identité pour Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) dans le guide de l'[utilisateur d'Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).

## Envoyez un MMS avec AWS CLI
<a name="send-mms-message-steps"></a>

Les seuls paramètres requis pour [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)sont `destination-phone-number` et`origination-identity`. Vous pouvez envoyer un message uniquement sous forme de texte en omettant le `media-urls` paramètre. Vous pouvez également envoyer un message s'il ne s'agit que de fichiers multimédias en omettant le `message-body` paramètre.

**Pour envoyer un message MMS**
+ Sur la ligne de commande, entrez la commande suivante :

  ```
  aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'
  ```

  Dans l’exemple précédent, apportez les modifications suivantes :
  + *us-east-1*Remplacez-le par Région AWS celui dans lequel votre identité d'origine est enregistrée.
  + Remplacez *\$112065550150* par le numéro de téléphone de destination.
  + *\$114255550120*Remplacez-le par votre identité d'origine. L'identité d'origine doit être en mesure `ACTIVE` d'envoyer le numéro de téléphone de destination.
  + Remplacez *text body* par votre message texte.
  + Remplacez *s3://s3-bucket/media\$1file.jpg* par l'URI S3 du fichier MMS. Les formats de fichiers multimédia pris en charge sont répertoriés dans[Types de fichiers MMS, taille et limites de caractères](mms-limitations-character.md). Pour plus d'informations sur la création d'un compartiment S3 et la gestion des objets, consultez [Configuration d'un compartiment Amazon S3 pour les fichiers MMS](#send-mms-message-bucket) la section [Création d'un compartiment](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) et [téléchargement d'objets](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html) dans le [guide de l'utilisateur Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).

Si AWS la messagerie SMS de l'utilisateur final accepte la commande, vous recevrez le`MessageID`. Cela signifie uniquement que la commande a été reçue avec succès et non que le périphérique de destination a déjà reçu le message. Pour obtenir la liste des codes d'erreur, consultez la section [SendMediaMessage Erreurs](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors).

```
{
   "MessageId": "string"
}
```

## Configuration d'un compartiment Amazon S3 pour les fichiers MMS
<a name="send-mms-message-bucket"></a>

Vos fichiers MMS doivent être stockés dans un compartiment Amazon S3. Le compartiment Amazon S3 doit être identique à celui Compte AWS de votre Région AWS identité d'origine compatible MMS. Ces instructions indiquent comment créer un compartiment Amazon S3, charger un fichier et créer l'URI du fichier. Pour plus d'informations sur les commandes Amazon S3, consultez [Utiliser des commandes de haut niveau (s3) avec l'AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html). Pour plus d'informations sur la configuration du AWS CLI, consultez la section Configuration de [l'interface de ligne de commande AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) dans le [guide de AWS Command Line Interface l'utilisateur](https://docs.aws.amazon.com/cli/latest/userguide/).

Pour créer un compartiment Amazon S3, utilisez la commande [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI . Sur la ligne de commande, entrez la commande suivante :

```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```

Dans la commande précédente :
+ Remplacez par l'identité d'origine compatible *us-east-1* avec les MMS qui se trouve dans Région AWS votre ordinateur.
+ *BucketName*Remplacez-le par le nom du nouveau compartiment.

Pour copier un fichier dans le compartiment Amazon S3, utilisez la AWS CLI commande [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy). Sur la ligne de commande, entrez la commande suivante :

```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName 
```

Dans la commande précédente :
+ Remplacez *SourceFilePathAndName* par le chemin du fichier et le nom du fichier à copier.
+ Remplacez *BucketName* par le nom du compartiment.
+ Remplacez *FileName* par le nom à utiliser pour le fichier.

L'URI à utiliser lors de l'envoi est :

```
s3://BucketName/FileName
```