new_releases Updates: Check the
release notes for new features and product updates.
Method: phones.capability.requestCapabilityCallback
Stay organized with collections
Save and categorize content based on your preferences.
Requests a callback containing the capabilities of a user.
Following this request, the agent receives an asynchronous callback with the user's capabilities. DEPRECATED: Please use phones.getCapabilities instead.
HTTP request
POST https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capability:requestCapabilityCallback
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
name |
string
"phones/{E.164}/capability", 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/capability:requestCapabilityCallback
|
Request body
The request body contains data with the following structure:
| JSON representation |
{
"requestId": string
} |
| Fields |
requestId |
string
The ID of the request, assigned by the agent. This must be a UUID, as defined in https://tools.ietf.org/html/rfc4122. This request ID is included in the capability callback, which returns asynchronously.
|
Response body
If successful, the response body is an empty JSON object.
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\u003eThis endpoint is deprecated and should be replaced with \u003ccode\u003ephones.getCapabilities\u003c/code\u003e.\u003c/p\u003e\n"],["\u003cp\u003eIt allows for requesting a callback containing a user's capabilities via an asynchronous process.\u003c/p\u003e\n"],["\u003cp\u003eThe request is made using a POST HTTP request to a URL that includes the user's phone number in E.164 format.\u003c/p\u003e\n"],["\u003cp\u003eThe request body requires a \u003ccode\u003erequestId\u003c/code\u003e field, which is a UUID assigned by the agent and included in the capability callback.\u003c/p\u003e\n"],["\u003cp\u003eThe endpoint requires the OAuth scope \u003ccode\u003ehttps://www.googleapis.com/auth/rcsbusinessmessaging\u003c/code\u003e to be authorized.\u003c/p\u003e\n"]]],[],null,["# Method: phones.capability.requestCapabilityCallback\n\n| This item is deprecated!\nRequests a callback containing the capabilities of a user.\n\nFollowing this request, the agent receives an asynchronous callback with the user's capabilities. DEPRECATED: Please use phones.getCapabilities instead.\n\n### HTTP request\n\n`POST https://rcsbusinessmessaging.googleapis.com/v1/{name=phones/*}/capability:requestCapabilityCallback`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|--------|--------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `name` | `string` \"phones/{E.164}/capability\", 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/capability:requestCapabilityCallback\u003e |\n\n### Request body\n\nThe request body contains data with the following structure:\n\n| JSON representation |\n|---------------------------------|\n| ``` { \"requestId\": string } ``` |\n\n| Fields ||\n|-------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `requestId` | `string` The ID of the request, assigned by the agent. This must be a UUID, as defined in \u003chttps://tools.ietf.org/html/rfc4122\u003e. This request ID is included in the capability callback, which returns asynchronously. |\n\n### Response body\n\nIf successful, the response body is an empty JSON object.\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)."]]