View a markdown version of this page

Mengirim komidi putar RCS - AWS SMS Pesan Pengguna Akhir
Kapan menggunakan korselStruktur korselSaran kartu dan saran luarTinggi dan pemotongan kartuRasio aspek mediaStruktur Carousel JSONBatas korsel

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

Mengirim komidi putar RCS

Pesan carousel di AWS End User Messaging menampilkan 2 hingga 10 kartu kaya dalam strip yang dapat digulir secara horizontal. Penerima dapat menggulir kartu dan memilih saran pada kartu individu untuk mengambil tindakan. Dengan komidi putar, Anda dapat membuat pengalaman percakapan dan interaktif seperti katalog produk, menu layanan, perbandingan rencana, dan daftar lokasi.

Korsel berbagi model konten kartu yang sama dengan kartu kaya mandiri (lihatMengirim kartu kaya RCS), tetapi kartu carousel selalu menggunakan tata letak vertikal dan tidak mendukung ketinggian media. TALL

penting

Anda dapat mengirim pesan korsel RCS di semua negara tempat RCS didukung.

Kapan menggunakan korsel

Gunakan carousel saat Anda ingin penerima menelusuri dan membandingkan beberapa item dari jenis yang sama. Kasus penggunaan umum meliputi:

  • Katalog produk: Tampilkan beberapa item dengan gambar, deskripsi, dan tombol pembelian.

  • Menu layanan: Tampilkan tingkatan layanan atau opsi berdampingan untuk perbandingan.

  • Perbandingan rencana: Biarkan penerima membandingkan fitur di seluruh paket dan memilih satu.

  • Daftar lokasi: Tampilkan toko atau kantor terdekat dengan alamat dan tindakan peta.

Jika Anda perlu menampilkan satu item dengan konten yang kaya, gunakan kartu kaya mandiri sebagai gantinya. Lihat perinciannya di Mengirim kartu kaya RCS.

Struktur korsel

Anda mendefinisikan korsel dalam Content.Carousel objek dalam RcsMessageContent parameter permintaan. SendRcsMessage Objek carousel berisi dua bidang wajib:

CardWidth(Diperlukan)

Lebar tampilan semua kartu di korsel. Semua kartu memiliki lebar yang sama. Nilai yang benar: SMALL atau MEDIUM.

CardContents(Diperlukan)

Sebuah array dari 2 sampai 10 objek kartu. Setiap kartu dapat berisi judul, deskripsi, media, dan hingga 4 saran.

Nilai lebar kartu

Lebar kartu korsel
Nilai Lebar Terbaik untuk
SMALL 180 DP Daftar ringkas, thumbnail, pengalaman jelajah cepat
MEDIUM 296 DP Kartu terperinci dengan deskripsi yang lebih panjang dan gambar yang lebih besar

Bidang konten kartu

Setiap objek kartu dalam CardContents array mendukung bidang berikut:

Title

Judul kartu. Maksimal 200 karakter.

Description

Teks deskripsi kartu. Maksimal 2.000 karakter.

Media

Gambar atau video untuk ditampilkan pada kartu. Berisi bidang-bidang berikut:

  • FileUrl(wajib): URL file media. Harus cocok dengan polanya^(https://|s3://).+$. Maksimal 2.000 karakter. Ukuran file maksimum adalah 100 MB.

  • ThumbnailUrl(opsional): URL gambar thumbnail ditampilkan saat media penuh dimuat.

  • Height: Ketinggian tampilan media. Nilai yang valid untuk kartu korsel: SHORT atau. MEDIUM TALLKetinggian tidak didukung dalam komidi putar.

Suggestions

Larik hingga 4 balasan atau tindakan yang disarankan yang ditampilkan di bawah konten kartu. Untuk daftar lengkap jenis saran, lihatMengkonfigurasi saran RCS.

Saran kartu dan saran luar

Pesan korsel mendukung dua tingkat saran:

Card-level saran

Setiap kartu dapat menyertakan hingga 4 saran. Ini muncul tepat di bawah konten kartu dan khusus untuk kartu itu (misalnya, “Beli item ini” atau “Lihat detail”).

Saran luar (tingkat pesan)

SuggestionsArray tingkat atas (saudara kandung Content dalam RcsMessageContent struktur) mendefinisikan daftar chip yang muncul di bawah seluruh korsel. Anda dapat menyertakan hingga 11 saran luar per pesan.

Gunakan saran luar untuk tindakan navigasi yang berlaku untuk keseluruhan pesan, seperti “Kembali ke menu”, “Bantuan”, atau “Selesai menjelajah”. Hindari menduplikasi tindakan tingkat kartu di daftar chip luar.

Tinggi dan pemotongan kartu

Semua kartu dalam korsel diskalakan agar sesuai dengan ketinggian kartu tertinggi. Jika konten kartu melebihi tinggi tampilan maksimum, klien pesan memotong konten dalam urutan berikut:

  1. Deskripsi terpotong menjadi satu baris.

  2. Judul terpotong menjadi satu baris.

  3. Saran dihapus.

  4. Deskripsi dihapus.

  5. Judul dihapus (hanya media yang tersisa).

Saat pemotongan diterapkan, indikator “Lainnya” muncul sehingga penerima dapat memperluas kartu ke tampilan layar penuh.

Rasio aspek media

Rasio aspek media kartu tergantung pada kombinasi lebar kartu dan tinggi media.

Rasio aspek kartu lebar sedang
Tinggi Rasio aspek
MEDIUM 4:3
SHORT 2:1
Rasio aspek kartu lebar kecil
Tinggi Rasio aspek
MEDIUM 4:5
SHORT 5:4
catatan

Ketinggian TALL media tidak didukung dalam kartu korsel. Untuk media tinggi, gunakan kartu kaya mandiri. Lihat Mengirim kartu kaya RCS.

Struktur Carousel JSON

JSON berikut menunjukkan struktur RcsMessageContent parameter untuk pesan carousel:

{
  "Content": {
    "Carousel": {
      "CardWidth": "SMALL | MEDIUM",
      "CardContents": [
        {
          "Title": "Card title (max 200 chars)",
          "Description": "Card description (max 2000 chars)",
          "Media": {
            "FileUrl": "https://example.com/image.jpg",
            "ThumbnailUrl": "https://example.com/thumb.jpg",
            "Height": "SHORT | MEDIUM"
          },
          "Suggestions": [
            {
              "Reply": {
                "Text": "Button label (max 25 chars)",
                "PostbackData": "callback_data"
              }
            }
          ]
        }
      ]
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Outer chip label",
        "PostbackData": "outer_callback"
      }
    }
  ]
}

Nilai ini diteruskan sebagai string JSON dalam --rcs-message-content parameter (CLI) atau parameter (RcsMessageContentSDK). Anda juga menentukan --destination-phone-number dan --origination-identity (agen pool atau RCS) dalam send-rcs-message permintaan.

Batas korsel

Batas pesan korsel
Parameter Minimum Maksimum
Kartu per korsel 2 10
Saran per kartu 0 4
Saran luar per pesan 0 11
Panjang judul - 200 karakter
Deskripsi panjang - 2.000 karakter
Ukuran file media - 100 MB
Ukuran muatan total - 250 KB

Untuk format media dan detail pengiriman, lihatMengirim pesan file RCS.