View a markdown version of this page

Téléchargement de fichiers multimédia à envoyer avec WhatsApp - AWS Messagerie à l'utilisateur final : réseaux sociaux

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 récupéré depuis WhatsApp. Le compartiment Amazon S3 doit se trouver dans le même Compte AWS compartiment 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 la section Utiliser des commandes de haut niveau (s3) avec l'AWS CLI. Pour plus d'informations sur la configuration de AWS CLI, consultez Configurer l'interface de ligne de commande AWS dans le Guide de AWS Command Line Interface l'utilisateur , et Création d'un compartiment et 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. Consultez la section Upload Media in the WhatsApp Business Platform Cloud API Reference.

Vous pouvez également créer une URL présignée pour 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 demander à un tiers de disposer 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 :

    • Remplacez-le us-east-1 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 :

    • SourceFilePathAndNameRemplacez-le par le chemin du fichier et le nom du fichier à copier.

    • Remplacez BucketName par le nom du compartiment.

    • FileNameRemplacez-le par le nom à utiliser pour le fichier.

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

    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 la suivante : https://amzn-s3-demo-bucket1.s3.af-south-1.amazonaws.com/mydoc.txt?{Headers}

  3. Téléchargez le fichier multimédia à l' WhatsApp aide de la commande https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html post-whatsapp-message-media. En cas de réussite, la commande renverra 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.

    • {BUCKET}Remplacez-le 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 de présignature en utilisant --source-s3-presigned-url au lieu de--source-s3-file. Vous devez ajouter Content-Type 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. En cas de réussite, 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.