new_releases Updates: Check the
release notes for new features and product updates.
Method: phones.testers.create
Stay organized with collections
Save and categorize content based on your preferences.
Invites a user to test an agent.
The invited user must be RCS-enabled and reachable by the RBM platform. When an agent invites a user to become a tester, an RBM platform management agent sends a message to the user asking for confirmation that she wants to be a tester of the agent. Once the user confirms, she becomes a tester.
An agent that has not yet launched can only interact with users who are testers of that agent. If an unlaunched agent attempts to send a message, event, or capability callback to a non-tester, the RBM platform returns a 403 PERMISSION_DENIED error.
An agent can send 20 tester requests each day with a total maximum of 200 tester requests. If you send tester requests above those limits, the RBM platform returns a 429 RESOURCE_EXHAUSTED response.
HTTP request
POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
"phones/{E.164}", where {E.164} is the user's phone number in E.164 format. For example, with the US phone number +1-222-333-4444, the resulting endpoint would be https://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/.
|
Query parameters
| Parameters |
agentId |
string
Required. The agent's unique identifier.
|
Request body
The request body contains an instance of Tester.
Response body
If successful, the response body contains a newly created instance of Tester.
Authorization scopes
Requires the following OAuth scope:
https://www.googleapis.com/auth/rcsbusinessmessaging
For more information, see the OAuth 2.0 Overview.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-04-27 UTC.
[null,null,["Last updated 2025-04-27 UTC."],[[["\u003cp\u003eUsers can be invited to test an agent, but they must be RCS-enabled and reachable by the RBM platform, and they must also confirm their desire to be a tester.\u003c/p\u003e\n"],["\u003cp\u003eUnlaunched agents can only interact with users who have been confirmed as testers, otherwise a \u003ccode\u003e403 PERMISSION_DENIED\u003c/code\u003e error will occur.\u003c/p\u003e\n"],["\u003cp\u003eAn agent is restricted to sending only 20 tester requests per day, with a maximum of 200 tester requests total, exceeding these limits results in a \u003ccode\u003e429 RESOURCE_EXHAUSTED\u003c/code\u003e error.\u003c/p\u003e\n"],["\u003cp\u003eThe URL endpoint for sending a request to invite a tester follows the format \u003ccode\u003ePOST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers\u003c/code\u003e where the phone number of the user must be in E.164 format.\u003c/p\u003e\n"],["\u003cp\u003eAn agent's unique identifier is required in the request as the \u003ccode\u003eagentId\u003c/code\u003e query parameter.\u003c/p\u003e\n"]]],[],null,["# Method: phones.testers.create\n\nInvites a user to test an agent.\n\nThe invited user must be RCS-enabled and reachable by the RBM platform. When an agent invites a user to become a tester, an RBM platform management agent sends a message to the user asking for confirmation that she wants to be a tester of the agent. Once the user confirms, she becomes a tester.\n\nAn agent that has not yet launched can only interact with users who are testers of that agent. If an unlaunched agent attempts to send a message, event, or capability callback to a non-tester, the RBM platform returns a `403 PERMISSION_DENIED` error.\n\nAn agent can send 20 tester requests each day with a total maximum of 200 tester requests. If you send tester requests above those limits, the RBM platform returns a `429 RESOURCE_EXHAUSTED` response.\n\n### HTTP request\n\n`POST https://rcsbusinessmessaging.googleapis.com/v1/{parent=phones/*}/testers`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` \"phones/{E.164}\", where {E.164} is the user's phone number in E.164 format. For example, with the US phone number +1-222-333-4444, the resulting endpoint would be \u003chttps://rcsbusinessmessaging.googleapis.com/v1/phones/+12223334444/testers/\u003e. |\n\n### Query parameters\n\n| Parameters ||\n|-----------|---------------------------------------------------|\n| `agentId` | `string` Required. The agent's unique identifier. |\n\n### Request body\n\nThe request body contains an instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Response body\n\nIf successful, the response body contains a newly created instance of [Tester](/business-communications/rcs-business-messaging/reference/rest/v1/phones.testers#Tester).\n\n### Authorization scopes\n\nRequires the following OAuth scope:\n\n- `https://www.googleapis.com/auth/rcsbusinessmessaging`\n\nFor more information, see the [OAuth 2.0 Overview](/identity/protocols/OAuth2)."]]