Téléchargement de fichiers multimédia à envoyer avec WhatsApp - AWS Messagerie sociale destinée aux utilisateurs finaux

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.

Téléchargement de fichiers multimédia à envoyer avec WhatsApp

Lorsque vous envoyez ou recevez un fichier multimédia, il doit être stocké dans un compartiment Amazon S3 et chargé ou extrait de celui-ci WhatsApp. Le compartiment Amazon S3 doit se trouver dans le même emplacement Compte AWS Région AWS que votre compte WhatsApp professionnel (WABA). Ces instructions indiquent comment créer un compartiment Amazon S3, charger un fichier et créer l'URL du fichier. Pour plus d'informations sur les commandes Amazon S3, consultez Utiliser des commandes de haut niveau (s3) avec l'AWS CLI. Pour plus d'informations sur la configuration du AWS CLI, consultez Configuration de l'interface de ligne de commande AWS dans le guide de AWS Command Line Interface l'utilisateur, création d'un compartiment et téléchargement d'objets dans le guide de l'utilisateur Amazon S3.

Note

WhatsApp stocke les fichiers multimédia pendant 30 jours avant de les supprimer, voir Upload Media in the WhatsApp Business Platform Cloud API Reference.

Vous pouvez également créer une URL présignée vers le fichier multimédia. Avec une URL présignée, vous pouvez accorder un accès limité dans le temps aux objets et les télécharger sans qu'un tiers ait besoin d'informations d'identification ou d' AWS autorisations de sécurité.

  1. Pour créer un compartiment Amazon S3, utilisez la commande create-bucket 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 :

    • us-east-1Remplacez-le par Région AWS celui dans lequel se trouve votre WABA.

    • Remplacez BucketName par le nom du nouveau compartiment.

  2. Pour copier un fichier dans le compartiment Amazon S3, utilisez la AWS CLI commande 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.

    • Remplacez FileName par le nom à utiliser pour le fichier.

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

    s3://BucketName/FileName

    Pour créer une URL présignée, remplacez-la user input placeholders par vos propres informations.

    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

    L'URL renvoyée sera : https://amzn-s3-demo-bucket1.s3.af-south-1.amazonaws.com/mydoc.txt?{Headers}

  3. Téléchargez le fichier multimédia à WhatsApp l'aide de la post-whatsapp-message-mediacommande. Une fois terminée, la commande renvoie le{MEDIA_ID}, qui est requis pour envoyer le message multimédia.

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

    Dans la commande précédente, procédez comme suit :

    • {ORIGINATION_PHONE_NUMBER_ID}Remplacez-le par l'identifiant de votre numéro de téléphone.

    • Remplacez {BUCKET} par le nom du compartiment Amazon S3.

    • Remplacez {MEDIA_FILE} par le nom du fichier multimédia.

    Vous pouvez également télécharger à l'aide d'une URL présignée en utilisant à la --source-s3-presigned-url place de--source-s3-file. Vous devez ajouter des Content-Type informations dans le headers champ. Si vous utilisez les deux, un InvalidParameterException est renvoyé.

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

  4. Une fois terminé avec succès, MEDIA_ID il est renvoyé. Le MEDIA_ID est utilisé pour référencer le fichier multimédia lors de l'envoi d'un message multimédia.