Perangkat pengujian

Sebelum meluncurkan agen, agen hanya dapat berkomunikasi dengan perangkat pengujian yang ditetapkan. Hal ini memungkinkan Anda menguji agen secara internal sekaligus mencegah akses awal yang tidak disengaja ke pengguna akhir.

Untuk berkomunikasi dengan agen RBM, perangkat pengujian harus mengaktifkan RCS. Perhatikan bahwa beberapa perangkat Android tidak mengaktifkan RCS secara default. Anda dapat memeriksa status RCS perangkat dan, jika perlu, mengaktifkan RCS dengan mengonfigurasi perangkat menggunakan versi pra-rilis aplikasi Message dan Layanan Operator.

Jika perangkat mendukung RCS, Anda dapat mengirim permintaan penguji untuk mengundang perangkat agar menguji agen. Setelah menerima permintaan, perangkat dapat menerima dan merespons pesan dari agen yang belum diluncurkan.

Agen dapat mengirim 20 permintaan penguji setiap hari dengan total maksimum 200 permintaan penguji. Jika Anda menambahkan penguji melalui RBM API dan mengirim lebih dari 200 permintaan, platform RBM akan menampilkan respons 429 RESOURCE_EXHAUSTED.

Memeriksa status RCS perangkat

Di aplikasi Message, buka Setelan Message.
Ketuk Chat RCS. Jika Anda tidak dapat menemukan "chat RCS", ketuk Fitur chat.
Temukan nilai Status.

Jika Status Terhubung, RCS akan aktif di perangkat Anda.

Langkah berikutnya

Jika RCS aktif di perangkat, Anda siap mengirim permintaan penguji. Jika RCS tidak aktif di perangkat, Anda harus mengaktifkan RCS di perangkat sebelum dapat mulai menguji agen RBM dengannya.

Mengaktifkan RCS di perangkat Anda

Untuk mengaktifkan RCS di perangkat Android, aktifkan chat RCS di aplikasi Message.

Langkah berikutnya

Setelah RCS aktif di perangkat, Anda siap mengirim permintaan penguji.

Mengirim permintaan penguji

Untuk mengundang perangkat yang kompatibel dengan RCS menjadi penguji, Anda harus mengirimkan permintaan penguji. Jika perangkat menerima permintaan, agen Anda dapat mengirim pesan, peristiwa, dan permintaan ke perangkat.

Jika perangkat tidak mengaktifkan RCS, tidak merespons permintaan penguji, atau menolak permintaan, agen Anda akan menerima error 403 PERMISSION_DENIED saat mencoba berkomunikasi dengan perangkat.

Opsi 1: Mengirim permintaan penguji dengan Konsol Developer Business Communications

Buka Konsol Developer Komunikasi Bisnis, login dengan Akun Google RBM Anda, lalu klik agen Anda.
Di navigasi sebelah kiri, klik Perangkat.
Untuk Tambahkan perangkat pengujian, masukkan nomor telepon perangkat Anda, lalu klik Tambahkan.

Daftar perangkat pengujian menjelaskan status permintaan penguji untuk setiap perangkat yang Anda undang untuk menguji agen Anda.

Opsi 2: Mengirim permintaan penguji dengan RBM API

Kode berikut mengirimkan permintaan penguji. Untuk opsi format dan nilai, lihat phones.testers.

cURL

curl -X POST "https://REGION-rcsbusinessmessaging.googleapis.com/v1/phones/PHONE_NUMBER/testers" \
-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 the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', 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();

   // Register the device as a tester
   rbmApiHelper.registerTester("+12223334444");
} catch(Exception e) {
   e.printStackTrace();
}

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
rbm_service.invite_tester('+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
rbmApiHelper.RegisterTester("+12223334444");

Kode ini adalah nukilan dari agen contoh RBM.

Langkah berikutnya

Setelah perangkat menerima permintaan penguji, perangkat tersebut akan menjadi perangkat pengujian yang ditetapkan untuk agen Anda. Anda dapat mengirim pesan, peristiwa, dan pemeriksaan kemampuan ke perangkat untuk menguji fungsi dan alur kerja agen.

Menghapus perangkat pengujian

Jika Anda menghapus perangkat pengujian, perangkat tersebut tidak dapat lagi menerima pesan dari agen Anda yang belum diluncurkan. Platform RBM tidak menghapus pesan yang dikirim oleh agen Anda yang sedang dalam pengiriman ke atau disimpan di perangkat pengujian.

Buka Konsol Developer Komunikasi Bisnis, login dengan Akun Google RBM Anda, lalu klik agen Anda.
Di navigasi sebelah kiri, klik Perangkat.
Temukan perangkat di Daftar perangkat pengujian, lalu klik menu untuk item daftar tersebut.
Klik Hapus perangkat.