Sebelum Anda meluncurkan agen, agen hanya dapat berkomunikasi dengan perangkat uji yang ditentukan. Dengan begitu, Anda dapat menguji agen secara internal untuk mencegah akses awal yang tidak disengaja oleh pengguna akhir.
Untuk berkomunikasi dengan agen RBM, perangkat pengujian harus mendukung RCS. Perhatikan bahwa beberapa perangkat Android tidak mengaktifkan RCS secara default. Untuk memeriksa status RCS perangkat Anda, lihat Memeriksa status RCS perangkat Anda.
Agen dapat mengirim maksimum 20 undangan penguji per hari, dengan total batas 200 undangan.
Memeriksa status RCS perangkat Anda
- Di aplikasi Pesan, buka Setelan pesan.
- Ketuk Chat RCS. Jika Anda tidak dapat menemukan "chat RCS", ketuk Fitur chat.
- Temukan nilai Status.
Jika perangkat Anda tidak mendukung RCS, aktifkan RCS dengan mengonfigurasi perangkat Anda menggunakan aplikasi Message dan Layanan Operator versi pra-rilis.
Jika perangkat Anda mendukung RCS, Anda dapat mengirim undangan penguji. Saat perangkat menerima undangan, perangkat dapat mulai mengirim pesan dengan agen Anda yang belum diluncurkan.
Mengaktifkan RCS di perangkat Anda
Untuk mengaktifkan RCS di perangkat Android, aktifkan chat RCS di aplikasi Message.
Jika RCS aktif di perangkat Anda, Anda siap mengirim undangan penguji.
Mengirim undangan penguji
Untuk mengundang perangkat yang mendukung RCS menjadi penguji, Anda mengirim undangan penguji. Saat perangkat menerima undangan, agen Anda dapat mengirim pesan, peristiwa, dan permintaan ke perangkat.
Jika perangkat tidak mendukung RCS, belum merespons undangan penguji, atau menolak undangan, agen Anda akan menerima error 403 PERMISSION_DENIED
saat mencoba berkomunikasi dengan perangkat.
Konsol
Untuk mengirim undangan penguji dengan Konsol Developer Business Communications:
- Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
- Di menu kiri, pilih Perangkat.
- Tambahkan perangkat uji ke Daftar perangkat uji dengan memasukkan nomor telepon perangkat, termasuk kode negara dan kode area. Untuk menambahkan beberapa nomor telepon, pisahkan dengan koma.
Saat perangkat ditambahkan ke daftar, undangan akan dikirim. Pengguna akan melihat pesan undangan di perangkatnya dan memiliki opsi untuk menerima atau menolaknya.
Daftar perangkat uji mencantumkan detail status undangan penguji untuk setiap perangkat yang Anda undang untuk menguji agen Anda.
API
Untuk mengirim undangan penguji dengan RBM Management API:
Gunakan kode berikut. Untuk opsi pemformatan dan nilai, lihat
testers
.
cURL
curl -X POST "https://businesscommunications.googleapis.com/v1/testers" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`" \ -d '{"phone_number": "PHONE_NUMBER", "agentId": "AGENT_ID"}'
Node.js
// Reference to RBM API helper const rbmApiHelper = require('@google/rcsbusinessmessaging'); // Send the tester invite to the device rbmApiHelper.sendTesterInvite('+12223334444', function(response) { console.log(response); });
Java
import com.google.rbm.RbmApiHelper; … try { // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(); // Register the device as a tester rbmApiHelper.registerTester("+12223334444"); } catch(Exception e) { e.printStackTrace(); }
Python
# Reference to RBM Python client helper from rcs_business_messaging import rbm_service # Send the tester invite to a device rbm_service.invite_tester('+12223334444')
C#
using RCSBusinessMessaging; … // Create an instance of the RBM API helper RbmApiHelper rbmApiHelper = new RbmApiHelper(credentialsFileLocation, projectId); // Register the device as a tester rbmApiHelper.RegisterTester("+12223334444");
Jika Anda mengirim lebih dari 200 undangan, platform RBM akan menampilkan kode error 429 RESOURCE_EXHAUSTED
sebagai respons.
Mengirim ulang undangan penguji
Jika perlu, Anda dapat mengirim ulang undangan penguji. Hasilnya bergantung pada status undangan saat ini perangkat.
Status perangkat | Hasil |
PENDING
|
Undangan penguji dikirim ke perangkat. |
ACCEPTED
|
Undangan penguji tidak dikirim ke perangkat, yang mempertahankan status ACCEPTED -nya.
|
DECLINED
|
Undangan penguji ditolak. Anda harus menghapus perangkat pengujian terlebih dahulu, sebelum mengirim ulang undangan. Jika tidak, permintaan akan gagal. |
Setelah perangkat menerima undangan penguji, perangkat tersebut akan menjadi perangkat pengujian yang ditentukan untuk agen Anda. Anda dapat mengirim pesan, peristiwa, dan pemeriksaan kemampuan ke perangkat untuk menguji fungsi dan alur kerja agen Anda.
Mendapatkan status undangan perangkat pengujian
Saat Anda mengundang penguji, mereka dapat menerima atau menolak undangan di perangkat mereka. Anda dapat membuat kueri API untuk mengetahui status undangan perangkat.
Konsol
Untuk mendapatkan status undangan perangkat pengujian dengan Konsol Developer Business Communications:
- Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
- Di menu kiri, pilih Perangkat.
- Tambahkan perangkat uji ke Daftar perangkat uji dengan memasukkan nomor telepon perangkat, termasuk kode negara dan kode area. Untuk menambahkan beberapa nomor telepon, pisahkan dengan koma.
Saat perangkat pengujian ditambahkan ke daftar, Anda dapat memeriksa statusnya di kolom Status.
API
Untuk mendapatkan status undangan perangkat pengujian dengan RBM Management API:
Gunakan kode berikut. Untuk opsi pemformatan dan nilai, lihat
testers
.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Mendapatkan status semua perangkat pengujian
Anda dapat membuat kueri status undangan semua perangkat yang Anda undang untuk menjadi penguji.
Konsol
Untuk memeriksa status undangan semua perangkat pengujian dengan Konsol Developer Business Communications:
- Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
- Di menu kiri, pilih Perangkat.
- Tambahkan perangkat uji ke Daftar perangkat uji dengan memasukkan nomor telepon perangkat, termasuk kode negara dan kode area. Untuk menambahkan beberapa nomor telepon, pisahkan dengan koma.
Saat perangkat pengujian ditambahkan ke daftar, Anda dapat memeriksa statusnya di kolom Status.
API
Untuk memeriksa status undangan semua perangkat pengujian dengan RBM Management API:
Gunakan kode berikut. Untuk opsi pemformatan dan nilai, lihat
testers
.
cURL
curl -X GET "https://businesscommunications.googleapis.com/v1/testers?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"
Menghapus perangkat pengujian
Saat Anda menghapus perangkat pengujian, perangkat tersebut tidak dapat lagi menerima pesan dari agen yang belum diluncurkan. Platform RBM tidak menghapus pesan yang dikirim oleh agen Anda yang sedang dalam perjalanan ke atau disimpan di perangkat pengujian.
Konsol
Untuk menghapus perangkat pengujian dengan Konsol Developer Business Communications:
- Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
- Di menu kiri, pilih Perangkat.
- Pilih perangkat di Daftar perangkat pengujian, lalu klik menu .
- Klik Hapus perangkat.
API
Untuk menghapus perangkat pengujian dengan RBM Management API:
Gunakan kode berikut. Untuk opsi pemformatan dan nilai, lihat
testers
.
cURL
curl -X DELETE "https://businesscommunications.googleapis.com/v1/testers/PHONE_NUMBER?agentId=AGENT_ID" \ -H "Content-Type: application/json" \ -H "User-Agent: curl/rcs-business-messaging" \ -H "`oauth2l header --json PATH_TO_SERVICE_ACCOUNT_KEY businesscommunications`"