Perangkat uji

Sebelum Anda meluncurkan agen, agen hanya dapat berkomunikasi dengan perangkat uji yang ditentukan. 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 mendukung RCS. Perlu diketahui bahwa beberapa perangkat Android tidak mengaktifkan RCS secara default. Anda dapat memeriksa status RCS perangkat dan, jika perlu, mengaktifkan RCS dengan mengonfigurasi perangkat dengan versi pra-rilis aplikasi Pesan dan Layanan Operator.

Jika perangkat Anda mendukung RCS, Anda dapat mengirim permintaan penguji guna mengundang perangkat untuk menguji agen. Setelah menerima permintaan, perangkat dapat menerima dan merespons pesan dari agen yang tidak dibuka.

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 Anda

Di aplikasi Message, buka Settings messages.
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 perlu 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 mendukung 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 mendukung 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 Business Communications, 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 uji menguraikan 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 pemformatan dan nilai, lihat phones.testers.

URL

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('../libs/rbm_api_helper');

// Send the tester invite to the device
rbmApiHelper.sendTesterInvite('+12223334444', function(response) {
   console.log(response);
});

Kode ini adalah kutipan dari agen sampel RBM.

Java

import com.google.rbm.samples.lib.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 sampel 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 sampel 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 kutipan dari agen sampel RBM.

Langkah berikutnya

Setelah perangkat menerima permintaan penguji, perangkat ini adalah 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

Saat Anda menghapus perangkat uji, perangkat tersebut tidak dapat lagi menerima pesan dari agen yang tidak diluncurkan. Platform RBM tidak menghapus pesan yang dikirim oleh agen Anda yang sedang transit ke atau disimpan di perangkat pengujian.

Buka Konsol Developer Business Communications, login dengan akun Google RBM Anda, lalu klik agen Anda.
Di navigasi sebelah kiri, klik Perangkat.
Cari perangkat di Test device list dan klik menu untuk item daftar tersebut.
Klik Hapus perangkat.