View a markdown version of this page

Exemplo de envio de uma mensagem de mídia em AWS Mensagens sociais para o usuário final - 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á.

Exemplo de envio de uma mensagem de mídia em AWS Mensagens sociais para o usuário final

O exemplo a seguir mostra como enviar uma mensagem de mídia para seu cliente usando AWS CLI o. Para obter mais informações sobre como configurar o AWS CLI, consulte Configurar o AWS CLI no Guia do AWS Command Line Interface usuário. Para obter uma lista dos tipos de arquivos de mídia compatíveis, consulteTipos e tamanhos de arquivos de mídia suportados em WhatsApp.

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.

  1. Faça o upload do arquivo de mídia para um bucket do Amazon S3. Para obter mais informações, consulte Carregando arquivos de mídia para enviar com WhatsApp.

  2. 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

  3. Use o comando send-whatsapp-message para enviar a mensagem de mídia.

    aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0
    nota

    Você deve especificar a codificação base64 ao usar a AWS CLI versão 2. Isso pode ser feito adicionando o AWS CLI parâmetro --cli-binary-format raw-in-base64-out ou alterando o arquivo de configuração AWS CLI global. Para obter mais informações, consulte cli_binary_format o Guia do usuário da interface de linha de AWS comando para a versão 2.

    aws socialmessaging send-whatsapp-message --message '{"messaging_product":"whatsapp","to":"'{PHONE_NUMBER}'","type":"image","image":{"id":"'{MEDIA_ID}'"}}' --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID} --meta-api-version v20.0 --cli-binary-format raw-in-base64-out

    No comando anterior, faça o seguinte:

    • {PHONE_NUMBER}Substitua pelo número de telefone do seu cliente.

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

    • {MEDIA_ID}Substitua pela ID de mídia retornada da etapa anterior.

  4. Quando você não precisar mais do arquivo de mídia, poderá excluí-lo WhatsApp usando o comando https://docs.aws.amazon.com/cli/latest/reference/socialmessaging/delete-whatsapp-media-message.html delete-whatsapp-message-media. Isso remove apenas o arquivo de mídia do bucket do Amazon S3 WhatsApp e não.

    aws socialmessaging delete-whatsapp-message-media --media-id {MEDIA_ID} --origination-phone-number-id {ORIGINATION_PHONE_NUMBER_ID}

    No comando anterior, faça o seguinte:

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

    • {MEDIA_ID}Substitua pelo ID da mídia.