Carregando arquivos de mídia para enviar WhatsApp - AWS Mensagens sociais para usuários finais

As traduções são geradas por tradução automática. Em caso de conflito entre o conteúdo da tradução e da versão original em inglês, a versão em inglês prevalecerá.

Carregando arquivos de mídia para enviar WhatsApp

Quando você envia ou recebe um arquivo de mídia, ele precisa ser armazenado em um bucket do Amazon S3 e carregado ou recuperado. WhatsApp O bucket do Amazon S3 deve estar no mesmo Conta da AWS e Região da AWS na sua conta WhatsApp comercial (WABA). Essas instruções mostram como criar um bucket do Amazon S3, fazer upload de um arquivo e criar a URL para o arquivo. Para obter mais informações sobre os comandos do Amazon S3, consulte Usar comandos de alto nível (s3) com a AWS CLI. Para obter mais informações sobre como configurar o AWS CLI, consulte Configurar a AWS CLI no Guia AWS Command Line Interface do usuário e Criar um bucket e fazer upload de objetos no Guia do usuário do Amazon S3.

nota

WhatsApp armazena arquivos de mídia por 30 dias antes de excluí-los, consulte Carregar mídia na Referência da API Cloud da WhatsApp Business Platform.

Você também pode criar uma URL pré-assinada para o arquivo de mídia. Com um URL pré-assinado, você pode conceder acesso por tempo limitado aos objetos e carregá-los sem exigir que outra pessoa tenha credenciais ou permissões AWS de segurança.

  1. Para criar um bucket do Amazon S3, use o comando AWS CLI create-bucket. Na linha de comando, insira o seguinte comando:

    aws s3api create-bucket --region 'us-east-1' --bucket BucketName

    No comando anterior:

    • us-east-1Substitua pelo em Região da AWS que seu WABA está.

    • BucketNameSubstitua pelo nome do novo bucket.

  2. Para copiar um arquivo para o bucket do Amazon S3, use o comando cp AWS CLI . Na linha de comando, insira o seguinte comando:

    aws s3 cp SourceFilePathAndName s3://BucketName/FileName

    No comando anterior:

    • SourceFilePathAndNameSubstitua pelo caminho do arquivo e pelo nome do arquivo a ser copiado.

    • Substitua BucketName pelo nome do bucket.

    • FileNameSubstitua pelo nome a ser usado no arquivo.

    O URL a ser usado ao enviar é:

    s3://BucketName/FileName

    Para criar um URL pré-assinado, substitua-o por suas próprias informações. user input placeholders

    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

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

  3. Faça upload do arquivo de mídia WhatsApp usando o post-whatsapp-message-mediacomando. Após a conclusão bem-sucedida, o comando retornará o{MEDIA_ID}, que é necessário para enviar a mensagem de mídia.

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

    No comando anterior, faça o seguinte:

    • {ORIGINATION_PHONE_NUMBER_ID}Substitua pelo ID do seu número de telefone.

    • {BUCKET}Substitua pelo nome do bucket do Amazon S3.

    • {MEDIA_FILE}Substitua pelo nome do arquivo de mídia.

    Você também pode fazer o upload usando um URL predefinido usando --source-s3-presigned-url em vez de--source-s3-file. Você deve adicionar Content-Type no headers campo. Se você usar os dois, um InvalidParameterException será retornado.

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

  4. Após a conclusão bem-sucedida, o MEDIA_ID é retornado. O MEDIA_ID é usado para referenciar o arquivo de mídia ao enviar uma mensagem de mídia.