View a markdown version of this page

Carga de archivos multimedia para enviarlos WhatsApp - AWS Mensajería social para usuarios finales

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.

Carga de archivos multimedia para enviarlos WhatsApp

Cuando envías o recibes un archivo multimedia, tienes que almacenarlo en un bucket de Amazon S3 y desde allí cargarlo o recuperarlo WhatsApp. El bucket de Amazon S3 debe estar en la Región de AWS misma Cuenta de AWS ubicación que tu cuenta WhatsApp empresarial (WABA). Estas instrucciones muestran cómo crear un bucket de Amazon S3, cargar un archivo y crear la URL 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 la configuración AWS CLI, consulte Configurar la CLI de AWS en la Guía del AWS Command Line Interface usuario y Crear un bucket y cargar objetos en la Guía del usuario de Amazon S3.

nota

WhatsApp almacena los archivos multimedia durante 30 días antes de eliminarlos; consulte la referencia sobre la API Upload Media in the WhatsApp Business Platform Cloud.

También puedes crear una URL prefirmada para el archivo multimedia. Con una URL prefirmada, puede conceder acceso por tiempo limitado a los objetos y cargarlos sin necesidad de que otra parte tenga credenciales o permisos AWS de seguridad.

  1. Para crear un bucket de Amazon S3, utilice el comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html AWS CLI create-bucket. 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-1Sustitúyalo por el Región de AWS que se encuentra su WABA.

    • BucketNameSustitúyalo por el nombre del nuevo depósito.

  2. Para copiar un archivo al bucket de Amazon S3, utilice el AWS CLI comando cp. En la línea de comandos, introduzca el comando siguiente:

    aws s3 cp SourceFilePathAndName s3://BucketName/FileName

    En el comando anterior:

    • SourceFilePathAndNameSustitúyalo por la ruta del archivo y el nombre del archivo que se va a copiar.

    • Sustituya BucketName por el nombre del bucket.

    • FileNameSustitúyalo por el nombre que se va a usar para el archivo.

    La URL que se debe usar al enviar es:

    s3://BucketName/FileName

    Para crear una URL prefirmada, sustitúyala user input placeholders por tu propia información.

    aws s3 presign s3://amzn-s3-demo-bucket1/mydoc.txt --expires-in 604800 --region af-south-1 --endpoint-url https://s3.af-south-1.amazonaws.com

    La URL devuelta será: https://amzn-s3-demo-bucket1.s3.af-south-1.amazonaws.com/mydoc.txt?{Headers}

  3. Sube el archivo multimedia a WhatsApp mediante el comando https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html post-whatsapp-message-media. Al completarse correctamente, el comando devolverá el{MEDIA_ID}, que es necesario para enviar el mensaje multimedia.

    aws socialmessaging post-whatsapp-message-media --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}  --source-s3-file bucketName={BUCKET},key={MEDIA_FILE}

    En el comando anterior, haga lo siguiente.

    • {ORIGINATION_PHONE_NUMBER_ID}Sustitúyalo por el identificador de su número de teléfono.

    • {BUCKET}Sustitúyalo por el nombre del bucket de Amazon S3.

    • {MEDIA_FILE}Sustitúyalo por el nombre del archivo multimedia.

    También puedes subir usando una URL de prefirma usando --source-s3-presigned-url en lugar de--source-s3-file. Debes añadirlo Content-Type en el headers campo. Si usa ambos, InvalidParameterException se devuelve un.

    --source-s3-presigned-url headers={"Name":"Value"},url=https://BUCKET.s3.REGION/MEDIA_FILE

  4. Al completarse correctamente, MEDIA_ID se devuelve. MEDIA_IDSe usa para hacer referencia al archivo multimedia al enviar un mensaje multimedia.