Ejemplo de envío de un mensaje MMS mediante Mensajes SMS para usuarios finales de AWS
Si utiliza un recurso compartido, debe utilizar el nombre de recurso de Amazon (ARN) completo del recurso. Puede utilizar la AWS CLI o la API de SMS y voz, versión 2, de Mensajes SMS para usuarios finales de AWS para enviar mensajes MMS a los clientes.
Use el comando de la AWS CLI send-media-message para enviar un mensaje MMS. Para obtener más información sobre cómo configurar la AWS CLI, consulte Configuración de la CLI de AWS en la Guía del usuario de AWS Command Line Interface.
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 admitidos para la mensajería SMS con AWS End User Messaging SMS y Países y regiones admitidos para la mensajería MMS en AWS End User Messaging SMS.
Para comprobar si su identidad de origen es compatible con MMS, consulte Visualización del estado y las capacidades de un número de teléfono en AWS End User Messaging SMS.
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.
-
Debe cargar sus archivos multimedia en un bucket de Amazon S3 que se encuentre en la misma Región de AWS que su identidad de origen compatible con MMS, consulte Configuración de un bucket de Amazon S3 para archivos MMS.
Para obtener una lista de los tipos y tamaños de archivo admitidos, consulte .
Los URI de S3 de cada archivo MMS.
La identidad utilizada para llamar
send-media-messagedebe 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 en la Guía del usuario de Amazon S3.
Envío de un MMS con la AWS CLI
Los únicos parámetros necesarios para send-media-message 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:
-
Sustituya
us-east-1por la Región de AWS en la que está almacenada su identidad de origen. -
Sustituya
+12065550150por el número de teléfono de destino. -
Sustituya el
+14255550120por su identidad de origen. La identidad de origen debe estarACTIVEy ser capaz de enviar el número de teléfono de destino. -
Sustituya
text bodypor el mensaje de texto. -
Sustituya
s3://s3-bucket/media_file.jpgpor el URI de S3 del archivo MMS. Los formatos de archivos multimedia admitidos se enumeran en Tipos de archivos MMS, tamaño y límites de caracteres. 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 o Creación de un bucket y Carga de objetos en la Guía del usuario de Amazon S3.
-
Si Mensajes SMS para usuarios finales de AWS 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 ver una lista de códigos de error, consulte Errores de SendMediaMessage.
{
"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 Cuenta de AWS y Región de AWS que la identidad de origen compatible con MMS. 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. Para obtener más información sobre cómo configurar la AWS CLI, consulte Configuración de la CLI de AWS en la Guía del usuario de AWS Command Line Interface.
Para crear un bucket de Amazon S3, use el comando create-bucket
aws s3api create-bucket --region 'us-east-1' --bucketBucketName
En el comando anterior:
-
Sustituya
us-east-1por la Región de AWS en la que se encuentra la identidad de origen compatible con MMS. Sustituya
BucketNamepor el nombre de su bucket nuevo.
Para copiar un archivo en el bucket de Amazon S3, utilice el comando cp de la AWS CLI. En la línea de comandos, introduzca el comando siguiente:
aws s3 cpSourceFilePathAndNames3://BucketName/FileName
En el comando anterior:
Sustituya
SourceFilePathAndNamepor la ruta y el nombre del archivo que se va a copiar.Sustituya
BucketNamepor el nombre del bucket.Sustituya
FileNamepor el nombre que desea usar para el archivo.
La URI que se debe utilizar al enviar es:
s3://BucketName/FileName