Exemplo de envio de uma mensagem MMS usando o AWS End User Messaging SMS. - AWS End User Messaging SMS
Pré-requisitosEnvie um MMS com o AWS CLIConfigurar um bucket do Amazon S3

Exemplo de envio de uma mensagem MMS usando o AWS End User Messaging SMS.

Se você estiver usando um recurso compartilhado, deverá usar o nome do recurso da Amazon (ARN) completo do recurso. Você pode usar a AWS CLI API AWS End User Messaging SMS and Voice v2 para enviar mensagens MMS aos seus clientes.

Use o AWS CLI comando send-media-message para enviar uma mensagem MMS. Para obter mais informações sobre como configurar o AWS CLI, consulte Configure a CLI da AWS no Guia do usuário do AWS Command Line Interface.

Importante

Os recursos de MMS só estão disponíveis em alguns países. Para obter mais informações sobre os países com suporte para SMS e MMS, consulte Países e regiões com suporte para mensagens SMS com o AWS End User Messaging SMS e Países e regiões com suporte para mensagens MMS no AWS End User Messaging SMS.

Para verificar se sua identidade de origem é compatível com MMS, consulte. Visualizar o status e as funcionalidades de um número de telefone no AWS End User Messaging SMS

Para usar um recurso compartilhado, você deve usar o nome do recurso da Amazon (ARN) completo.

Pré-requisitos

Antes de começar, certifique-se de que os seguintes pré-requisitos sejam atendidos.

Envie um MMS com o AWS CLI

Os únicos parâmetros necessários para enviar mensagem de mídia são destination-phone-number e origination-identity. Você pode enviar uma mensagem que seja somente texto omitindo o parâmetro media-urls. Você também pode enviar uma mensagem que contenha apenas arquivos de mídia, omitindo o parâmetro message-body.

Para enviar uma mensagem MMS.

  • Na linha de comando, insira o seguinte comando:

    aws pinpoint-sms-voice-v2 --region 'us-east-1' send-media-message --destination-phone-number +12065550150 --origination-identity +14255550120 --message-body 'text body' --media-urls 's3://s3-bucket/media_file.jpg'

    No comando anterior, faça as seguintes alterações:

    • Substitua us-east-1 pelo em que sua Região da AWS identidade de origem está armazenada.

    • Substitua +12065550150 pelo número de telefone de destino.

    • Substitua +14255550120 pela sua identidade de origem. A identidade de origem deve ser ACTIVE e ser capaz de enviar o número de telefone de destino.

    • Substitua o corpo do texto pela sua mensagem de texto.

    • Substitua s3://s3-bucket/media_file.jpg pelo URI S3 do arquivo MMS. Os formatos de arquivo de mídia suportados estão listados em Tipos e tamanho de arquivo MMS e limites de caracteres. Para obter mais informações sobre como criar um bucket do S3 e gerenciar objetos, consulte Configurar um bucket do Amazon S3 para arquivos MMS Criar um bucket e fazer upload de objetos no Guia do usuário do Amazon S3.

Se o AWS End User Messaging SMS aceitar o comando, você receberá o MessageID. Isso significa apenas que o comando foi recebido com sucesso e não que o dispositivo de destino ainda recebeu a mensagem. Para obter uma lista de códigos de erro, consulte Erros do SendMediaMessage.

{
   "MessageId": "string"
}

Configurar um bucket do Amazon S3 para arquivos MMS

Seus arquivos MMS devem ser armazenados em um bucket do Amazon S3. O bucket do Amazon S3 deve estar na Região da AWS mesma Conta da AWS e na mesma. Essas instruções mostram como criar um bucket do Amazon S3, fazer upload de um arquivo e criar o URI 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 Configure a CLI da AWS no Guia do usuário do AWS Command Line Interface.

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

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

No comando anterior:

  • Substitua us-east-1 pela Região da AWS na qual sua identidade de origem compatível com MMS está localizada.

  • Substitua BucketName pelo nome do novo bucket.

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

aws s3 cp SourceFilePathAndName s3://BucketName/FileName

No comando anterior:

  • Substitua SourceFilePathAndName pelo caminho e nome do arquivo a ser copiado.

  • Substitua BucketName pelo nome do bucket.

  • Substitua FileName pelo nome a ser usado para o arquivo.

O URI a ser usado ao enviar é:

s3://BucketName/FileName