Las traducciones son generadas a través de traducción automática. En caso de conflicto entre la traducción y la version original de inglés, prevalecerá la version en inglés.
# Ejemplo de envío de un mensaje MMS mediante SMS de mensajería para el usuario AWS final
Si utiliza un recurso compartido, debe utilizar el nombre de recurso de Amazon (ARN) completo del recurso. Puede utilizar la versión 2 de la AWS CLI API de mensajería SMS y voz para el usuario AWS final para enviar mensajes MMS a sus clientes.
Use el [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI comando para enviar un mensaje MMS. Para obtener más información sobre la configuración AWS CLI, consulte [Configurar la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) en la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
**importante**
Las capacidades de MMS solo están disponibles en algunos países. Para obtener más información sobre los países en los que se admiten SMS y MMS, consulte [Países y regiones compatibles para la mensajería SMS con mensajería SMS para el usuario AWS final](phone-numbers-sms-by-country.md) y [Países y regiones compatibles con la mensajería MMS en los SMS de mensajería para usuarios finales AWS](phone-numbers-mms-by-country.md).
Para comprobar si su identidad de origen es compatible con MMS, consulte [Vea el estado y las capacidades de un número de teléfono en la mensajería SMS para el usuario AWS final](phone-numbers-status.md).
Para usar un recurso compartido debe utilizar el nombre de recurso de Amazon (ARN) completo.
## Requisitos previos
Antes de comenzar, deben cumplirse los siguientes requisitos previos.
+ Debe tener una identidad de origen que [admita el envío de un mensaje MMS](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title).
+ Debe cargar sus archivos multimedia en un bucket de Amazon S3 que se encuentre en la Región de AWS misma ubicación que su identidad de origen compatible con MMS, consulte. [Configuración de un bucket de Amazon S3 para archivos MMS](#send-mms-message-bucket)
Para obtener una lista de los tipos y tamaños de archivo admitidos, consulte [ Tipos de archivos MMS, tamaño y límites de caracteres Obtenga información sobre el tamaño de los archivos MMS, las limitaciones de tipo de archivo y el número máximo de caracteres que puede contener un MMS. tipos de archivos MMStamaño de archivo MMSlímite de caracteres de mms Un único archivo multimedia MMS puede tener un tamaño de hasta 2 MB para todos los tipos de imagen (gif, jpeg y png) y 600 KB para el resto de tipos de archivos multimedia. El cuerpo del mensaje de texto de un MMS puede contener 1600 caracteres de cualquier juego de caracteres. A diferencia de los SMS, los mensajes MMS no se dividen en varias partes cuando se envían. Si envía mensajes de texto grandes, puede obtener un mejor rendimiento al enviar un mensaje MMS, ya que no están divididos en varias partes.
****
| Tipo de archivo | Tipos de MIME | Tamaño máximo de archivo |
| --- | --- | --- |
| Formato de intercambio de gráficos | `image/gif` | 2 MB |
| Grupo de expertos en fotografía fija | `image/jpeg` | 2 MB |
| Gráficos de red portátiles | `image/png` | 2 MB |
| Formato de archivo de imagen con etiquetas | `image/tiff` | 600 KB |
| Proyecto asociación de tercera generación | `audio/3gpp`, `video/3gpp` | 600 KB |
| Proyecto asociación de tercera generación 2 | `audio/3gpp2`, `video/3gpp2` | 600 KB |
| Velocidad múltiple adaptativa | `audio/amr` | 600 KB |
| MPEG-4 | `audio/mp4`, `video/mp4` | 600 KB |
| Grupo de expertos de imágenes en movimiento | `audio/mpeg` Solo se admiten MP3 archivos para `audio/mpeg` | 600 KB |
| Ogg | `audio/ogg` | 600 KB |
| QuickTime | `video/quicktime` | 600 KB |
| WebM | `video/webm` | 600 KB |
| iCalendar | `text/calendar` | 600 KB |
| vCard | `text/vcard`, `text/x-vcard` | 600 KB |
| Formato de documento portátil | `application/pdf` | 600 KB | ](mms-limitations-character.md#mms-limitations-character.title).
+ El S3 URIs de cada archivo MMS.
+ La identidad utilizada para llamar `send-media-message` debe disponer de acceso de lectura al bucket de Amazon S3 que contiene los archivos multimedia. Para obtener más información sobre cómo configurar el acceso de lectura, consulte [Ejemplos de políticas basadas en identidad para Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) en la [Guía del usuario de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
## Envíe un MMS con el AWS CLI
Los únicos parámetros necesarios [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)son `destination-phone-number` y`origination-identity`. Puede enviar un mensaje que sea solo texto omitiendo el parámetro `media-urls`. También puede enviar un mensaje que sea solo un archivo multimedia omitiendo el parámetro `message-body`.
**Para enviar un mensaje MMS**
+ En la línea de comandos, introduzca el comando siguiente:
```
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'
```
En el comando anterior, realice los siguientes cambios:
+ *us-east-1*Sustitúyalo por el Región de AWS que está almacenada tu identidad de origen.
+ *\$112065550150*Sustitúyalo por el número de teléfono de destino.
+ *\$114255550120*Sustitúyalo por tu identidad de origen. La identidad de origen debe estar `ACTIVE` y ser capaz de enviar el número de teléfono de destino.
+ *text body*Sustitúyala por tu mensaje de texto.
+ *s3://s3-bucket/media\$1file.jpg*Sustitúyalo por el URI S3 del archivo MMS. Los formatos de archivos multimedia admitidos se enumeran en [Tipos de archivos MMS, tamaño y límites de caracteres](mms-limitations-character.md). Para obtener más información sobre la creación de un bucket de S3 y la administración de objetos, consulte [Configuración de un bucket de Amazon S3 para archivos MMS](#send-mms-message-bucket) o [Creación de un bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) y [Carga de objetos](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html) en la [Guía del usuario de Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
Si el SMS de mensajería para el usuario AWS final acepta el comando, recibirá el`MessageID`. Esto solo significa que el comando se ha recibido correctamente y no que el dispositivo de destino haya recibido aún el mensaje. Para obtener una lista de códigos de error, consulte [SendMediaMessage Errores](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors).
```
{
"MessageId": "string"
}
```
## Configuración de un bucket de Amazon S3 para archivos MMS
Los archivos MMS deben almacenarse en un bucket de Amazon S3. El bucket de Amazon S3 debe estar en la misma identidad de origen compatible con MMS Cuenta de AWS y la Región de AWS misma que la suya. Estas instrucciones muestran cómo crear un bucket de Amazon S3, cargar un archivo y crear el URI del archivo. Para obtener más información sobre los comandos de Amazon S3, consulte [Uso de comandos de alto nivel (s3) con la CLI de AWS](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html). Para obtener más información sobre la configuración AWS CLI, consulte [Configurar la AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) en la [Guía del AWS Command Line Interface usuario](https://docs.aws.amazon.com/cli/latest/userguide/).
Para crear un bucket de Amazon S3, utilice el comando [create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html) AWS CLI . En la línea de comandos, introduzca el comando siguiente:
```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```
En el comando anterior:
+ *us-east-1*Sustitúyalo por la Región de AWS identidad de origen compatible con MMS en la que se encuentra.
+ *BucketName*Sustitúyalo por el nombre del nuevo depósito.
Para copiar un archivo al bucket de Amazon S3, utilice el AWS CLI comando [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy). En la línea de comandos, introduzca el comando siguiente:
```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName
```
En el comando anterior:
+ *SourceFilePathAndName*Sustitúyalo por la ruta del archivo y el nombre del archivo que se va a copiar.
+ Sustituya *BucketName* por el nombre del bucket.
+ *FileName*Sustitúyalo por el nombre que se va a usar para el archivo.
La URI que se debe utilizar al enviar es:
```
s3://BucketName/FileName
```