Mengirim pesan

Agen RCS untuk Bisnis berkomunikasi dengan pengguna dengan mengirim dan menerima pesan. Untuk mengirim pesan kepada pengguna, agen Anda mengirim permintaan pesan ke RCS Business Messaging API. Satu permintaan dapat mencakup teks, kartu informasi, file media dan PDF, balasan yang disarankan, dan tindakan yang disarankan.

Platform RCS for Business menampilkan error dalam situasi tertentu untuk membantu Anda mengelola pengiriman pesan:

  • Jika Anda mengirim pesan kepada pengguna yang perangkatnya tidak mendukung RCS atau tidak mengaktifkan RCS, platform RCS for Business akan menampilkan error 404 NOT_FOUND. Dalam hal ini, Anda dapat mencoba menghubungi pengguna melalui metode penggantian yang ditentukan dalam infrastruktur Anda.
  • Jika Anda mengirim pesan ke pengguna RCS di jaringan tempat agen Anda belum diluncurkan, atau di jaringan yang belum mengaktifkan traffic RCS, platform RCS untuk Bisnis akan menampilkan error 404 NOT_FOUND.
  • Jika Anda mengirim pesan dengan fitur yang tidak didukung oleh perangkat pengguna, platform RCS for Business akan menampilkan error 400 INVALID_ARGUMENT dan tidak akan mengirimkan pesan Anda.

Sebagai bagian dari strategi pesan multi-saluran, sebaiknya cabut pesan yang tidak terkirim setelah waktu yang wajar dan kirimkan melalui saluran yang berbeda. Untuk mencabut pesan secara otomatis pada waktu yang telah ditentukan, tetapkan masa berlaku pesan.

Penerima sedang offline

Platform RCS for Business masih menerima pesan untuk dikirim jika penerima sedang offline. Anda akan menerima respons 200 OK, dan platform RCS for Business akan menahan pesan dan mencoba mengirim ulang selama 30 hari. Anda tidak perlu meminta RCS for Business untuk mengirim pesan lagi.

RCS for Business menghapus pesan yang tidak terkirim 30 hari setelah pesan tersebut dikirim.

Bergantung pada kasus penggunaan agen, Anda mungkin ingin mencabut pesan yang tidak terkirim sebelum waktu tunggu 30 hari ini. Pencabutan dapat mencegah pengguna offline menerima pesan usang saat mereka kembali online. Ada beberapa cara untuk mencabut pesan:

Menetapkan masa berlaku pesan

Apakah pesan agen Anda bersifat mendesak? Misalnya, OTP hanya berlaku untuk jangka waktu singkat. Penawaran berbatas waktu akan berakhir. Dan pengingat janji temu tidak relevan setelah tanggal janji temu. Agar pesan tetap aktual dan relevan, tetapkan masa berlaku pesan. Hal ini dapat mencegah pengguna offline menerima konten usang saat mereka kembali online. Masa berlaku juga merupakan petunjuk yang baik untuk memanggil strategi pesan penggantian sehingga pengguna mendapatkan info yang mereka butuhkan tepat waktu.

Untuk menetapkan masa berlaku pesan, tentukan salah satu kolom berikut dalam pesan agen:

  • expireTime: Waktu yang tepat dalam UTC saat masa berlaku pesan berakhir.
  • ttl(time to live): Jumlah waktu sebelum pesan berakhir.

Untuk opsi pemformatan dan nilai, lihat AgentMessage.

Nilai maksimum untuk ttl dan expireTime adalah 15 hari setelah pengiriman pesan.

Nilai minimum untuk ttl dan expireTime adalah enam detik setelah pengiriman pesan.

Rekomendasi untuk menetapkan masa berlaku pesan

  • Untuk pesan autentikasi (OTP): Tetapkan ttl ke 15 detik atau lebih setelah pengiriman pesan untuk mengurangi secara signifikan kemungkinan kondisi race pengiriman dan pencabutan.

  • Untuk pesan transaksional dan promosi: Tetapkan masa berlaku yang lebih lama (minimal 60 detik, atau menit hingga jam, bergantung pada kasus penggunaan) karena perangkat memerlukan waktu tambahan untuk memindai pesan dan mendownload atau memproses konten multimedia, dan pengguna mungkin mengalami penurunan konektivitas singkat (misalnya, di lift atau terowongan).

Time to live (TTL) untuk pesan

Saat menetapkan TTL untuk pesan RCS untuk Bisnis, Anda menentukan berapa lama pesan harus dianggap valid dan dapat dikirim. Jika pesan tidak berhasil dikirim ke perangkat pengguna dalam periode TTL ini, platform RCS Business Messaging akan otomatis mencoba mencabutnya.

Saat memulai pencabutan pesan, Anda meminta platform RCS for Business untuk berhenti mencoba mengirimkan pesan tertentu tersebut. Namun, tindakan ini hanya memengaruhi upaya pengiriman di masa mendatang. Jika perangkat pengguna telah berhasil mengambil pesan, pesan tersebut sedang diproses, dan platform RCS for Business tidak dapat mencabut pesan dari perangkat pengguna.

Berikut yang akan terjadi terkait notifikasi:

  • Pesan dikirim dalam TTL: Jika perangkat pengguna online dan menerima pesan sebelum TTL berakhir, Anda akan menerima notifikasi DELIVERED. Notifikasi pencabutan tidak akan dikirim, karena pesan berhasil dikirim. Ini adalah skenario yang paling umum dan diperkirakan.

  • Pesan tidak terkirim sebelum masa berlaku TTL berakhir: Jika TTL berakhir sebelum pesan sampai ke perangkat pengguna (misalnya, perangkat sedang offline), platform RCS for Business akan mencoba mencabut pesan tersebut. Anda akan menerima notifikasi TTL_EXPIRATION_REVOKED, yang menunjukkan bahwa pesan telah berhasil dihapus dari antrean pengiriman. Dalam hal ini, pengguna tidak akan menerima pesan.

Rekomendasi untuk menangani kasus ekstrem

Sistem kami memproses pengiriman pesan RCS for Business dan masa berlaku TTL secara paralel. Oleh karena itu, dalam kasus yang sangat jarang terjadi, Anda mungkin melihat kasus ekstrem saat waktu notifikasi tidak terduga. Misalnya, Anda mungkin mendapatkan notifikasi pengiriman dan TTL atau mungkin tidak mendapatkan keduanya.

Berikut rekomendasi kami untuk menangani notifikasi pesan RCS for Business:

  • Notifikasi DELIVERED: Jika Anda menerima notifikasi DELIVERED untuk pesan, hal ini mengonfirmasi bahwa pesan telah sampai ke pengguna. Anda dapat mengabaikan notifikasi TTL berikutnya untuk pesan tertentu tersebut.

  • Notifikasi TTL_EXPIRATION_REVOKED: Jika Anda menerima notifikasi TTL dengan status TTL_EXPIRATION_REVOKED, berarti sistem RCS for Business berhenti mencoba mengirimkan pesan tertentu tersebut. Anda harus memperlakukan pesan ini sebagai tidak terkirim dan melanjutkan strategi penggantian jika diperlukan.

  • Notifikasi TTL dengan status lainnya: Jika Anda menerima notifikasi TTL dengan status lainnya, hal ini menunjukkan upaya pencabutan yang tidak meyakinkan.

    • Untuk pesan penting, seperti sandi sekali pakai (OTP), mulai metode penggantian Anda.
    • Untuk pesan yang tidak penting, tentukan apakah akan memulai penggantian atau tidak.
  • Tidak ada notifikasi: Dalam kasus ekstrem yang jarang terjadi, sistem mungkin gagal mengirimkan notifikasi TTL dan klien juga mungkin gagal membuat notifikasi pengiriman. Ini adalah kasus yang sangat jarang terjadi.

Menetapkan jenis traffic pesan

RBM API menyertakan kolom messageTrafficType untuk mengategorikan pesan. Meskipun kasus penggunaan agen masih menentukan perilaku agen dan aturan bisnis yang berlaku, messageTrafficType memungkinkan kategorisasi konten pesan yang lebih mendetail. Pada akhirnya, hal ini memungkinkan satu agen menangani beberapa kasus penggunaan. Saat ini, tidak ada dampak terhadap kasus penggunaan agen atau aturan bisnis yang ada.

Kolom ini bersifat opsional, tetapi sebaiknya Anda menetapkannya sekarang agar tidak menerima error saat kolom tersebut menjadi wajib diisi.

Untuk menetapkan jenis traffic pesan, tetapkan messageTrafficType yang sesuai untuk setiap pesan berdasarkan kontennya. Tabel berikut mencantumkan jenis traffic yang didukung dan kasus penggunaan agen yang diharapkan. Pemetaan ini adalah panduan yang direkomendasikan tentang penggunaan yang diharapkan, bukan batasan yang diterapkan oleh API saat ini.

Jenis traffic Isi pesan Kasus penggunaan agen yang direkomendasikan
AUTHENTICATION Untuk pesan autentikasi. OTP
TRANSACTION Untuk pesan tentang layanan atau produk pengguna yang sudah ada. Misalnya: konfirmasi, tanda terima pembayaran, atau detail pemesanan. Transaksional atau Multiguna
PROMOTION Untuk pesan promosi seperti penawaran, diskon, pengumuman, atau konten promosi lainnya. Promosi atau Multiguna
SERVICEREQUEST Untuk pesan tentang layanan yang diminta secara eksplisit oleh pengguna. OTP, Transaksional, Promosi, atau Multi-penggunaan
ACKNOWLEDGEMENT Untuk pesan yang digunakan untuk mengonfirmasi tindakan pengguna, khususnya permintaan berhenti berlangganan. Email ini mengonfirmasi bahwa permintaan pengguna telah diterima dan sedang diproses. OTP, Transaksional, Promosi, atau Multi-penggunaan

Jika tidak ada jenis traffic yang ditetapkan, sistem akan menetapkan jenis default untuk kasus penggunaan agen.

Kasus penggunaan agen Jenis traffic default
OTP AUTHENTICATION
Transaksi TRANSACTION
Promosi PROMOTION
Multi-penggunaan MESSAGE_TRAFFIC_TYPE_UNSPECIFIED

Agen multi-penggunaan tidak memiliki jenis traffic default. Anda harus menetapkan jenis traffic secara eksplisit untuk setiap pesan berdasarkan kontennya. Jika Anda tidak mengganti nilai MESSAGE_TRAFFIC_TYPE_UNSPECIFIED, pesan akan tetap diterima dan dikirim tanpa klasifikasi menurut jenis traffic tertentu.

Batas ukuran pesan

Ukuran maksimum seluruh AgentMessage yang diubah menjadi string adalah 250 KB. Bagian teks pesan memiliki batasnya sendiri, yaitu 3.072 karakter.

Untuk mencegah konsumsi data yang tidak terduga bagi pengguna, ukuran maksimum file yang dapat dikirim melalui RCS untuk Bisnis adalah 100 MiB, dan total ukuran gabungan semua lampiran media dan PDF dalam satu pesan RCS untuk Bisnis tidak boleh melebihi 100 MiB. (1 MiB = 1.048.576 byte). Untuk mengetahui informasi selengkapnya, lihat file media dan PDF.

Teks

Pesan yang paling sederhana terdiri dari teks. Pesan teks paling cocok untuk menyampaikan informasi tanpa memerlukan visual, interaksi yang kompleks, atau respons.

Contoh

Kode berikut mengirimkan pesan teks biasa. Untuk opsi pemformatan dan nilai, lihat phones.agentMessages.create.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!"
  },
  "messageTrafficType": "PROMOTION"
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
};

// Send a simple message to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444"
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a simple RBM text message
message_text = messages.TextMessage('Hello, world!')

# Send text message to the device
messages.MessageCluster().append_message(message_text).send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
);
Kode ini adalah kutipan dari agen contoh RBM.

Konten Pesan Dasar - konversi SMS

Operator telah memperkenalkan model penagihan untuk mendukung peralihan pesan SMS ke RCS for Business. Pesan RCS for Business yang berisi hingga 160 karakter UTF-8 disebut Pesan Dasar.

Saat membuat permintaan untuk mengirim Pesan Dasar, ingatlah bahwa karakter dihitung sebagai 1 byte (UTF-8). Jika Anda mengirim pesan yang berisi karakter khusus seperti emoji atau himpunan karakter multi-byte, setiap karakter dihitung sebagai 2-4 karakter UTF-8 atau lebih.

Masukkan beberapa teks di kotak untuk memeriksa panjangnya:

Klien RCS dapat menerapkan pratinjau link. Jika pesan RCS for Business khusus teks menyertakan URL untuk situs dengan tag openGraph, klien dapat membuat pratinjau (gambar, judul, dll.), sehingga memberikan pengalaman yang lebih kaya. Misalnya, lihat pesan dasar dengan pratinjau URL.

Perhatikan bahwa klien RCS mungkin mengizinkan pengguna menonaktifkan pratinjau link.

Sandi sekali pakai untuk verifikasi pengguna

Anda dapat menggunakan RCS for Business untuk mengirim sandi sekali pakai (OTP) untuk verifikasi pengguna otomatis dengan SMS Retriever API. Tidak ada API khusus untuk membaca OTP yang masuk melalui RCS for Business.

Cara kerjanya untuk Android

Untuk aplikasi Android yang telah terdaftar di SMS Retriever API, API ini memproses pesan RCS for Business yang diformat dengan benar. Pesan ini harus berisi OTP dan hash unik yang mengidentifikasi aplikasi Anda.

Saat pesan RCS for Business diterima dengan format yang benar, SMS Retriever API akan memprosesnya seperti halnya OTP SMS. Setelah hash dicocokkan dengan aplikasi Anda, OTP akan diekstrak dan diteruskan ke aplikasi Anda untuk verifikasi pengguna otomatis.

  • Contoh pesan teks RCS for Business untuk verifikasi pengguna: Your code is <OTP><app hash>.
  • Contoh: Your code is 123456 M8tue43FGT.

Untuk mempelajari lebih lanjut SMS Retriever dan API terkait, lihat dokumentasi SMS Retriever. Untuk mengetahui detail tentang verifikasi pengguna otomatis di aplikasi yang terdaftar dengan SMS Retriever API, lihat diagram alir ini.

Cara kerjanya untuk iOS

Untuk iOS, penanganan OTP bawaan sistem akan otomatis mendeteksi dan menyarankan OTP RCS untuk Bisnis untuk pengisian otomatis, seperti OTP SMS. Tidak diperlukan integrasi API khusus agar aplikasi iOS dapat membaca OTP.

File media dan PDF

Saat Anda mengirim pesan dengan file gambar, video, audio, atau PDF, agen Anda harus memberikan URL yang dapat diakses secara publik untuk konten tersebut atau langsung mengupload file.

Ukuran maksimum file yang dapat dikirim adalah 100 MiB, dan total ukuran gabungan semua lampiran media dan PDF dalam satu pesan tidak boleh melebihi 100 MiB.

Kompresi dan transcoding media

Platform RCS untuk Bisnis otomatis melakukan transcoding dan mengompresi file media (seperti gambar dan video) sebelum mengirimkannya untuk memastikan file tersebut dimuat dengan cepat dan berfungsi dengan baik di berbagai jaringan dan perangkat.

Kompresi didasarkan pada kualitas media input, bukan hanya pada batas ukuran file. Artinya, file dapat dikompresi meskipun ukurannya jauh di bawah batas maksimum 100 MiB. Standar transcoding terus berubah, sehingga tidak ada batas ukuran file tetap yang menentukan kapan transcoding dilewati. Bereksperimenlah dengan berbagai format media, dimensi, dan rasio kompresi untuk menemukan keseimbangan yang optimal untuk payload Anda.

Spesifikasi thumbnail

Untuk file media, Anda juga dapat menentukan gambar thumbnail yang memungkinkan pengguna melihat pratinjau konten sebelum mengkliknya. Untuk file audio, widget audio default digunakan sebagai placeholder.

  • Ukuran file maksimum thumbnail adalah 100 kB. Untuk pengalaman pengguna yang optimal, sebaiknya ukuran file 50 kB atau kurang.
  • Rasio aspek thumbnail harus cocok dengan rasio file asli.

Pengelolaan URL dan penyimpanan ke cache

Platform RCS for Business meng-cache file selama 60 hari, dan API menampilkan ID file yang dapat disertakan agen Anda dalam pesan kepada pengguna. Setelah 60 hari, RCS for Business akan menghapus file dari cache.

Saat menentukan file berdasarkan URL, praktik terbaiknya adalah menetapkan contentMessage.forceRefresh ke false. Menyetel contentMessage.forceRefresh ke true akan memaksa RCS for Business mengambil konten baru dari URL yang ditentukan, meskipun konten URL di-cache, sehingga meningkatkan waktu pengiriman pesan bagi pengguna.

Contoh URL file

Kode berikut mengirimkan gambar. Untuk opsi pemformatan dan nilai, lihat AgentContentMessage.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "contentInfo": {
      "fileUrl": "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
      "forceRefresh": false
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let params = {
   fileUrl: 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif',
   msisdn: '+12223334444',
};

// Send an image/video to a device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.AgentContentMessage;
import com.google.api.services.rcsbusinessmessaging.v1.model.AgentMessage;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   String fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // create media only message
   AgentContentMessage agentContentMessage = new AgentContentMessage();
   agentContentMessage.setContentInfo(new ContentInfo().setFileUrl(fileUrl));

   // attach content to message
   AgentMessage agentMessage = new AgentMessage();
   agentMessage.setContentMessage(agentContentMessage);

   rbmApiHelper.sendAgentMessage(agentMessage, "+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create media file attachment
file_message = messages.FileMessage('http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif')

messages.MessageCluster().append_message(file_message).send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

string fileUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create content info with the file url
ContentInfo contentInfo = new ContentInfo
{
    FileUrl = fileUrl
};

// Attach content info to a message
AgentContentMessage agentContentMessage = new AgentContentMessage
{
    ContentInfo = contentInfo,
};

// Attach content to message
AgentMessage agentMessage = new AgentMessage
{
    ContentMessage = agentContentMessage
};

rbmApiHelper.SendAgentMessage(agentMessage, "+12223334444");
Kode ini adalah kutipan dari agen contoh RBM.

Atau, Anda dapat mengupload media sebelum mengirimkannya dalam pesan dengan files.create.

Contoh upload file

Kode berikut mengupload file video dan file thumbnail, lalu mengirimkan kedua file tersebut dalam sebuah pesan. Untuk opsi pemformatan dan nilai, lihat files.create dan AgentContentMessage.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: video/mp4" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_VIDEO_MEDIA_FILE"

# Capture server-specified video file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/upload/v1/files?agentId=AGENT_ID" \
-H "Content-Type: image/jpeg" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
--upload-file "FULL_PATH_TO_THUMBNAIL_MEDIA_FILE"

# Capture server-specified image file name from response body JSON


curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "uploadedRbmFile": {
      "fileName": "SERVER-SPECIFIED_VIDEO_FILE_NAME",
      "thumbnailName": "SERVER-SPECIFIED_THUMBNAIL_FILE_NAME"
    }
  }
}'

Jenis media yang didukung

RCS for Business mendukung jenis media berikut. Untuk thumbnail, hanya image/jpeg, image/jpg, image/gif, dan image/png yang didukung.

Jenis media Jenis dokumen Ekstensi Berfungsi dengan kartu informasi
application/ogg Audio OGG .ogx Tidak
application/pdf PDF .pdf Ya (Hanya untuk Google Message di India)
audio/aac Audio AAC .aac Tidak
audio/mp3 Audio MP3 .mp3 Tidak
audio/mpeg Audio MPEG .mpeg Tidak
audio/mpg Audio MPG .mp3 Tidak
audio/mp4 Audio MP4 .mp4 Tidak
audio/mp4-latm Audio MP4-latm .mp4 Tidak
audio/3gpp Audio 3GPP .3gp Tidak
image/jpeg JPEG .jpeg, .jpg Ya
image/gif GIF .gif Ya
image/png PNG .png Ya
video/h263 Video H263 .h263 Ya
video/m4v Video M4V .m4v Ya
video/mp4 Video MP4 .mp4 Ya
video/mpeg4 Video MPEG-4 .mp4, .m4p Ya
video/mpeg Video MPEG .mpeg Ya
video/webm Video WEBM .webm Ya

Saran

Agen Anda mengirimkan saran (balasan yang disarankan dan tindakan yang disarankan) dalam daftar chip saran atau dalam kartu informasi.

Balasan yang disarankan

Balasan yang disarankan memandu pengguna melalui percakapan dengan memberikan respons yang dapat ditanggapi oleh agen Anda.

Saat pengguna mengetuk balasan yang disarankan, agen Anda akan menerima peristiwa yang berisi teks balasan dan data postback. Payload memiliki maksimum 2.048 karakter.

Contoh

Kode berikut mengirimkan teks dengan dua balasan yang disarankan. Untuk opsi pemformatan dan nilai, lihat SuggestedReply.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "reply": {
          "text": "Suggestion #1",
          "postbackData": "suggestion_1"
        }
      },
      {
        "reply": {
          "text": "Suggestion #2",
          "postbackData": "suggestion_2"
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with suggestion chips to the device
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   // Send simple text message to user
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggested replies for the message to send to the user
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'))
cluster.append_suggestion_chip(messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2'))

# Send a simple message with suggestion chips to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

// Send simple text message with suggestions to user
rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
   suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Tindakan yang disarankan

Tindakan yang disarankan memandu pengguna melalui percakapan dengan memanfaatkan fungsi bawaan perangkat mereka. Agen Anda dapat menyarankan agar pengguna menghubungi nomor, membuka lokasi di peta, membagikan lokasi, membuka URL, atau membuat acara kalender.

Untuk setiap tindakan yang disarankan, Anda dapat memberikan URL pengganti (maksimum 2.048 karakter). URL ini akan terbuka di jendela browser baru jika perangkat pengguna tidak mendukung tindakan yang disarankan.

Saat pengguna mengetuk tindakan yang disarankan, agen Anda akan menerima peristiwa yang berisi data postback tindakan.

Untuk opsi pemformatan dan nilai, lihat SuggestedAction.

Tampilan saran

Ada dua cara untuk menampilkan saran:

  • Persistent: Tindakan yang disarankan atau balasan yang ditampilkan di dalam balon pesan dan tetap ada di sepanjang percakapan.
  • Sementara: Saran yang ditampilkan di luar balon pesan dan menghilang saat percakapan berlanjut.

Format pesan yang didukung

  • Saran persisten: Berfungsi dengan pesan teks mandiri dan kartu informasi.
  • Saran sementara: Berfungsi dengan pesan teks mandiri, pesan media, dan kartu informasi.

Menggabungkan saran

Anda dapat menggabungkan saran persisten dan sementara dalam pesan atau kartu informasi yang sama.

  • Pesan teks: Saran bersifat sementara secara default. Agar tetap berada di dalam balon, Anda harus mengonfigurasinya sebagai persisten.
  • Kartu informasi: Kartu ini mendukung hingga empat saran persisten secara default. Kemudian, Anda dapat menambahkan saran sementara sebagai "daftar chip" di bawah kartu.

Batas saran

Satu pesan teks mendukung maksimum total 11 saran. Setiap saran persisten yang Anda sertakan akan mengurangi batas total ini. Misalnya, jika menyertakan 4 saran persisten, Anda dapat menambahkan hingga 7 saran sementara.

Jenis saran Batas Tempat kemunculannya
Persisten Maksimal 4 Di dalam balon pesan
Sementara Maksimal 11 Di luar balon (sebagai chip)

Batas karakter

Setiap saran memiliki maksimum 25 karakter.

Transparansi URL dalam tindakan yang disarankan

Untuk membangun kepercayaan pengguna, URL yang mendasarinya ditampilkan sebagai baris teks kedua di dalam tombol saran untuk tindakan yang disarankan "Buka URL". Perilaku yang konsisten ini berlaku di seluruh pesan teks mandiri, kartu informasi, dan carousel.

Klien yang didukung untuk saran persisten

  • Didukung: Google Message (versi 20260225.00 atau yang lebih baru).
  • Tidak didukung: Google Message versi sebelum 20260225.00, iOS, dan Samsung Messages.

Saran di notifikasi sistem

Saat pengguna menerima pesan, Google Message akan menampilkan saran pertama yang memenuhi syarat langsung di notifikasi sistem Android. Pengguna dapat mengetuk saran ini untuk mengirim balasan atau memicu tindakan tanpa perlu membuka aplikasi.

Saat mendesain pesan, perhatikan perilaku berikut:

  • Urutan itu penting: Hanya satu saran yang ditampilkan per notifikasi. Untuk memaksimalkan interaksi, tempatkan balasan atau tindakan yang disarankan dengan prioritas tertinggi di urutan pertama dalam daftar saran Anda.
  • Tindakan yang dikecualikan: Tindakan Bagikan Lokasi tidak pernah ditampilkan di notifikasi sistem - pengguna harus membuka percakapan untuk membagikan lokasi mereka.

Panggil nomor

Tindakan Telepon memandu pengguna untuk menghubungi nomor telepon yang ditentukan oleh agen Anda. Nomor telepon hanya boleh menyertakan digit (0-9), tanda plus (+), tanda bintang (*), dan tanda nomor (#). Format internasional E.164 (misalnya, +14155555555) didukung, tetapi tidak wajib. Artinya, +14155555555 dan 1011 adalah entri yang valid.

Contoh

Kode berikut mengirimkan tindakan panggilan. Untuk opsi pemformatan dan nilai, lihat DialAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Call",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/contact/",
          "dialAction": {
            "phoneNumber": "+15556667777"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a dial suggested action
let suggestions = [
   {
      action: {
         text: 'Call',
         postbackData: 'postback_data_1234',
         dialAction: {
            phoneNumber: '+15556667777'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a dial suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.DialAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a dial suggested action
   DialAction dialAction = new DialAction();
   dialAction.setPhoneNumber("+15556667777");

   // creating a suggested action based on a dial action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Call");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setDialAction(dialAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a dial suggested action
suggestions = [
      messages.DialAction('Call', 'reply:postback_data_1234', '+15556667777')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a dial an agent suggested action
DialAction dialAction = new DialAction
{
    PhoneNumber = "+15556667777"
};

// Creating a suggested action based on a dial action
SuggestedAction suggestedAction = new SuggestedAction
{
    Text = "Call",
    PostbackData = "postback_data_1234",
    DialAction = dialAction
};

// Attach action to a suggestion
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Melihat lokasi

Tindakan Lihat lokasi menampilkan lokasi di aplikasi peta default pengguna. Anda dapat menentukan lokasi berdasarkan lintang dan bujur atau dengan kueri berdasarkan lokasi pengguna saat ini. Anda juga dapat menetapkan label kustom untuk pin yang ditampilkan di aplikasi peta.

Contoh

Kode berikut mengirimkan tindakan lihat lokasi. Untuk opsi pemformatan dan nilai, lihat ViewLocationAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "View map",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/maps/@37.4220188,-122.0844786,15z",
          "viewLocationAction": {
            "latLong": {
              "latitude": "37.4220188",
              "longitude": "-122.0844786"
            },
            "label": "Googleplex"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a view location suggested action
let suggestions = [
   {
      action: {
         text: 'View map',
         postbackData: 'postback_data_1234',
         viewLocationAction: {
            latLong: {
               latitude: 37.4220188,
               longitude: -122.0844786
            },
            label: 'Googleplex'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a view location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.ViewLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a view location suggested action
   ViewLocationAction viewLocationAction = new ViewLocationAction();
   viewLocationAction.setQuery("Googleplex, Mountain View, CA");

   // creating a suggested action based on a view location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("View map");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setViewLocationAction(viewLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a view location suggested action
suggestions = [
      messages.ViewLocationAction('View map',
            'reply:postback_data_1234',
            query='Googleplex, Mountain View, CA')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// create an view location action
ViewLocationAction viewLocationAction = new ViewLocationAction
{
    Query = "Googleplex Mountain View, CA"
};

// Attach the view location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ViewLocationAction = viewLocationAction,
    Text = "View map",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Bagikan lokasi

Tindakan Bagikan Lokasi memungkinkan pengguna membagikan lokasi kepada agen Anda. Pengguna dapat membagikan lokasi saat ini atau lokasi yang dipilih secara manual dari aplikasi Maps.

Contoh

Kode berikut mengirimkan tindakan berbagi lokasi. Untuk opsi pemformatan dan nilai, lihat ShareLocationAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Share your location",
          "postbackData": "postback_data_1234",
          "shareLocationAction": {}
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a share location suggested action
let suggestions = [
   {
      action: {
         text: 'Share your location',
         postbackData: 'postback_data_1234',
         shareLocationAction: {
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a share location suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.ShareLocationAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a share location suggested action
   ShareLocationAction shareLocationAction = new ShareLocationAction();

   // creating a suggested action based on a share location action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Share location");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setShareLocationAction(shareLocationAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a share location suggested action
suggestions = [
      messages.ShareLocationAction('Share location',
            'reply:postback_data_1234')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a share location action
ShareLocationAction shareLocationAction = new ShareLocationAction();

// Attach the share location action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    ShareLocationAction = shareLocationAction,
    Text = "Share location",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Membuka URL

Tindakan Buka URL memungkinkan Anda memandu pengguna ke halaman web yang ditentukan oleh agen Anda. Secara default, halaman web akan terbuka di browser pengguna. Anda juga dapat menyetel halaman web agar terbuka di webview. Lihat Membuka URL dengan webview untuk mengetahui detailnya.

Hanya di Google Message

Menampilkan URL dasar: Untuk meningkatkan transparansi dalam pesan A2P, Google Message menampilkan alamat URL dasar dalam tindakan yang disarankan 'Buka URL'. Perubahan ini memengaruhi tindakan yang disarankan dalam kartu informasi standar dan carousel kartu informasi.

Kartu informasi yang menampilkan saran 'Lihat situs' dengan URL yang ditampilkan di bawahnya.
URL dasar yang terlihat

Tampilan ikon aplikasi untuk link web: Jika pengguna telah mengonfigurasi aplikasi default untuk halaman web, aplikasi tersebut akan terbuka, bukan browser atau webview, dan tombol saran akan menampilkan ikon aplikasi. Agar ikon aplikasi muncul di Google Message, Anda harus memberikan URL langsung yang lengkap. Jika Anda menggunakan URL yang dipersingkat, ikon Buka URL default akan ditampilkan.

Ikon aplikasi di tombol saran.
Ikon aplikasi di tombol saran
Contoh

Kode berikut mengirimkan tindakan buka URL. Untuk opsi pemformatan dan nilai, lihat OpenUrlAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Open Google",
          "postbackData": "postback_data_1234",
          "openUrlAction": {
            "url": "https://www.google.com"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define an open URL suggested action
let suggestions = [
   {
      action: {
         text: 'Open Google',
         postbackData: 'postback_data_1234',
         openUrlAction: {
            url: 'https://www.google.com'
         }
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with an open URL suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating an open url suggested action
   OpenUrlAction openUrlAction = new OpenUrlAction();
   openUrlAction.setUrl("https://www.google.com");

   // creating a suggested action based on an open url action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Open Google");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setOpenUrlAction(openUrlAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create an open url suggested action
suggestions = [
      messages.OpenUrlAction('Open Google',
            'reply:postback_data_1234',
            'https://www.google.com')
]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create an open url action
OpenUrlAction openUrlAction = new OpenUrlAction
{
    Url = "https://www.google.com"
};

// Attach the open url action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    OpenUrlAction = openUrlAction,
    Text = "Open Google",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Membuka URL dengan webview

Tindakan Buka URL dengan webview memuat halaman web yang ditentukan di dalam aplikasi pesan dengan mesin rendering browser default Anda. Hal ini memungkinkan pengguna berinteraksi dengan halaman web tanpa keluar dari percakapan RCS untuk Bisnis. Jika perangkat pengguna tidak mendukung webview, halaman web akan dibuka di browser pengguna. Untuk mengaktifkan webview, lihat OpenURLApplication.

Webview memiliki tiga mode tampilan. Untuk opsi pemformatan dan nilai, lihat WebviewViewMode.

  • Penuh: Halaman web memenuhi seluruh layar
  • Setengah: Halaman web menggunakan setengah layar
  • Tinggi: Halaman web menggunakan tiga perempat layar
Contoh

Kode berikut mengirimkan tindakan Buka URL dengan WebView. Untuk opsi pemformatan dan nilai, lihat OpenURLAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
 "contentMessage": {
   "text": "Hello, world!",
   "suggestions": [
     {
       "action": {
         "text": "Open Google",
         "postbackData": "postback_data_1234",
         "openUrlAction": {
           "url": "https://www.google.com",
           "application": "WEBVIEW",
           "webviewViewMode": "FULL",
           "description": "Accessibility description"
         }
       }
     }
   ]
 }
}'

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.OpenUrlAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…
  
try {
  
   String URL = "https://www.google.com";
  
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();
  
   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // Create suggestion to view webpage in full mode
   Suggestion viewInFullMode =  getUrlActionInWebview(URL, "FULL")
   suggestions.add(viewInFullMode);
  
   // create suggestion to view webpage in half mode
   Suggestion viewInHalfMode =  getUrlActionInWebview(URL, "HALF")
   suggestions.add(viewInHalfMode);
     
   // create suggestion to view webpage in tall mode
   Suggestion viewInTallMode =  getUrlActionInWebview(URL, "TALL")
   suggestions.add(viewInTallMode);
     
   // Send simple text message with the suggested action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}

  /**
    * Creates a suggested action to open URL in webview.
    *
    * @return a suggestion object for an open URL in webview action .
    */
    private Suggestion getUrlActionInWebview(String url,
                                             String viewMode) {
      // create an open url action
      OpenUrlAction openUrlAction = new OpenUrlAction();
      openUrlAction.setUrl(url);
      openUrlAction.setApplication("WEBVIEW");
      openUrlAction.setWebviewViewMode(viewMode);
      openUrlAction.setDescription("Accessibility description");
     
      // attach the open url action to a suggested action
      SuggestedAction suggestedAction = new SuggestedAction();
      suggestedAction.setOpenUrlAction(openUrlAction);
      suggestedAction.setText('display_text');
      suggestedAction.setPostbackData('postback_data_123');
     
      // attach the action to a suggestion object
      Suggestion suggestion = new Suggestion();
      suggestion.setAction(suggestedAction);
     
      return suggestion;
    }

Membuat acara kalender

Tindakan Buat acara kalender akan membuka aplikasi kalender pengguna dan mulai membuat acara baru dengan informasi yang ditentukan.

Judul acara kalender wajib diisi. Kolom ini memiliki panjang maksimum 100 karakter. Deskripsi acara kalender bersifat opsional dan memiliki maksimal 500 karakter.

Contoh

Kode berikut mengirimkan tindakan buat acara kalender. Untuk opsi pemformatan dan nilai, lihat CreateCalendarEventAction.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "text": "Hello, world!",
    "suggestions": [
      {
        "action": {
          "text": "Save to calendar",
          "postbackData": "postback_data_1234",
          "fallbackUrl": "https://www.google.com/calendar",
          "createCalendarEventAction": {
            "startTime": "2020-06-30T19:00:00Z",
            "endTime": "2020-06-30T20:00:00Z",
            "title": "My calendar event",
            "description": "Description of the calendar event"
          }
        }
      }
    ]
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Define a create calendar event suggested action
let suggestions = [
   {
      action: {
         text: 'Save to calendar',
         postbackData: 'postback_data_1234',
         createCalendarEventAction: {
            startTime: '2020-06-30T19:00:00Z',
            endTime: '2020-06-30T20:00:00Z',
            title: 'My calendar event',
            description: 'Description of the calendar event',
         },
      }
   },
];

let params = {
   messageText: 'Hello, world!',
   msisdn: '+12223334444',
   suggestions: suggestions,
};

// Send a simple message with a create calendar event suggested action
rbmApiHelper.sendMessage(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.CreateCalendarEventAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.SuggestedAction;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.RbmApiHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();

   // creating a create calendar event suggested action
   CreateCalendarEventAction createCalendarEventAction = new CreateCalendarEventAction();
   calendarEventAction.setTitle("My calendar event");
   calendarEventAction.setDescription("Description of the calendar event");
   calendarEventAction.setStartTime("2020-06-30T19:00:00Z");
   calendarEventAction.setEndTime("2020-06-30T20:00:00Z");

   // creating a suggested action based on a create calendar event action
   SuggestedAction suggestedAction = new SuggestedAction();
   suggestedAction.setText("Save to calendar");
   suggestedAction.setPostbackData("postback_data_1234");
   suggestedAction.setCreateCalendarEventAction(createCalendarEventAction);

   // attaching action to a suggestion
   Suggestion suggestion = new Suggestion();
   suggestion.setAction(suggestedAction);

   suggestions.add(suggestion);

   // Send simple text message with the suggestion action
   rbmApiHelper.sendTextMessage(
      "Hello, world!",
      "+12223334444",
      suggestions
   );
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Create a calendar event suggested action
suggestions = [
      messages.CreateCalendarEventAction('Save to Calendar',
                             'reply:postback_data_1234',
                             '2020-06-30T19:00:00Z',
                             '2020-06-30T20:00:00Z',
                             'My calendar event',
                             'Description of the calendar event')

]

# Create text message to send to user
text_msg = messages.TextMessage('Hello, world!')
cluster = messages.MessageCluster().append_message(text_msg)

# Append suggestions for the message to send to the user
for suggestion in suggestions:
    cluster.append_suggestion_chip(suggestion)

# Send a simple message with suggested action to the device
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                                 projectId);

// Create a calendar event action
CreateCalendarEventAction calendarEventAction = new CreateCalendarEventAction
{
    Title = "My calendar event",
    Description = "Description of the calendar event",
    StartTime = "2020-06-30T19:00:00Z",
    EndTime = "2020-06-30T20:00:00Z"
};

// Attach the calendar event action to a suggested action
SuggestedAction suggestedAction = new SuggestedAction
{
    CreateCalendarEventAction = calendarEventAction,
    Text = "Save to calendar",
    PostbackData = "postback_data_1234"
};

// Attach the action to a suggestion object
Suggestion suggestion = new Suggestion
{
    Action = suggestedAction
};

List<Suggestion> suggestions = new List<Suggestion>
{
    suggestion
};

rbmApiHelper.SendTextMessage(
    "Hello, world!",
    "+12223334444",
    suggestions
);
Kode ini adalah kutipan dari agen contoh RBM.

Daftar chip saran

Agen Anda mengirimkan daftar chip saran beserta pesan untuk memandu tindakan pengguna selanjutnya. Daftar chip hanya ditampilkan jika pesan terkait berada di bagian bawah percakapan. Setiap pesan berikutnya dalam percakapan (dari pengguna atau agen Anda) akan menimpa daftar chip.

Chip dalam daftar adalah balasan yang disarankan dan tindakan yang disarankan.

Daftar chip berisi maksimum 11 chip saran, dan setiap label chip dapat memiliki maksimum 25 karakter.

Untuk opsi pemformatan dan nilai, lihat AgentContentMessage.

Kartu informasi

Kartu informasi menggabungkan media, teks, dan saran interaktif ke dalam satu pesan. Kartu ideal untuk menampilkan informasi terkait (misalnya, produk dengan gambar, nama, dan harganya) dan memandu pengguna dengan langkah berikutnya yang jelas seperti saran "Lihat detail".

Kartu informasi dapat berisi hal berikut:

Setiap kolom ini bersifat opsional, tetapi setidaknya salah satu kolom 1–3 harus disertakan dalam kartu informasi.

Beberapa kartu dapat dikirim bersama dalam carousel yang di-scroll secara horizontal.

Perhatikan bahwa total payload untuk kartu informasi adalah 250 KB.

Untuk mengetahui detail teknis lengkap, lihat dokumentasi Kartu informasi.

Tinggi kartu

Kartu informasi diperluas secara vertikal agar sesuai dengan kontennya. Tinggi minimumnya adalah 112 DP dan tinggi maksimumnya adalah 344 DP. Jika konten kartu tidak cukup besar untuk mengisi tinggi minimum kartu, kartu akan diperluas dan mengisi tinggi tambahan dengan spasi kosong.

Media dalam kartu informasi harus sesuai dengan salah satu dari tiga tinggi:

  • Pendek: 112 DP
  • Sedang: 168 DP
  • Tinggi: 264 DP

Jika media tidak sesuai dengan dimensi dalam kartu dengan tinggi yang dipilih, pratinjau media akan dipilih dengan memperbesar dan memangkas media.

Contoh

Kode berikut mengirimkan kartu informasi dengan gambar dan balasan yang disarankan. Untuk opsi pemformatan dan nilai, lihat RichCard.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "richCard": {
      "standaloneCard": {
        "thumbnailImageAlignment": "RIGHT",
        "cardOrientation": "VERTICAL",
        "cardContent": {
          "title": "Hello, world!",
          "description": "RBM is awesome!",
          "media": {
            "height": "TALL",
            "contentInfo":{
              "fileUrl": "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif",
              "forceRefresh": false
            }
          },
          "suggestions": [
            {
              "reply": {
                "text": "Suggestion #1",
                "postbackData": "suggestion_1"
              }
            },
            {
              "reply": {
                "text": "Suggestion #2",
                "postbackData": "suggestion_2"
              }
            }
          ]
        }
      }
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Suggested replies to be used in the card
let suggestions = [
   {
      reply: {
         'text': 'Suggestion #1',
         'postbackData': 'suggestion_1',
      },
   },
   {
      reply: {
         'text': 'Suggestion #2',
         'postbackData': 'suggestion_2',
      },
   },
];

// Image to be displayed by the card
let imageUrl = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

// Definition of the card parameters
let params = {
   messageText: 'Hello, world!',
   messageDescription: 'RBM is awesome!',
   msisdn: '+12223334444',
   suggestions: suggestions,
   imageUrl: imageUrl,
   height: 'TALL',
};

// Send rich card to device
rbmApiHelper.sendRichCard(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.StandaloneCard;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
   // Create an instance of the RBM API helper
   RbmApiHelper rbmApiHelper = new RbmApiHelper();

   // Create suggestions for chip list
   List<Suggestion> suggestions = new ArrayList<Suggestion>();
   suggestions.add(
      new SuggestionHelper("Suggestion #1", "suggestion_1").getSuggestedReply());

   suggestions.add(
      new SuggestionHelper("Suggestion #2", "suggestion_2").getSuggestedReply());

   String imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

   // Create a standalone rich card to send to the user
   StandaloneCard standaloneCard = rbmApiHelper.createStandaloneCard(
       "Hello, world!",
       "RBM is awesome!",
       imageUrl,
       MediaHeight.MEDIUM,
       CardOrientation.VERTICAL,
       suggestions
   );

   rbmApiHelper.sendStandaloneCard(standaloneCard, "+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Suggested replies to be used in the card
suggestions = [
      messages.SuggestedReply('Suggestion #1', 'reply:suggestion_1'),
      messages.SuggestedReply('Suggestion #2', 'reply:suggestion_2')
]

# Image to be displayed by the card
image_url = 'http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif';

# Define rich card structure
rich_card = messages.StandaloneCard('VERTICAL',
                                    'Hello, world!',
                                    'RBM is awesome!',
                                    suggestions,
                                    image_url,
                                    None,
                                    None,
                                    'MEDIUM')

# Append rich card and send to the user
cluster = messages.MessageCluster().append_message(rich_card)
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

List<Suggestion> suggestions = new List<Suggestion>
{
   // Create suggestion chips
   new SuggestionHelper("Suggestion #1", "suggestion_1").SuggestedReply(),
   new SuggestionHelper("Suggestion #2", "suggestion_2").SuggestedReply()
};

string imageUrl = "http://www.google.com/logos/doodles/2015/googles-new-logo-5078286822539264.3-hp2x.gif";

// Create rich card with suggestions
StandaloneCard standaloneCard = rbmApiHelper.CreateStandaloneCard(
   "Hello, world!",
   "RBM is awesome",
   imageUrl,
   MediaHeight.TALL,
   CardOrientation.VERTICAL,
   suggestions
);

// Send rich card to user
rbmApiHelper.SendStandaloneCard(standaloneCard, "+12223334444");
Kode ini adalah kutipan dari agen contoh RBM.

Carousel kartu informasi

Carousel menggabungkan beberapa kartu informasi, sehingga pengguna dapat membandingkan item dan bereaksi terhadap setiap item satu per satu.

Carousel dapat berisi minimal dua dan maksimal sepuluh kartu informasi. Kartu informasi dalam carousel harus sesuai dengan persyaratan kartu informasi umum untuk konten dan tinggi, seperti yang dijelaskan dalam Dokumentasi kartu informasi. Untuk mengetahui informasi selengkapnya tentang tata letak dan spesifikasi carousel, lihat Dokumentasi carousel.

Contoh

Kode berikut mengirimkan carousel kartu informasi. Untuk opsi pemformatan dan nilai, lihat RichCard.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/agentMessages?messageId=MESSAGE_ID&agentId=AGENT_ID" \
-H "Content-Type: application/json" \
-H "User-Agent: curl/rcs-business-messaging" \
-H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY rcsbusinessmessaging`" \
-d '{
  "contentMessage": {
    "richCard": {
      "carouselCard": {
        "cardWidth": "MEDIUM",
        "cardContents": [
          {
            "title": "Card #1",
            "description": "The description for card #1",
            "suggestions": [
              {
                "reply": {
                  "text": "Card #1",
                  "postbackData": "card_1"
                }
              }
            ],
            "media": {
              "height": "MEDIUM",
              "contentInfo": {
                "fileUrl": "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg",
                "forceRefresh": false
              }
            }
          },
          {
            "title": "Card #2",
            "description": "The description for card #2",
            "suggestions": [
              {
                "reply": {
                  "text": "Card #2",
                  "postbackData": "card_2"
                }
              }
            ],
            "media": {
              "height": "MEDIUM",
              "contentInfo": {
                "fileUrl": "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg",
                "forceRefresh": false
              }
            }
          }
        ]
      }
    }
  }
}'

Node.js

// Reference to RBM API helper
const rbmApiHelper = require('@google/rcsbusinessmessaging');

// Images for the carousel cards
let card1Image = 'https://storage.googleapis.com/welcome-bot-sample-images/200.jpg';
let card2Image = 'https://storage.googleapis.com/welcome-bot-sample-images/201.jpg';

// Define the card contents for a carousel with two cards, each with one suggested reply
let cardContents = [
   {
      title: 'Card #1',
      description: 'The description for card #1',
      suggestions: [
         {
            reply: {
               text: 'Card #1',
               postbackData: 'card_1',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card1Image,
            forceRefresh: false,
         },
      },
   },
   {
      title: 'Card #2',
      description: 'The description for card #2',
      suggestions: [
         {
            reply: {
               text: 'Card #2',
               postbackData: 'card_2',
            }
         }
      ],
      media: {
         height: 'MEDIUM',
         contentInfo: {
            fileUrl: card2Image,
            forceRefresh: false,
         },
      },
   },
];

// Definition of carousel card
let params = {
   msisdn: '+12223334444',
   cardContents: cardContents,
};

// Send the device the carousel card defined above
rbmApiHelper.sendCarouselCard(params, function(response) {
   console.log(response);
});
Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.api.services.rcsbusinessmessaging.v1.model.CardContent;
import com.google.api.services.rcsbusinessmessaging.v1.model.Suggestion;
import com.google.rbm.cards.CardOrientation;
import com.google.rbm.cards.CardWidth;
import com.google.rbm.cards.MediaHeight;
import com.google.rbm.RbmApiHelper;
import com.google.rbm.SuggestionHelper;
…

try {
            // Create an instance of the RBM API helper
            RbmApiHelper rbmApiHelper = new RbmApiHelper();

            List cardContents = new ArrayList();

            // Images for the carousel cards
            String card1Image = "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg";

            // Create suggestions for first carousel card
            List card1Suggestions = new ArrayList();
            card1Suggestions.add(
                new SuggestionHelper("Card #1", "card_1"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    card1Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Images for the carousel cards
            String card2Image = "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg";

            // Create suggestions for second carousel card
            List card2Suggestions = new ArrayList();
            card2Suggestions.add(
                new SuggestionHelper("Card #2", "card_2"));

            cardContents.add(
                new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    card2Suggestions)
                    .getCardContent(MediaHeight.SHORT)
            );

            // Send the carousel to the user
            rbmApiHelper.sendCarouselCards(cardContents, CardWidth.MEDIUM, "+12223334444");
        } catch(Exception e) {
            e.printStackTrace();
        }
Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper and messaging object structure
from rcs_business_messaging import rbm_service
from rcs_business_messaging import messages

# Images for the carousel cards
card_image_1 = 'https://storage.googleapis.com/welcome-bot-sample-images/200.jpg';
card_image_2 = 'https://storage.googleapis.com/welcome-bot-sample-images/201.jpg';

# Suggested replies to be used in the cards
suggestions1 = [
      messages.SuggestedReply('Card #1', 'reply:card_1')
]

suggestions2 = [
      messages.SuggestedReply('Card #2', 'reply:card_2')
]

# Define the card contents for a carousel with two cards,
# each with one suggested reply
card_contents = []
card_contents.append(messages.CardContent('Card #1',
                                          'The description for card #1',
                                          card_image_1,
                                          'MEDIUM',
                                          suggestions1))

card_contents.append(messages.CardContent('Card #2',
                                          'The description for card #2',
                                          card_image_2,
                                          'MEDIUM',
                                          suggestions2))

# Send the device the carousel card defined above
carousel_card = messages.CarouselCard('MEDIUM', card_contents)
cluster = messages.MessageCluster().append_message(carousel_card)
cluster.send_to_msisdn('+12223334444')
Kode ini adalah kutipan dari agen contoh RBM.

C#

using Google.Apis.RCSBusinessMessaging.v1.Data;
using RCSBusinessMessaging;
using RCSBusinessMessaging.Cards;
…

// Create an instance of the RBM API helper
RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation,
                                             projectId);

// Image references to be used in the carousel cards
string card1Image = "https://storage.googleapis.com/welcome-bot-sample-images/200.jpg";
string card2Image = "https://storage.googleapis.com/welcome-bot-sample-images/201.jpg";

// Suggestion chip lists to be used in carousel cards
List<Suggestion> suggestions1 = new List<Suggestion>
{
   new SuggestionHelper("Card #1", "card_1").SuggestedReply()
};

List<Suggestion> suggestions2 = new List<Suggestion>
{
   new SuggestionHelper("Card #2", "card_2").SuggestedReply()
};

// Create the card content for the carousel
List<CardContent> cardContents = new List<CardContent>
{
   // Add items as card content
   new StandaloneCardHelper(
                    "Card #1",
                    "The description for card #1",
                    card1Image,
                    suggestions1).GetCardContent(),
   new StandaloneCardHelper(
                    "Card #2",
                    "The description for card #2",
                    card2Image,
                    suggestions2).GetCardContent()
};

// Send the carousel to the user
rbmApiHelper.SendCarouselCards(cardContents, CardWidth.MEDIUM, msisdn);
Kode ini adalah kutipan dari agen contoh RBM.