Exemplo de envio de uma mensagem de mídia no AWS End User Messaging Social - 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á.

Exemplo de envio de uma mensagem de mídia no AWS End User Messaging Social

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 Cloud da WhatsApp Business Platform.

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

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

  3. Use o send-whatsapp-messagecomando 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_formato 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 da mídia retornada da etapa anterior.

  4. Quando você não precisar mais do arquivo de mídia, poderá excluí-lo WhatsApp usando o delete-whatsapp-message-mediacomando. Isso remove apenas o arquivo de mídia do bucket do Amazon S3, WhatsApp e não do seu bucket.

    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 pela ID da mídia.