

Terjemahan disediakan oleh mesin penerjemah. Jika konten terjemahan yang diberikan bertentangan dengan versi bahasa Inggris aslinya, utamakan versi bahasa Inggris.

# Contoh pengiriman pesan MMS menggunakan AWS End User Messaging SMS
<a name="send-mms-message"></a>

Jika Anda menggunakan sumber daya bersama maka Anda harus menggunakan Nama Sumber Daya Amazon (ARN) lengkap dari sumber daya tersebut. Anda dapat menggunakan AWS CLI atau AWS End User Messaging SMS dan voice v2 API untuk mengirim pesan MMS ke pelanggan Anda.

Gunakan [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html) AWS CLI perintah untuk mengirim pesan MMS. Untuk informasi selengkapnya tentang mengonfigurasi AWS CLI, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) di Panduan Pengguna [AWS Command Line Interface .](https://docs.aws.amazon.com/cli/latest/userguide/)

**penting**  
Kemampuan MMS hanya tersedia di beberapa negara. Untuk informasi lebih lanjut tentang negara-negara yang didukung untuk SMS dan MMS, lihat [Negara dan wilayah yang didukung untuk pesan SMS dengan AWS End User Messaging SMS](phone-numbers-sms-by-country.md) dan[Negara dan wilayah yang didukung untuk pesan MMS di SMS Pesan Pengguna AWS Akhir](phone-numbers-mms-by-country.md).  
Untuk memeriksa apakah identitas originasi Anda mampu MMS, lihat. [Melihat status dan kemampuan nomor telepon di SMS Pesan Pengguna AWS Akhir](phone-numbers-status.md)   
Untuk menggunakan sumber daya bersama, Anda harus menggunakan Nama Sumber Daya Amazon (ARN) lengkap.

## Prasyarat
<a name="send-mms-message-prerequisite"></a>

Sebelum Anda mulai, prasyarat berikut harus dipenuhi:
+ Anda harus memiliki identitas originasi yang [mendukung pengiriman pesan MMS](phone-numbers-mms-by-country.md#phone-numbers-mms-by-country.title). 
+ Anda harus mengunggah file media Anda ke bucket Amazon S3 yang Wilayah AWS sama dengan identitas originasi berkemampuan MMS Anda, lihat. [Menyiapkan bucket Amazon S3 untuk file MMS](#send-mms-message-bucket)

  Untuk daftar jenis dan ukuran file dukungan, lihat [ Jenis file MMS, ukuran dan batas karakter  Pelajari tentang ukuran file MMS, batasan jenis file, dan jumlah maksimum charter yang dapat berisi mms.  Jenis file MMSUkuran file MMSbatas karakter mms  File media MMS tunggal dapat mencapai 2 MB untuk semua jenis gambar (gif, jpeg, png) dan ukuran 600 KB untuk semua jenis file media audio dan video. Badan pesan teks MMS dapat berisi 1600 dari set karakter apa pun. Tidak seperti SMS, pesan MMS tidak dipecah menjadi beberapa bagian saat dikirim. Jika Anda mengirim pesan teks besar Anda mungkin mendapatkan throughput yang lebih baik mengirim pesan MMS karena mereka tidak dipecah menjadi beberapa bagian. 


****  

| Tipe file | Jenis MIME | Ukuran maksimum file | 
| --- | --- | --- | 
| Format Pertukaran Grafis |  `image/gif`  | 2 MB | 
| Kelompok Ahli Fotografi Bersama |  `image/jpeg`  | 2 MB | 
| Grafik Jaringan Portabel  |  `image/png`  | 2 MB | 
| Tag format file gambar |  `image/tiff`  | 600 KB | 
| Proyek kemitraan generasi ketiga  |  `audio/3gpp`, `video/3gpp`  | 600 KB | 
| Proyek kemitraan generasi ketiga 2  |  `audio/3gpp2`, `video/3gpp2`  | 600 KB | 
| Multi-Tingkat Adaptif |  `audio/amr`  | 600 KB | 
| MPEG-4 |  `audio/mp4`, `video/mp4`  | 600 KB | 
| Kelompok ahli gambar bergerak |  `audio/mpeg` Hanya MP3 file yang didukung untuk `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 | 
| Format Dokumen Portabel |  `application/pdf`  | 600 KB |  ](mms-limitations-character.md#mms-limitations-character.title)
+ S3 URIs dari setiap file MMS. 
+ Identitas yang digunakan untuk menelepon `send-media-message` harus memiliki akses baca ke bucket Amazon S3 yang berisi file media Anda. [Untuk informasi selengkapnya tentang pengaturan akses baca, lihat [Contoh kebijakan berbasis identitas untuk Amazon S3 di Panduan Pengguna Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/example-policies-s3.html).](https://docs.aws.amazon.com/AmazonS3/latest/userguide/)

## Kirim MMS dengan AWS CLI
<a name="send-mms-message-steps"></a>

Satu-satunya parameter yang diperlukan untuk [send-media-message](https://docs.aws.amazon.com/cli/latest/reference/pinpoint-sms-voice-v2/send-media-message.html)adalah `destination-phone-number` dan`origination-identity`. Anda dapat mengirim pesan yang hanya teks dengan menghilangkan `media-urls` parameter. Anda juga dapat mengirim pesan hanya file media dengan menghilangkan `message-body` parameter.

**Untuk mengirim pesan MMS**
+ Di baris perintah, masukkan perintah berikut:

  ```
  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'
  ```

  Di perintah sebelumnya, lakukan perubahan berikut:
  + Ganti *us-east-1* dengan tempat Wilayah AWS identitas originasi Anda disimpan.
  + Ganti *\$112065550150* dengan nomor telepon tujuan.
  + Ganti *\$114255550120* dengan identitas originasi Anda. Identitas originasi harus `ACTIVE` dan dapat mengirim nomor telepon tujuan.
  + Ganti *text body* dengan pesan teks Anda.
  + Ganti *s3://s3-bucket/media\$1file.jpg* dengan URI S3 dari file MMS. Format file media yang didukung tercantum dalam[Jenis file MMS, ukuran dan batas karakter](mms-limitations-character.md). Untuk informasi selengkapnya tentang membuat bucket S3 dan mengelola objek, lihat [Menyiapkan bucket Amazon S3 untuk file MMS](#send-mms-message-bucket) atau [Membuat bucket](https://docs.aws.amazon.com/AmazonS3/latest/userguide/create-bucket-overview.html) dan [Mengunggah objek di Panduan](https://docs.aws.amazon.com//AmazonS3/latest/userguide/upload-objects.html) Pengguna [Amazon S3](https://docs.aws.amazon.com/AmazonS3/latest/userguide/).

Jika AWS End User Messaging SMS menerima perintah, Anda akan menerima. `MessageID` Ini hanya berarti perintah berhasil diterima dan bukan bahwa perangkat tujuan telah menerima pesan belum. Untuk daftar kode kesalahan, lihat [SendMediaMessage Kesalahan](https://docs.aws.amazon.com/pinpoint/latest/apireference_smsvoicev2/API_SendMediaMessage.html#API_SendMediaMessage_Errors).

```
{
   "MessageId": "string"
}
```

## Menyiapkan bucket Amazon S3 untuk file MMS
<a name="send-mms-message-bucket"></a>

File MMS Anda harus disimpan dalam bucket Amazon S3. Bucket Amazon S3 harus sama Akun AWS dan Wilayah AWS sebagai identitas originasi yang mampu MMS Anda. Petunjuk ini menunjukkan cara membuat bucket Amazon S3, mengunggah file, dan membuat URI ke file. Untuk informasi selengkapnya tentang perintah Amazon S3, lihat [Menggunakan perintah tingkat tinggi (s3) dengan AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html). Untuk informasi selengkapnya tentang mengonfigurasi AWS CLI, lihat [Mengonfigurasi AWS CLI](https://docs.aws.amazon.com/cli/latest/userguide/cli-chap-configure.html) di Panduan Pengguna [AWS Command Line Interface .](https://docs.aws.amazon.com/cli/latest/userguide/)

Untuk membuat bucket Amazon S3 gunakan perintah [AWS CLI create-bucket](https://awscli.amazonaws.com/v2/documentation/api/latest/reference/s3api/create-bucket.html). Di baris perintah, masukkan perintah berikut:

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

Dalam perintah sebelumnya:
+ Ganti *us-east-1* dengan identitas originasi berkemampuan MMS Wilayah AWS Anda.
+ Ganti *BucketName* dengan nama ember baru.

Untuk menyalin file ke bucket Amazon S3 gunakan perintah [cp](https://docs.aws.amazon.com/cli/latest/userguide/cli-services-s3-commands.html#using-s3-commands-managing-objects-copy) AWS CLI . Di baris perintah, masukkan perintah berikut:

```
aws s3 cp SourceFilePathAndName s3://BucketName/FileName 
```

Dalam perintah sebelumnya:
+ Ganti *SourceFilePathAndName* dengan jalur file dan nama file yang akan disalin.
+ Ganti *BucketName* dengan nama ember.
+ Ganti *FileName* dengan nama yang akan digunakan untuk file.

URI yang digunakan saat mengirim adalah:

```
s3://BucketName/FileName
```