Method: phones.testers.create

Mời người dùng kiểm thử một tác nhân.

Người dùng được mời phải có tính năng RCS và có thể liên hệ được thông qua nền tảng RCS cho doanh nghiệp. Khi một nhân viên mời người dùng trở thành người kiểm thử, nhân viên quản lý nền tảng RCS cho doanh nghiệp sẽ gửi một tin nhắn cho người dùng để yêu cầu họ xác nhận rằng họ muốn trở thành người kiểm thử của nhân viên đó. Sau khi xác nhận, người dùng sẽ trở thành người kiểm thử.

Nhân viên hỗ trợ chưa ra mắt chỉ có thể tương tác với những người dùng là người kiểm thử của nhân viên hỗ trợ đó. Nếu một tác nhân chưa ra mắt cố gắng gửi thông báo, sự kiện hoặc lệnh gọi lại chức năng đến một người không phải là người kiểm thử, thì nền tảng RCS cho doanh nghiệp sẽ trả về lỗi 403 PERMISSION_DENIED.

Mỗi ngày, một nhân viên hỗ trợ có thể gửi 20 yêu cầu cho người kiểm thử, với tổng số yêu cầu tối đa là 200. Nếu bạn gửi yêu cầu kiểm thử vượt quá các giới hạn đó, nền tảng RCS cho Doanh nghiệp sẽ trả về phản hồi 429 RESOURCE_EXHAUSTED.

Không dùng nữa: Phương thức này sẽ ngừng hoạt động từ ngày 31 tháng 1 năm 2026. Vui lòng xem phương thức Người kiểm thử mới trong Business Communications API để biết thêm thông tin.

Yêu cầu HTTP

POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers

URL sử dụng cú pháp Chuyển mã gRPC.

Tham số đường dẫn

Thông số
parent

string

"phones/{E.164}", trong đó {E.164} là số điện thoại của người dùng ở định dạng E.164. Ví dụ: với số điện thoại ở Hoa Kỳ là +1-222-333-4444, điểm cuối thu được sẽ là https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.

Tham số truy vấn

Thông số
agentId

string

Bắt buộc. Giá trị nhận dạng riêng biệt của nhân viên.

Nội dung yêu cầu

Nội dung yêu cầu chứa một bản sao của Tester.

Nội dung phản hồi

Nếu thành công, nội dung phản hồi sẽ chứa một thực thể mới tạo của Tester.

Phạm vi uỷ quyền

Yêu cầu phạm vi OAuth sau:

  • https://www.googleapis.com/auth/rcsbusinessmessaging

Để biết thêm thông tin, hãy xem OAuth 2.0 Overview.