Menyiapkan perangkat pengujian

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

  1. Di aplikasi Pesan, buka Setelan pesan.
  2. Ketuk Chat RCS. Jika Anda tidak dapat menemukan "chat RCS", ketuk Fitur chat.
  3. 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:

  1. Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
  2. Di menu kiri, pilih Perangkat.
  3. 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);
});
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 kutipan dari agen contoh RBM.

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:

  1. Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
  2. Di menu kiri, pilih Perangkat.
  3. 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:

  1. Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
  2. Di menu kiri, pilih Perangkat.
  3. 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:

  1. Buka Konsol Developer Business Communications, login dengan Akun Google RBM Anda, lalu klik agen Anda.
  2. Di menu kiri, pilih Perangkat.
  3. Pilih perangkat di Daftar perangkat pengujian, lalu klik menu .
  4. 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`"