

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 AWS Messagerie SMS pour 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' AWS CLI API SMS et voix v2 pour la messagerie des utilisateurs AWS finaux pour envoyer des MMS à vos clients.

Utilisez la [AWS CLI commande ](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) send-media-message pour envoyer un message MMS. Pour plus d'informations sur la configuration de AWS CLI, consultez la section [ Configurer 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 AWS Messagerie SMS pour l'utilisateur final](phone-numbers-sms-by-country.md) et[Pays et régions pris en charge pour la messagerie MMS en AWS Messagerie SMS pour l'utilisateur final](phone-numbers-mms-by-country.md).  
Pour vérifier si votre identité d'origine est compatible avec les MMS, consultez. [Afficher l'état et les fonctionnalités d'un numéro de téléphone dans AWS Messagerie SMS pour l'utilisateur final](phone-numbers-status.md)   
Pour utiliser une ressource partagée, vous devez utiliser le nom de ressource Amazon (ARN) complet.

## 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 qui [ permet d'envoyer 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 MMS, voir. [Configuration d'un compartiment Amazon S3 pour les fichiers MMS](#send-mms-message-bucket)

  Pour obtenir la liste des types et 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 maximum de chartes qu'un MMS peut contenir.  Types de fichiers MMSTaille du fichier MMSlimite de caractères 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 MMS ne sont pas divisés en plusieurs parties lors de leur envoi. Si vous envoyez un message texte volumineux, vous pouvez obtenir un meilleur débit en envoyant un message MMS car ils ne sont pas divisés en plusieurs parties. 



| Type de fichier | Types MIME | Taille maximale du fichier | 
| --- | --- | --- | 
| Format d'échange graphique | `image/gif` | 2 Mo | 
| Groupe mixte d'experts photographiques | `image/jpeg` | 2 Mo | 
| Carte graphique réseau portable  | `image/png` | 2 Mo | 
| Format de fichier image des balises | `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 | 
| Adaptatif Multi-Rate | `audio/amr` | 600 KO | 
| MPEG-4 | `audio/mp4`, `video/mp4` | 600 KO | 
| Groupe d'experts de l'image animée | `audio/mpeg`<br />Seuls les fichiers MP3 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)
+ Les URI S3 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 des exemples de [ Identity-based politiques pour Amazon S3 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) dans le guide de l'utilisateur [ Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).

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

Les seuls paramètres requis pour [https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) send-media-message sont et. `destination-phone-number` `origination-identity` Vous pouvez envoyer un message qui n'est que du texte en omettant le `media-urls` paramètre. Vous pouvez également envoyer un message indiquant qu'il s'agit uniquement de fichiers multimédia 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 stockée.
  + {{\+12065550150}}Remplacez-le par le numéro de téléphone de destination.
  + {{\+14255550120}}Remplacez-le par votre identité d'origine. L'identité d'origine doit être `ACTIVE` et capable d'envoyer le numéro de téléphone de destination.
  + {{text body}}Remplacez-le par votre message texte.
  + {{s3://s3-bucket/media\_file.jpg}}Remplacez-le 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 ](https://docs.aws.amazon.com/AmazonS3/latest/userguide/) Amazon S3.

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 l'appareil de destination a encore reçu le message. Pour obtenir la liste des codes d'erreur, voir [ 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 se trouver dans le même emplacement Compte AWS Région AWS que votre 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 la section [ 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 de AWS CLI, consultez la section [ Configurer 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 {{us-east-1}} par l'identité d'origine de Région AWS votre appareil compatible MMS.
+ Remplacez {{BucketName}} par le nom du nouveau compartiment.

Pour copier un fichier dans le compartiment Amazon S3, utilisez la [AWS CLI commande ](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) cp. 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.
+ {{FileName}}Remplacez-le par le nom à utiliser pour le fichier.

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

```
s3://{{BucketName}}/{{FileName}}
```