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 MMS usando AWS Mensagens SMS para o usuário final
Se você estiver usando um recurso compartilhado, deverá usar o nome do recurso da Amazon (ARN) completo do recurso. Você pode usar a API AWS CLI ou 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 Configurar o AWS CLI no Guia do AWS Command Line Interface usuário.
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 compatíveis para mensagens SMS com AWS Mensagens SMS para o usuário final e Países e regiões com suporte para mensagens MMS em AWS Mensagens SMS para o usuário final.
Para verificar se sua identidade de origem é compatível com MMS, consulte. Visualize o status e os recursos de um número de telefone em AWS Mensagens SMS para o usuário final
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.
-
Você deve ter uma identidade de origem que ofereça suporte ao envio de uma mensagem MMS.
-
Você deve carregar seus arquivos de mídia em um bucket do Amazon S3 que tenha a Região da AWS mesma identidade de origem compatível com MMS, consulte. Configurar um bucket do Amazon S3 para arquivos MMS
Para obter uma lista dos tipos e tamanhos de arquivos compatíveis, consulte .
Os URIs do S3 de cada arquivo MMS.
A identidade usada para fazer a chamada
send-media-messagedeve ter acesso de leitura ao bucket do Amazon S3 que contém seus arquivos de mídia. Para obter mais informações sobre como configurar o acesso de leitura, consulte exemplos Identity-based de políticas para o Amazon S3 no Guia do usuário do Amazon S3.
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:
-
us-east-1Substitua pela em Região da AWS que sua identidade de origem está armazenada. -
+12065550150Substitua pelo número de telefone de destino. -
+14255550120Substitua por sua identidade de origem. A identidade de origem deve serACTIVEe ser capaz de enviar o número de telefone de destino. -
text bodySubstitua por sua mensagem de texto. -
s3://s3-bucket/media_file.jpgSubstitua 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 AWS o SMS de mensagens do usuário final aceitar o comando, você receberá MessageID o. 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 SendMediaMessage Erros.
{
"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 mesma identidade Conta da AWS de Região da AWS origem compatível com MMS. 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 Configurar o AWS CLI no Guia do AWS Command Line Interface usuário.
Para criar um bucket do Amazon S3, use o comando https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html
aws s3api create-bucket --region 'us-east-1' --bucketBucketName
No comando anterior:
-
us-east-1Substitua pela que Região da AWS sua identidade de origem compatível com MMS está em. BucketNameSubstitua pelo nome do novo bucket.
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 cpSourceFilePathAndNames3://BucketName/FileName
No comando anterior:
SourceFilePathAndNameSubstitua pelo caminho e nome do arquivo a ser copiado.Substitua
BucketNamepelo nome do bucket.FileNameSubstitua pelo nome a ser usado para o arquivo.
O URI a ser usado ao enviar é:
s3://BucketName/FileName