View a markdown version of this page

Carregando arquivos de mídia para enviar com WhatsApp - AWS Mensagens sociais para o usuário final

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 com 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 lugar da sua conta WhatsApp comercial (WABA). Região da AWS 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 do AWS Command Line Interface 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 WhatsApp Business Platform Cloud.

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

  1. Para criar um bucket do Amazon S3, use o comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html 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 AWS CLI comando cp. Na linha de comando, insira o seguinte comando:

    aws s3 cp SourceFilePathAndName s3://BucketName/FileName

    No comando anterior:

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

    • Substitua BucketName pelo nome do bucket.

    • FileNameSubstitua pelo nome a ser usado para o 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 o upload do arquivo de mídia WhatsApp usando o comando https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/post-whatsapp-message-media.html post-whatsapp-message-media. 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, ele MEDIA_ID é devolvido. O MEDIA_ID é usado para referenciar o arquivo de mídia ao enviar uma mensagem de mídia.