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

Mengkonfigurasi saran RCS

Saran adalah chip interaktif yang muncul di bawah atau dalam pesan RCS. Mereka memandu penerima melalui percakapan dengan menyajikan balasan dan tindakan yang telah ditentukan, seperti membuka URL, memanggil nomor telepon, atau berbagi lokasi, tanpa mengharuskan penerima mengetik. Saran adalah bagaimana Anda membangun pengalaman interaktif dan percakapan denganSendRcsMessage.

Anda dapat menambahkan saran ke jenis konten apa pun (teks, file, kartu kaya, dan korsel) pada dua tingkat:

AWSEnd User Messaging mendukung enam jenis saran:Reply,OpenUrl,DialPhone,, ShowLocationRequestLocation, danCreateCalendarEvent. Setiap saran membutuhkan Text label (hingga 25 karakter) dan PostbackData (hingga 2.048 karakter).

Cara kerja data postback

Setiap saran menyertakan PostbackData string hingga 2.048 karakter yang dikirim oleh AWS End User Messaging kembali ke aplikasi Anda saat penerima memilih saran. Data postback tidak terlihat oleh penerima. Gunakan untuk menyandikan informasi perutean, pengidentifikasi maksud, konteks sesi, atau metadata apa pun yang dibutuhkan backend Anda untuk memproses pemilihan.

Saat penerima memilih saran, AWS End User Messaging akan mengirimkan peristiwa pesan masuk ke topik Amazon SNS yang Anda konfigurasikan untuk perpesanan dua arah. Rutekan logika Anda postbackData daripada teks tampilan. Untuk detail tentang acara masuk, lihatAcara pesan RCS.

Tampilan saran

Reply

ReplySaran mengirimkan balasan teks yang telah ditentukan kembali ke agen Anda. Teks tampilan muncul sebagai pesan terkirim dalam percakapan, dan PostbackData dikirim ke aplikasi Anda.

{ "Reply": { "Text": "Yes, confirm", "PostbackData": "confirm_order_12345" } }

OpenUrl

OpenUrlSaran membuka URL. Secara default URL terbuka di browser perangkat. Untuk membuka URL dalam tampilan web yang menyimpan penerima di dalam aplikasi perpesanan, setel Application ke WEBVIEW dan tentukan file. WebviewViewMode

{
  "OpenUrl": {
    "Text": "Complete payment",
    "PostbackData": "pay_12345",
    "Url": "https://example.com/pay",
    "Application": "WEBVIEW",
    "WebviewViewMode": "TALL"
  }
}

DialPhone

DialPhoneSaran memulai panggilan telepon ke nomor yang Anda tentukan.

{ "DialPhone": { "Text": "Call support", "PostbackData": "dial_support", "PhoneNumber": "+18005551234" } }

ShowLocation

ShowLocationSaran membuka peta pada koordinat yang Anda tentukan.

{
  "ShowLocation": {
    "Text": "View on map",
    "PostbackData": "show_store_loc",
    "Latitude": 47.6062,
    "Longitude": -122.3321,
    "Label": "Seattle store"
  }
}

RequestLocation

RequestLocationSaran meminta penerima untuk membagikan lokasi mereka saat ini. Koordinat bersama tiba sebagai acara lokasi masuk yang terpisah.

{ "RequestLocation": { "Text": "Share location", "PostbackData": "request_user_location" } }

CreateCalendarEvent

CreateCalendarEventSaran membuat acara kalender di perangkat penerima dengan detail yang Anda tentukan.

{
  "CreateCalendarEvent": {
    "Text": "Add to calendar",
    "PostbackData": "calendar_appt_5678",
    "Title": "Service appointment",
    "StartTime": "2026-05-28T14:00:00Z",
    "EndTime": "2026-05-28T15:00:00Z",
    "Description": "Downtown location. Arrive 10 minutes early."
  }
}

Menerima ketukan saran

Saat penerima memilih saran, AWS End User Messaging akan menerbitkan pesan masuk ke topik SNS dua arah Anda. messageBodyBerisi objek JSON dengan jenis saran, teks tampilan, dan yang postbackData Anda atur. Rutekan logika AndapostbackData.

{
  "originationNumber": "+12065551234",
  "destinationNumber": "rcs-a1b2c3d4",
  "messageBody": "{\"type\":\"SUGGESTION\",\"text\":\"Yes, confirm\",\"postbackData\":\"confirm_order_12345\"}",
  "inboundMessageId": "msg-abc123def456"
}

Untuk satu RequestLocation ketukan, koordinat penerima tiba di acara lokasi masuk yang terpisah. Untuk referensi acara masuk lengkap, lihatAcara pesan RCS.

Batas saran

Praktik terbaik

Untuk panduan yang lebih dalam, lihatPraktik terbaik RCS.

Topik terkait