View a markdown version of this page

Mengirim pesan teks RCS - AWS SMS Pesan Pengguna Akhir
Bagaimana pesan teks RCS berbeda dari SMSRcsMessageContent struktur untuk pesan teksMengirim pesan teksFallback SMS atau MMSBatas pesan teksKapan menggunakan pesan teks

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

Mengirim pesan teks RCS

A TextMessage adalah jenis konten paling sederhana yang dapat Anda kirim dengan SendRcsMessage API. Ini terdiri dari badan teks biasa (hingga 3.072 karakter) dengan chip saran opsional yang muncul sebagai tombol interaktif di bawah pesan.

Bagaimana pesan teks RCS berbeda dari SMS

Pesan teks yang dikirim melalui SendRcsMessage berbeda dari yang dikirim melalui SendTextMessage (SMS) dalam dua cara:

  • Chip saran: Anda dapat melampirkan hingga 11 chip saran ke pesan teks RCS. Dengan chip ini, penerima dapat membalas, membuka URL, menghubungi nomor telepon, berbagi lokasi, atau membuat acara kalender dalam satu langkah. SMS tidak mendukung saran.

  • Single-message pengiriman: Pesan teks RCS tiba sebagai pesan tunggal terlepas dari panjangnya (hingga 3.072 karakter). Operator membagi pesan SMS lebih dari 160 karakter menjadi beberapa segmen, yang mungkin tiba rusak atau dengan penundaan antar segmen.

Untuk detail tentang semua jenis saran yang tersedia dan parameternya, lihatMengkonfigurasi saran RCS.

RcsMessageContent struktur untuk pesan teks

Saat Anda meneleponSendRcsMessage, Anda meneruskan payload pesan sebagai RcsMessageContent parameter. Untuk pesan teks, atur Content bidang ke TextMessage objek yang berisi Body string. Untuk memasukkan chip saran, tambahkan Suggestions array sebagai saudara tingkat atas. Content

Cuplikan JSON berikut menunjukkan struktur RcsMessageContent untuk pesan teks dengan saran:

{
  "Content": {
    "TextMessage": {
      "Body": "What would you like to do?"
    }
  },
  "Suggestions": [
    {
      "Reply": {
        "Text": "Check order status",
        "PostbackData": "action=check_order"
      }
    },
    {
      "OpenUrl": {
        "Text": "View details",
        "PostbackData": "action=view",
        "Url": "https://example.com/orders/1234"
      }
    }
  ]
}

Dalam contoh ini:

  • Content.TextMessage.Bodyberisi teks pesan (wajib, 1 hingga 3.072 karakter).

  • Suggestionsadalah array tingkat atas (opsional, hingga 11 item). Setiap saran membutuhkan Text bidang (hingga 25 karakter) dan PostbackData bidang (hingga 2.048 karakter).

SuggestionsArray mendukung enam jenis tindakan:Reply,OpenUrl,DialPhone,ShowLocation,RequestLocation, danCreateCalendarEvent. Anda dapat mencampur berbagai jenis saran dalam satu pesan. Untuk detail lengkap tentang setiap jenis, lihatMengkonfigurasi saran RCS.

Mengirim pesan teks

Untuk mengirim pesan teks RCS, hubungi SendRcsMessage dengan parameter yang diperlukan berikut:

  • DestinationPhoneNumber: Nomor telepon penerima dalam E.164 format.

  • OriginationIdentity: ID pool atau AWS RCS Agent yang mengirimkan pesan.

  • RcsMessageContent: String JSON berisi Content dengan TextMessage objek.

Anda memanggil API menggunakan AWS CLI (aws pinpoint-sms-voice-v2 send-rcs-message) atau AWS SDK seperti klien boto3. pinpoint-sms-voice-v2

Fallback SMS atau MMS

Jika perangkat penerima tidak mendukung RCS atau sementara tidak dapat dijangkau di saluran RCS, Anda dapat mengonfigurasi pesan untuk kembali ke SMS atau MMS. Untuk mengaktifkan fallback, sertakan FallbackConfiguration objek dalam permintaan AndaSendRcsMessage. FallbackConfigurationMenentukan saluran fallback (SMSatauMMS), badan pesan fallback, dan identitas originasi (nomor telepon atau ID pengirim) yang akan digunakan untuk pesan fallback.

Fallback adalah opsional. Jika Anda menghilangkan FallbackConfiguration dan penerima tidak dapat menerima RCS, pesan tidak terkirim.

Untuk informasi selengkapnya tentang mengonfigurasi perilaku fallback, lihat. Mengirim pesan RCS yang kaya

Batas pesan teks

Sumber daya Kuota Catatan
Tubuh pesan (Body) 3.072 karakter () UTF-8 Wajib. Harus mengandung setidaknya 1 karakter.
Saran per pesan 11 Gabungan total balasan dan tindakan.
Saran tampilan teks () Text 25 karakter Berlaku untuk semua jenis saran.
Data postback () PostbackData 2.048 karakter Diperlukan untuk semua jenis saran.

Kapan menggunakan pesan teks

Gunakan TextMessage untuk:

  • Pemberitahuan seperti konfirmasi pesanan, pembaruan pengiriman, dan pengingat janji temu.

  • One-time kata sandi dan kode verifikasi.

  • Permintaan percakapan yang menawarkan opsi balasan sebagai chip saran, memungkinkan interaksi terpandu tanpa input teks gratis.

  • Pembaruan status singkat di mana konten tidak memerlukan gambar atau tata letak terstruktur.

Untuk pesan yang memerlukan gambar, video, atau tata letak terstruktur dengan judul dan deskripsi, gunakan kartu kaya atau komidi putar sebagai gantinya. Lihat Mengirim pesan RCS yang kaya.