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 SMS de mensagens de usuário AWS final
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 [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI comando para enviar uma mensagem MMS. Para obter mais informações sobre como configurar o AWS CLI, consulte [Configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) no Guia [AWS Command Line Interface do](https://docs.aws.amazon.com/cli/latest/userguide/) 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 com suporte para mensagens SMS com o AWS End User Messaging SMS](phone-numbers-sms-by-country.md) e [Países e regiões com suporte para mensagens MMS em SMS de mensagens de usuário AWS final](phone-numbers-mms-by-country.md).
Para verificar se sua identidade de origem é compatível com MMS, consulte. [Exibir o status e os recursos de um número de telefone no SMS de mensagens para o usuário AWS final](phone-numbers-status.md)
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.](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title)
+ Você deve carregar seus arquivos de mídia em um bucket do Amazon S3 que seja Região da AWS igual à sua identidade de origem compatível com MMS, consulte. [Configurar um bucket do Amazon S3 para arquivos MMS](#send-mms-message-bucket)
Para obter uma lista dos tipos e tamanhos de arquivos compatíveis, consulte [ Tipos e tamanho de arquivo MMS e limites de caracteres Saiba mais sobre o tamanho do arquivo MMS, as limitações do tipo de arquivo e o número máximo de caracteres que um mms pode conter. Tipos de arquivo MMSTamanho do arquivo MMSlimite de caracteres de mms Um único arquivo de mídia MMS pode ter até 2 MB para todos os tipos de imagem (GIF, JPEG, PNG) e até 600 KB para todos os tipos de arquivos de mídia de áudio e vídeo. O corpo da mensagem de texto de um MMS pode conter 1600 de qualquer conjunto de caracteres. Ao contrário do SMS, as mensagens MMS não são divididas em várias partes quando são enviadas. Se você estiver enviando uma mensagem de texto grande, poderá obter melhor throughput ao enviar uma mensagem MMS, já que elas não são divididas em várias partes.
****
| Tipo de arquivo | Tipos MIME | Tamanho máximo do arquivo |
| --- | --- | --- |
| Formato de intercâmbio de gráficos | `image/gif` | 2 MB |
| Grupo Conjunto de Especialistas em Fotografia | `image/jpeg` | 2 MB |
| Portable Network Graphics | `image/png` | 2 MB |
| Formato de arquivo de imagem de tag | `image/tiff` | 600 KB |
| Projeto de parceria de terceira geração | `audio/3gpp`, `video/3gpp` | 600 KB |
| Projeto de parceria de terceira geração 2 | `audio/3gpp2`, `video/3gpp2` | 600 KB |
| Taxa múltipla adaptável | `audio/amr` | 600 KB |
| MPEG-4 | `audio/mp4`, `video/mp4` | 600 KB |
| Grupo de especialistas em imagens em movimento | `audio/mpeg` Somente MP3 arquivos são suportados para `audio/mpeg` | 600 KB |
| Ogg | `audio/ogg` | 600 KB |
| QuickTime | `video/quicktime` | 600 KB |
| WebM | `video/webm` | 600 KB |
| iCalendar | `text/calendar` | 600 KB |
| vCard | `text/vcard`, `text/x-vcard` | 600 KB |
| Portable Document Format | `application/pdf` | 600 KB | ](mms-limitations-character.md#mms-limitations-character.title).
+ O S3 URIs de cada arquivo MMS.
+ A identidade usada para fazer a chamada `send-media-message` deve ter acesso de leitura ao bucket do Amazon S3 que contém seus arquivos de mídia. Para obter mais informações sobre como definir acesso de leitura, consulte [Exemplos de políticas baseadas em identidade para o Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html) no [Guia do usuário do Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
## Envie um MMS com o AWS CLI
Os únicos parâmetros necessários para [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)são `destination-phone-number` `origination-identity` e. 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-1*Substitua pela em Região da AWS que sua identidade de origem está armazenada.
+ *\$112065550150*Substitua pelo número de telefone de destino.
+ *\$114255550120*Substitua por sua identidade de origem. A identidade de origem deve ser `ACTIVE` e ser capaz de enviar o número de telefone de destino.
+ *text body*Substitua por sua mensagem de texto.
+ *s3://s3-bucket/media\$1file.jpg*Substitua 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](mms-limitations-character.md). 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](#send-mms-message-bucket) [Criar um bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) e [fazer upload de objetos](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html) no Guia do usuário do [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).
Se AWS o End User Messaging SMS 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](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors).
```
{
"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 de origem compatível com MMS Conta da AWS e Região da AWS com a mesma identidade de origem. 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](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html). Para obter mais informações sobre como configurar o AWS CLI, consulte [Configurar a AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) no Guia [AWS Command Line Interface do](https://docs.aws.amazon.com/cli/latest/userguide/) usuário.
Para criar um bucket do Amazon S3, use o comando [AWS CLI create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html). Na linha de comando, insira o seguinte comando:
```
aws s3api create-bucket --region 'us-east-1' --bucket BucketName
```
No comando anterior:
+ *us-east-1*Substitua pela Região da AWS sua identidade de origem compatível com MMS.
+ *BucketName*Substitua pelo nome do novo bucket.
Para copiar um arquivo para o bucket do Amazon S3, use o comando [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI . Na linha de comando, insira o seguinte comando:
```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName
```
No comando anterior:
+ *SourceFilePathAndName*Substitua pelo caminho do arquivo e pelo nome do arquivo a ser copiado.
+ Substitua *BucketName* pelo nome do bucket.
+ *FileName*Substitua pelo nome a ser usado no arquivo.
O URI a ser usado ao enviar é:
```
s3://BucketName/FileName
```