View a markdown version of this page

Mengirim pesan file RCS - AWS Pesan SMS Pengguna Akhir
FileMessage strukturSumber URL fileKebijakan bucket S3 untuk pengiriman fileJenis media yang didukung dan batas ukuranThumbnailMengirim 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 Anda. Pesan file muncul sebagai media sebaris di aplikasi perpesanan penerima.

Pesan file berbeda dari media kartu kaya. Pesan file mengirimkan satu media sebagai seluruh 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

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

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

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

ThumbnailUrl (opsional)

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

Sumber URL file

FileUrlParameter menerima dua format URL:

  • Amazon S3 URL s (s3://bucket-name/object-key) — Saat Anda menentukan URL Amazon S3, Pesan Pengguna Ak AWS hir mengambil objek, meng-host ulang objek, dan menghasilkan URL yang ditandatangani sebelumnya terbatas waktu untuk pengiriman ke perangkat penerima. Bucket S3 harus memiliki kebijakan berbasis sumber daya yang memberikan akses baca layanan. Untuk informasi selengkapnya, lihat Kebijakan bucket S3 untuk pengiriman file.

  • HTTPS URL (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 Amazon S3, API memvalidasi pada saat permintaan bahwa objek tersebut ada, berada dalam batas ukuran, dan dapat diakses. Jika validasi gagal, API mengembalikan ValidationException kesalahan dengan pesan kesalahan deskriptif. URL HTTPS tidak divalidasi pada waktu permintaan dengan cara yang sama.

Kebijakan bucket S3 untuk pengiriman file

Untuk mengi AWS zinkan Pesan Pengguna Akhir mengambil file dari bucket S3 Anda, 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:::amzn-s3-demo-bucket/*",
            "Condition": {
                "StringEquals": {
                    "aws:SourceAccount": "123456789012"
                }
            }
        }
    ]
}

Ganti 123456789012 dengan ID akun untuk Anda Akun AWS. Ganti amzn-s3-demo-bucket dengan nama bucket S3 Anda. Untuk membatasi akses ke awalan tertentu di bucket, ganti /* dengan path—misalnya,. arn:aws:s3:::amzn-s3-demo-bucket/rcs-media/*

catatan

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

Jenis media yang didukung dan batas ukuran

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 kodek. Terutama didukung di Android.
audio/mp3 .mp3 100 MB Dukungan pemutaran audio terluas.
audio/aac .aac 100 MB Format audio alternatif.
application/pdf .pdf 100 MB Dukungan bervariasi menurut operator dan wilayah.
penting

Batas ukuran file 100 MB diberlakukan di lapisan API. Operator individu mungkin memberlakukan batas yang lebih rendah 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 dengan menggunakan ThumbnailUrl parameter. Thumbnail ditampilkan sebagai pratinjau dalam percakapan sebelum penerima membuka atau mengunduh file lengkap.

  • Format thumbnail yang didukung adalah JPEG dan PNG.

  • URL thumbnail mengikuti aturan format yang sama seperti FileUrl (Amazon 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) dengan menggunakan parameter. --origination-identity

Contoh JSON berikut menunjukkan RcsMessageContent nilai untuk pesan file dengan saran.

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

Pengiriman dan fallback

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

Anda dapat mengonfigurasi fallback SMS atau MMS di tingkat kumpulan atau per pesan. Untuk detail tentang perilaku fallback, lihatMengirim 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.