Update: Periksa catatan rilis untuk mengetahui fitur baru dan update produk.

Halaman ini diterjemahkan oleh Cloud Translation API.

Pemeriksaan kemampuan

Untuk memeriksa apakah perangkat pengguna mendukung RCS dan mampu berkomunikasi dengan agen RBM, Anda dapat meminta kemampuan perangkat. Dengan mengidentifikasi fitur yang didukung perangkat, jika ada, agen Anda dapat menyesuaikan percakapan dengan kemampuan perangkat dan menghindari interaksi yang sulit atau tidak dapat diselesaikan pengguna.

Jika perangkat pengguna sama sekali tidak dapat menerima pesan RCS, Anda dapat berkomunikasi dengan pengguna melalui layanan lain, seperti SMS.

Mengirim pemeriksaan kemampuan

Kode berikut mengirimkan pemeriksaan kemampuan dan menunggu respons. Untuk opsi format dan nilai, lihat getCapabilities.

cURL

curl -X GET "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/capabilities?requestId=REQUEST_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`"

Node.js

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

// Send a capability check to the device
rbmApiHelper.checkCapability('+12223334444', function(response) {
   // Print capabilities of the device
   console.log(response);
});

Kode ini adalah kutipan dari agen contoh RBM.

Java

import com.google.rbm.RbmApiHelper;
…

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

// Check the capabilities of the device
boolean capability = rbmApiHelper.getCapability("+12223334444");

Kode ini adalah kutipan dari agen contoh RBM.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Send the tester invite to a device
response = rbm_service.make_cap_request('+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);

// Register the device as a tester
Capabilities capabilities = rbmApiHelper.GetCapability("+12223334444");

Kode ini adalah kutipan dari agen contoh RBM.

Respons kemampuan

Setelah menjalankan pemeriksaan kemampuan, platform RBM akan menampilkan daftar fitur berformat JSON yang didukung perangkat yang ditentukan.

{
  "features": [
    "REVOCATION",
    "RICHCARD_STANDALONE",
    "RICHCARD_CAROUSEL",
    "ACTION_CREATE_CALENDAR_EVENT",
    "ACTION_DIAL",
    "ACTION_OPEN_URL",
    "ACTION_SHARE_LOCATION",
    "ACTION_VIEW_LOCATION",
  ]
}

Jika Anda mengirim pemeriksaan kemampuan kepada pengguna yang tidak dapat dijangkau oleh RBM—misalnya, jika perangkat mereka tidak mendukung RCS—platform RBM akan menampilkan error 404.

Jika Anda mengirim pemeriksaan kemampuan ke pengguna RCS di jaringan tempat agen Anda belum diluncurkan, platform RBM akan menampilkan error 403.

Pemeriksaan kemampuan massal

Untuk memperkirakan jumlah pengguna yang dapat dijangkau RBM, lakukan pemeriksaan kemampuan massal. Pemeriksaan massal menunjukkan apakah nomor telepon dapat dihubungi, tetapi tidak menunjukkan fitur yang didukung nomor telepon.

Anda dapat menentukan hingga 10.000 nomor telepon per pemeriksaan kemampuan massal. Untuk memeriksa lebih banyak nomor, lakukan beberapa pemeriksaan. Gunakan Skrip Pemeriksaan Kemampuan Massal untuk menggunakan file CSV sebagai format input.

Pemeriksaan kemampuan massal memiliki maksimum 600 kueri per menit (QPM).

Pemeriksaan kemampuan massal menampilkan daftar nomor yang dapat dijangkau agen Anda di operator tempat agen diluncurkan, serta estimasi jumlah total pengguna yang dapat dijangkau di semua operator. Lihat Respons pemeriksaan kemampuan massal.

Memperkirakan total pengguna yang dapat dijangkau

Meskipun respons pemeriksaan massal menyertakan daftar nomor telepon yang dapat langsung dihubungi pada operator yang diluncurkan agen Anda (reachableUsers), respons juga mencakup dua nilai yang dapat membantu Anda memperkirakan jumlah total pengguna yang dapat dijangkau di semua operator.

Saat agen Anda melakukan pemeriksaan kemampuan massal untuk lebih dari 500 nomor telepon, RBM akan mengambil sampel secara acak ~75% dari nomor tersebut untuk memeriksa semua operator (dilaporkan di totalRandomSampleUserCount). RBM juga menampilkan jumlah nomor yang dapat dijangkau RBM dari sampel acak, terlepas dari status peluncuran operator (reachableRandomSampleUserCount). Dengan membagi reachableRandomSampleUserCount dengan totalRandomSampleUserCount, Anda dapat memperkirakan persentase nomor yang dapat dijangkau agen jika diluncurkan di semua operator.

Misalnya, jika Anda menentukan 5.000 nomor telepon dalam pemeriksaan kemampuan massal, dan RBM mengambil sampel secara acak ~75% dari nomor yang ditentukan, totalRandomSampleUserCount mungkin adalah 3750. Jika reachableRandomSampleUserCount adalah 3000, berarti 80% jumlah sampel dapat dijangkau.

Menguji sampel acak dapat menyebabkan varians dalam persentase. Untuk memperhitungkan efek pengambilan sampel acak, jalankan pemeriksaan kemampuan massal dengan jumlah nomor telepon yang lebih besar. Anda juga dapat melakukan pemeriksaan dengan batch angka yang sama beberapa kali, lalu menghitung rata-rata hasilnya untuk menormalisasi perilaku sampling acak.

Mengirim pemeriksaan kemampuan massal

Kode berikut mengirimkan pemeriksaan kemampuan massal dan menunggu respons. Untuk opsi format dan nilai, lihat users.batchGet.

Nomor telepon harus dalam format E.164. Misalnya, "+12223334444".

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/users:batchGet?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 '{
  "users": [
    "PHONE_NUMBER",
  ]
}'

Node.js

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

// Specify phone numbers
let phoneNumbers = ['+12223334444', '+12223334444'];

// Perform a bulk capability check
rbmApiHelper.getUsers(phone_numbers, function(response) {
   // Print the bulk capability check response
   console.log(response);
});

Kode ini menggunakan agen contoh RBM.

Java

import com.google.rbm.RbmApiHelper;
…

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

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.getUsers(Arrays.asList("+12223334444", "+12223334444"));

Kode ini menggunakan agen contoh RBM.

Python

# Reference to RBM Python client helper
from rcs_business_messaging import rbm_service

# Perform a bulk capability check
response = rbm_service.make_batch_cap_request(['+12223334444', '+12223334444'])

Kode ini menggunakan agen contoh RBM.

C#

using RCSBusinessMessaging;
…

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

// Perform a bulk capability check
BatchGetUsersResponse batchGetUsersResponse = rbmApiHelper.GetUsers(new List({"+12223334444", "+12223334444"}));

Kode ini menggunakan agen contoh RBM.

Respons pemeriksaan kemampuan massal

Setelah menjalankan pemeriksaan kemampuan massal, RBM menampilkan respons berformat JSON.

{
  "reachableUsers": [
    "PHONE_NUMBER"
  ],
  "totalRandomSampleUserCount": "COUNT_OF_SAMPLE",
  "reachableRandomSampleUserCount": "REACHABLE_FROM_SAMPLE"
}

Kolom	Deskripsi
`reachableUsers`	Daftar pengguna yang dapat dijangkau di operator yang diluncurkan agen.
`totalRandomSampleUserCount`	Jumlah sampel acak dari angka yang ditentukan. Biasanya ~75% dari angka yang ditentukan.
`reachableRandomSampleUserCount`	Jumlah angka dari sampel acak yang dapat dijangkau RBM di semua operator, terlepas dari operator tempat agen diluncurkan.

Alat: Skrip Pemeriksaan Kemampuan Massal

Bulk Capability Check Script (Login untuk mendownload) melakukan pemeriksaan kemampuan massal menggunakan file CSV sebagai format input dan output. Skrip mengurai file CSV MSISDN dan menggunakan RBM SDK untuk memeriksa kemampuan setiap perangkat yang tercantum.

Mesin virtual dengan 2 CPU dan RAM 4 GB yang menjalankan skrip dengan 500 thread dapat mencapai sekitar 1.000 QPS, tetapi QPS keseluruhan bergantung pada mesin yang digunakan, negara perangkat, konfigurasi regional agen Anda, dan endpoint API yang digunakan.

Prasyarat

Sebelum menggunakan alat ini untuk melakukan pemeriksaan kemampuan massal, dapatkan hal berikut:

Jalur ke file CSV dengan MSISDN untuk melakukan pemeriksaan kemampuan
Jalur ke kunci akun layanan agen Anda di mesin pengembangan

Selain itu, Anda harus menginstal software berikut di mesin pengembangan:

Apache Maven 3.3.9 atau yang lebih baru
Java 8

Siapkan

Di mesin pengembangan, download dan ekstrak Skrip Pemeriksaan Kemampuan Massal (Java) Skrip Pemeriksaan Kemampuan Massal (Login untuk mendownload).
Ikuti langkah-langkah dalam README.

Jalankan pemeriksaan massal

Di terminal, buka direktori utama skrip.

Jalankan perintah berikut:

export MAVEN_OPTS="-Xms1024m -Xmx3000m"
mvn compile && mvn exec:java -Dexec.args="AGENT_ID INPUT_FILE OUTPUT_FILE NUM_OF_THREADS START_INDEX END_INDEX"

Ganti variabel dengan nilai yang telah Anda identifikasi.

Ganti	Dengan	Contoh
`AGENT_ID`	ID agen RCS Business Messaging	`welcome-bot`
`INPUT_FILE`	Jalur ke file CSV input.	`input.csv`
`OUTPUT_FILE`	Jalur ke file CSV output.	`output.csv`
`NUM_OF_THREADS`	Jumlah thread yang akan didedikasikan untuk pemeriksaan kemampuan.	`500`
`START_INDEX`	Opsional. Nilai dalam file CSV yang akan digunakan untuk mulai menjalankan pemeriksaan.	`5`
`END_INDEX`	Opsional. Nilai dalam file CSV untuk mengakhiri pemeriksaan setelahnya.	`500`

Setelah skrip selesai, buka file CSV output untuk melihat hasilnya.

Sebelumnya

Acara