Ejemplo de envío de un mensaje MMS mediante Mensajes SMS para usuarios finales de AWS - AWS End User Messaging SMS

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.

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:

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 de la 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:

  • Sustituya us-east-1 por la Región de AWS en la que se encuentra la identidad de origen compatible con MMS.

  • Sustituya BucketName por 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 cp SourceFilePathAndName s3://BucketName/FileName

En el comando anterior:

  • Sustituya SourceFilePathAndName por la ruta y el nombre del archivo que se va a copiar.

  • Sustituya BucketName por el nombre del bucket.

  • Sustituya FileName por el nombre que desea usar para el archivo.

La URI que se debe utilizar al enviar es:

s3://BucketName/FileName