View a markdown version of this page

Mengirim pesan file RCS - AWS SMS Pesan Pengguna Akhir
FileMessage strukturSumber URL fileKebijakan bucket S3 untuk pengiriman fileJenis media dan batas ukuran yang didukungThumbnailMengirim pesan filePengiriman dan fallback

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

Mengirim pesan file RCS

Anda dapat menggunakan jenis FileMessage konten di SendRcsMessage API untuk mengirim gambar, video, file audio, dan PDF sebagai pesan mandiri ke penerima. Pesan file muncul sebagai media sebaris di aplikasi perpesanan penerima.

Pesan file berbeda dari media kartu kaya. Pesan file memberikan satu bagian media sebagai keseluruhan konten pesan, sementara kartu kaya menggabungkan media dengan teks dan tindakan yang disarankan. Untuk informasi tentang kartu kaya, lihatMengirim kartu kaya RCS.

Anda dapat melampirkan saran tingkat pesan (seperti chip balasan atau tombol tindakan) ke pesan file. Untuk detail tentang saran, lihatMengkonfigurasi saran RCS.

FileMessage struktur

FileMessageObjek bersarang di dalam Content bidang RcsMessageContent parameter. Message-levelSuggestionsadalah saudara kandung Content (tidak bersarang di dalamnya).

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/campaigns/welcome-image.png",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/welcome-thumb.jpg"
        }
    },
    "Suggestions": []
}
FileUrl(diperlukan)

URL S3 atau HTTPS dari file yang akan dikirim. Panjang maksimum adalah 2.000 karakter. URL harus cocok dengan pola^(https://|s3://).+$. Ukuran file maksimum adalah 100 MB.

ThumbnailUrl (opsional)

URL S3 atau HTTPS dari gambar thumbnail. Panjang maksimum adalah 2.000 karakter. Mengikuti pola URL yang sama sepertiFileUrl. Direkomendasikan untuk file video dan PDF.

Sumber URL file

FileUrlParameter menerima dua format URL:

  • URL Amazon S3 (). s3://bucket-name/object-key Saat Anda menentukan URL S3, AWS End User Messaging akan mengambil objek, menghostingnya kembali, dan menghasilkan URL presigned terbatas waktu untuk pengiriman ke perangkat penerima. Bucket S3 harus memiliki kebijakan berbasis sumber daya yang memberikan akses baca layanan. Lihat Kebijakan bucket S3 untuk pengiriman file.

  • URL HTTPS (https://cdn.example.com/path/to/file.jpg). URL diteruskan ke operator untuk pengiriman. URL harus dapat diakses publik tanpa otentikasi. http://URL biasa tidak didukung.

catatan

Saat Anda menggunakan URL S3, API memvalidasi pada saat permintaan objek ada, berada dalam batas ukuran, dan dapat diakses. Jika validasi gagal, API mengembalikan pesan ValidationException kesalahan deskriptif. URL HTTPS tidak divalidasi pada waktu permintaan dengan cara yang sama.

Kebijakan bucket S3 untuk pengiriman file

Agar Pesan Pengguna AWS Akhir dapat mengambil file dari bucket Amazon S3, lampirkan kebijakan berbasis sumber daya berikut ke bucket:

{
    "Version": "2012-10-17", 
    "Statement": [
        {
            "Effect": "Allow",
            "Principal": {
                "Service": "sms-voice.amazonaws.com"
            },
            "Action": "s3:GetObject",
            "Resource": "arn:aws:s3:::YOUR-BUCKET/*"
        }
    ]
}

Ganti YOUR-BUCKET dengan nama bucket Anda. Untuk membatasi akses ke awalan tertentu, ganti /* dengan jalur yang diinginkan (misalnya,arn:aws:s3:::YOUR-BUCKET/rcs-media/*).

catatan

Jika bucket menggunakan SSE-KMS enkripsi, Anda juga harus memberikan izin sms-voice.amazonaws.com layanan untuk menggunakan kunci KMS dalam kebijakan kunci. SSE-S3 enkripsi tidak memerlukan konfigurasi tambahan.

Jenis media dan batas ukuran yang didukung

Tabel berikut mencantumkan jenis media yang didukung olehFileMessage.

Tipe MIME Ekstensi Ukuran maksimum Catatan
image/jpeg .jpeg, .jpg 100 MB Direkomendasikan untuk foto.
image/png .png 100 MB Mendukung transparansi. Direkomendasikan untuk grafis dan logo.
image/gif .gif 100 MB GIF animasi diputar di Android. Dirender sebagai statis di iOS.
video/mp4 .mp4 5 MB H.264 codec direkomendasikan untuk kompatibilitas terluas.
video/webm .webm 5 MB VP8/VP9 codec. Terutama didukung di Android.
audio/mp3 .mp3 100 MB Dukungan pemutaran terluas untuk audio.
audio/aac .aac 100 MB Format audio alternatif.
application/pdf .pdf 100 MB Support bervariasi menurut operator dan wilayah.
penting

Batas ukuran file 100 MB diberlakukan pada lapisan API. Masing-masing operator mungkin memberlakukan batas bawah untuk pengiriman ke perangkat akhir. Untuk video, operator biasanya menerapkan maksimum 5 MB. Simpan file video di bawah 5 MB untuk memastikan pengiriman berhasil.

Thumbnail

Anda dapat memberikan gambar thumbnail untuk pesan file video dan PDF menggunakan parameter. ThumbnailUrl Thumbnail ditampilkan sebagai pratinjau dalam percakapan sebelum penerima membuka atau mengunduh file lengkap.

  • Format thumbnail yang didukung: JPEG, PNG.

  • URL thumbnail mengikuti aturan format yang sama seperti FileUrl (S3 atau HTTPS, maksimum 2.000 karakter).

  • Gunakan rasio aspek yang cocok dengan file asli untuk menghindari pemotongan pada perangkat.

Mengirim pesan file

Untuk mengirim pesan file, panggil SendRcsMessage API dengan FileMessage objek di dalam RcsMessageContent parameter. Anda menentukan identitas originasi (kumpulan atau Agen AWS RCS) menggunakan parameter. --origination-identity

JSON berikut menunjukkan RcsMessageContent nilai untuk pesan file dengan saran:

{
    "Content": {
        "FileMessage": {
            "FileUrl": "s3://my-media-bucket/documents/invoice.pdf",
            "ThumbnailUrl": "s3://my-media-bucket/thumbnails/invoice-thumb.jpg"
        }
    },
    "Suggestions": [
        {
            "Reply": {
                "Text": "Download receipt",
                "PostbackData": "action=download_receipt"
            }
        }
    ]
}

Pengiriman dan fallback

Saat Anda mengirim pesan file, AWS End User Messaging mencoba mengirimkannya melalui saluran RCS. Jika perangkat penerima tidak mendukung RCS, atau jika pesan kedaluwarsa sebelum pengiriman (berdasarkan TimeToLive nilainya), layanan dapat kembali ke SMS atau MMS tergantung pada konfigurasi fallback Anda.

Anda dapat mengonfigurasi fallback SMS atau MMS di tingkat kolam renang atau per pesan. Untuk detail tentang perilaku mundur, lihat. Mengirim pesan RCS yang kaya

penting

Pesan file RCS tersedia di semua negara di mana RCS didukung. Untuk daftar saat ini, lihatNegara yang didukung untuk RCS.