Halaman ini diterjemahkan oleh Cloud Translation API.

Pemeriksaan kemampuan

Untuk memeriksa apakah perangkat pengguna mendukung RCS dan dapat berkomunikasi dengan agen RBM, Anda dapat meminta kemampuan perangkat. Mengidentifikasi fitur yang didukung perangkat, jika ada, memungkinkan agen Anda menyesuaikan percakapan dengan kemampuan perangkat dan menghindari menampilkan interaksi yang sulit atau tidak mungkin diselesaikan oleh pengguna.

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

Memeriksa kemampuan perangkat

Kode berikut mengirim pemeriksaan kemampuan dan menunggu respons. Untuk opsi pemformatan 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 oleh perangkat yang ditentukan.

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

Permintaan menampilkan respons atau error.

Respons berhasil ditampilkan hanya jika MSISDN (nomor telepon) telah terhubung ke layanan RCS dalam 31 hari terakhir. Artinya, perangkat pengguna telah melakukan check-in dengan server RCS kami dalam jangka waktu tersebut. Perangkat online dan yang kompatibel dengan RCS melakukan check-in setiap 1-4 jam rata-rata.

Jika pengguna memindahkan kartu SIM ke perangkat lain yang kompatibel dengan RCS, atribusi perangkat sebelumnya akan dihapus, dan atribusi baru akan dibuat, sehingga memperbarui kemampuan perangkat di layanan RCS.

Jika kartu SIM dimasukkan ke dalam perangkat yang RCS-nya dinonaktifkan oleh operator atau produsen, atau kartu SIM tetap tidak digunakan, layanan RCS akan tetap mencoba mengirimkan pesan ke perangkat yang sebelumnya terkait hingga 31 hari.

Berikut penyebab error 404:

Pengguna tidak dapat dijangkau oleh RBM–misalnya, jika perangkat mereka tidak mendukung RCS.
Pengguna memiliki RCS, tetapi agen Anda tidak diluncurkan di jaringan seluler mereka.

Antrean offline

Pesan diantrekan hingga 31 hari dan dikirim saat perangkat kembali online. Artinya, meskipun perangkat offline dalam jangka waktu yang lama (hingga 31 hari), pesan yang diantrekan akan tetap dikirim setelah terhubung kembali, selama MSISDN telah terhubung ke layanan RCS dalam 31 hari terakhir.

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.

Untuk setiap pemeriksaan kapabilitas massal, Anda harus memberikan 500–10.000 nomor telepon unik. Untuk memeriksa lebih banyak nomor, lakukan beberapa pemeriksaan. Anda dapat melakukan hingga 600 panggilan per menit. Gunakan Skrip Pemeriksaan Kemampuan Massal untuk menggunakan file CSV sebagai format input. Pemeriksaan massal dibaca dari cache kemampuan, yang diperbarui secara organik oleh klien menggunakan RCS. Agen tidak meminta kemampuan setiap perangkat secara langsung. Oleh karena itu, hasil mungkin tidak terbaru.

Pemeriksaan kemampuan massal menampilkan daftar nomor yang dapat dihubungi agen Anda di operator tempat agen diluncurkan, serta perkiraan 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 dihubungi secara langsung di operator yang meluncurkan agen Anda (reachableUsers), respons juga menyertakan dua nilai yang dapat membantu Anda memperkirakan jumlah total pengguna yang dapat dihubungi di semua operator.

Cara kerjanya

Saat agen Anda melakukan pemeriksaan kemampuan massal, RBM akan mengambil sampel secara acak ~75% dari nomor tersebut untuk memeriksa semua operator (dilaporkan dalam 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 Anda jika diluncurkan di semua operator.

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

Memperhitungkan pengambilan sampel acak

Pengujian sampel acak dapat menyebabkan variasi 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 pengambilan sampel acak.

Mengirim pemeriksaan kemampuan massal

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

Nomor telepon harus dalam format E.164 (misalnya, "+12223334444"), dan daftar harus berisi 500 hingga 10.000 nomor telepon unik.

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 akan 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 nomor yang ditentukan.
`reachableRandomSampleUserCount`	Jumlah angka dari sampel acak yang dapat dijangkau RBM di semua operator, terlepas dari operator tempat agen diluncurkan. Jumlah ini digunakan untuk memberikan perkiraan kasar jumlah total pengguna yang dapat dijangkau di semua operator.
`reachableUsersMap`	Hanya output. Memetakan ID operator ke daftar pengguna yang dapat dijangkau di operator tersebut. Kolom ini hanya diisi untuk nomor telepon Amerika Serikat.

Alat: Skrip Pemeriksaan Kemampuan Massal

Skrip Pemeriksaan Kemampuan Massal (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 secara keseluruhan bergantung pada mesin yang digunakan, negara perangkat, konfigurasi regional agen Anda, dan endpoint API yang digunakan.

Prasyarat

Sebelum menggunakan alat 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 memerlukan software berikut yang diinstal di mesin pengembangan:

Apache Maven 3.3.9 atau yang lebih baru
Java 8

Siapkan

Untuk menyiapkan mesin pengembangan Anda untuk pemeriksaan kemampuan massal, lakukan langkah-langkah berikut:

Download dan ekstrak Skrip Pemeriksaan Kemampuan Massal (Login untuk mendownload).
Ikuti langkah-langkah dalam README.

Menjalankan pemeriksaan kapabilitas massal

Untuk menjalankan pemeriksaan massal, ikuti langkah-langkah berikut:

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 for Business.	`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 dikhususkan untuk pemeriksaan kemampuan.	`500`
`START_INDEX`	Opsional. Nilai dalam file CSV 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

Pemeriksaan kemampuan Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Memeriksa kemampuan perangkat

cURL

Node.js

Java

Python

C#

Respons kemampuan

Antrean offline

Pemeriksaan kemampuan massal

Memperkirakan total pengguna yang dapat dijangkau

Cara kerjanya

Memperhitungkan pengambilan sampel acak

Mengirim pemeriksaan kemampuan massal

cURL

Node.js

Java

Python

C#

Respons pemeriksaan kemampuan massal

Alat: Skrip Pemeriksaan Kemampuan Massal

Prasyarat

Siapkan

Menjalankan pemeriksaan kapabilitas massal

Pemeriksaan kemampuan