Thiết lập thiết bị thử nghiệm

Cho đến khi bạn ra mắt nhân viên hỗ trợ, nhân viên hỗ trợ đó chỉ có thể giao tiếp với các thiết bị thử nghiệm được chỉ định. Điều này cho phép bạn kiểm thử tác nhân nội bộ để ngăn người dùng cuối vô tình truy cập sớm.

Để giao tiếp với một nhân viên hỗ trợ RBM, thiết bị thử nghiệm cần phải được bật RCS. Xin lưu ý rằng theo mặc định, một số thiết bị Android không bật RCS. Để kiểm tra trạng thái RCS của thiết bị, hãy xem phần Kiểm tra trạng thái RCS của thiết bị.

Mỗi ngày, nhân viên có thể gửi tối đa 20 lời mời thử nghiệm, với tổng giới hạn là 200 lời mời.

Kiểm tra trạng thái RCS của thiết bị

  1. Trong ứng dụng Tin nhắn, hãy chuyển đến phần Cài đặt Tin nhắn.
  2. Nhấn vào mục Cuộc trò chuyện RCS. Nếu bạn không tìm thấy mục "Cuộc trò chuyện RCS", hãy nhấn vào mục Các tính năng trò chuyện.
  3. Tìm giá trị Trạng thái.

Nếu thiết bị của bạn không hỗ trợ RCS, hãy bật RCS bằng cách định cấu hình thiết bị bằng các phiên bản phát hành trước của ứng dụng Tin nhắn và Các dịch vụ của nhà mạng.

Nếu thiết bị của bạn có hỗ trợ RCS, bạn có thể gửi lời mời kiểm thử. Khi chấp nhận lời mời, thiết bị có thể bắt đầu nhắn tin với tác nhân chưa ra mắt của bạn.

Bật RCS trên thiết bị

Để bật RCS trên thiết bị Android, hãy bật tính năng cuộc trò chuyện RCS trong ứng dụng Tin nhắn.

Khi RCS đang hoạt động trên thiết bị, bạn đã sẵn sàng gửi lời mời kiểm thử.

Gửi lời mời cho người kiểm thử

Để mời một thiết bị có hỗ trợ RCS trở thành người kiểm thử, bạn sẽ gửi lời mời kiểm thử. Khi thiết bị chấp nhận lời mời, nhân viên hỗ trợ có thể gửi tin nhắn, sự kiện và yêu cầu đến thiết bị.

Nếu thiết bị không hỗ trợ RCS, chưa phản hồi lời mời của người kiểm thử hoặc từ chối lời mời, thì tác nhân của bạn sẽ nhận được lỗi 403 PERMISSION_DENIED khi cố gắng giao tiếp với thiết bị.

Giao diện dòng lệnh

Cách gửi lời mời cho người kiểm thử bằng Bảng điều khiển dành cho nhà phát triển của Business Communications:

  1. Mở Business Communications Developer Console, đăng nhập bằng Tài khoản Google RBM của bạn rồi nhấp vào tác nhân của bạn.
  2. Trên trình đơn bên trái, hãy chọn Thiết bị.
  3. Thêm một thiết bị thử nghiệm vào Danh sách thiết bị thử nghiệm bằng cách nhập số điện thoại của thiết bị, bao gồm cả mã quốc gia và mã vùng. Để thêm nhiều số điện thoại, hãy phân tách các số điện thoại bằng dấu phẩy.

Khi một thiết bị được thêm vào danh sách, lời mời sẽ được gửi đi. Người dùng sẽ thấy thông báo mời trên thiết bị của họ và có thể chấp nhận hoặc từ chối lời mời.

Danh sách thiết bị thử nghiệm cho biết trạng thái lời mời kiểm thử cho từng thiết bị mà bạn mời kiểm thử nhân viên hỗ trợ.

API

Cách gửi lời mời cho người kiểm thử bằng RBM Management API:

  • Hãy sử dụng mã sau. Để biết các lựa chọn về định dạng và giá trị, hãy xem 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);
});
Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu 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();
}
Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu 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')
Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu 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");
Đoạn mã này là một phần trích dẫn từ một nhân viên hỗ trợ mẫu RBM.

Nếu bạn gửi hơn 200 lời mời, nền tảng RBM sẽ trả về mã lỗi 429 RESOURCE_EXHAUSTED để phản hồi.

Gửi lại lời mời cho người kiểm thử

Nếu cần, bạn có thể gửi lại lời mời cho người kiểm thử. Kết quả phụ thuộc vào trạng thái lời mời hiện tại của thiết bị.

Trạng thái thiết bị Kết quả
PENDING Lời mời kiểm thử được gửi đến thiết bị.
ACCEPTED Lời mời kiểm thử không được gửi đến thiết bị, thiết bị vẫn giữ trạng thái ACCEPTED.
DECLINED Lời mời kiểm thử bị từ chối. Trước khi gửi lại lời mời, bạn phải xoá thiết bị kiểm thử trước. Nếu không, yêu cầu sẽ không thành công.

Sau khi thiết bị chấp nhận lời mời kiểm thử, thiết bị đó sẽ trở thành thiết bị kiểm thử được chỉ định cho nhân viên hỗ trợ của bạn. Bạn có thể gửi tin nhắn, sự kiệncác chế độ kiểm tra chức năng đến thiết bị để kiểm thử chức năng và quy trình của nhân viên hỗ trợ.

Lấy trạng thái lời mời của một thiết bị kiểm thử

Khi bạn mời một người kiểm thử, họ có thể chấp nhận hoặc từ chối lời mời trên thiết bị của mình. Bạn có thể truy vấn API để biết trạng thái lời mời của thiết bị.

Giao diện dòng lệnh

Cách xem trạng thái lời mời của một thiết bị kiểm thử bằng Business Communications Developer Console:

  1. Mở Business Communications Developer Console, đăng nhập bằng Tài khoản Google RBM của bạn rồi nhấp vào tác nhân của bạn.
  2. Trên trình đơn bên trái, hãy chọn Thiết bị.
  3. Thêm một thiết bị thử nghiệm vào Danh sách thiết bị thử nghiệm bằng cách nhập số điện thoại của thiết bị, bao gồm cả mã quốc gia và mã vùng. Để thêm nhiều số điện thoại, hãy phân tách các số điện thoại bằng dấu phẩy.

Khi thêm một thiết bị kiểm thử vào danh sách, bạn có thể kiểm tra trạng thái của thiết bị đó trong cột Trạng thái.

API

Cách lấy trạng thái lời mời của một thiết bị thử nghiệm bằng RBM Management API:

  • Hãy sử dụng mã sau. Để biết các lựa chọn về định dạng và giá trị, hãy xem 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`"

Xem trạng thái của tất cả thiết bị kiểm thử

Bạn có thể truy vấn trạng thái lời mời của tất cả các thiết bị mà bạn đã mời tham gia kiểm thử.

Giao diện dòng lệnh

Cách kiểm tra trạng thái lời mời của tất cả thiết bị kiểm thử bằng Business Communications Developer Console:

  1. Mở Business Communications Developer Console, đăng nhập bằng Tài khoản Google RBM của bạn rồi nhấp vào tác nhân của bạn.
  2. Trên trình đơn bên trái, hãy chọn Thiết bị.
  3. Thêm một thiết bị thử nghiệm vào Danh sách thiết bị thử nghiệm bằng cách nhập số điện thoại của thiết bị, bao gồm cả mã quốc gia và mã vùng. Để thêm nhiều số điện thoại, hãy phân tách các số điện thoại bằng dấu phẩy.

Khi thêm một thiết bị kiểm thử vào danh sách, bạn có thể kiểm tra trạng thái của thiết bị đó trong cột Trạng thái.

API

Cách kiểm tra trạng thái lời mời của tất cả thiết bị thử nghiệm bằng RBM Management API:

  • Hãy sử dụng mã sau. Để biết các lựa chọn về định dạng và giá trị, hãy xem 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`"

Xoá thiết bị thử nghiệm

Khi bạn xoá một thiết bị kiểm thử, thiết bị đó sẽ không nhận được tin nhắn từ nhân viên hỗ trợ chưa ra mắt của bạn nữa. Nền tảng RBM không xoá những tin nhắn do nhân viên hỗ trợ của bạn gửi đang trên đường truyền hoặc được lưu trữ trên thiết bị thử nghiệm.

Giao diện dòng lệnh

Cách xoá một thiết bị thử nghiệm bằng Business Communications Developer Console:

  1. Mở Business Communications Developer Console, đăng nhập bằng Tài khoản Google RBM của bạn rồi nhấp vào tác nhân của bạn.
  2. Trên trình đơn bên trái, hãy chọn Thiết bị.
  3. Chọn thiết bị trong Danh sách thiết bị thử nghiệm rồi nhấp vào trình đơn .
  4. Nhấp vào Xoá thiết bị.

API

Cách xoá một thiết bị thử nghiệm bằng RBM Management API:

  • Hãy sử dụng mã sau. Để biết các lựa chọn về định dạng và giá trị, hãy xem 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`"