查询WhatsApp类型通道号码的发送量指标。
接口说明
-
此接口只能查询 WhatsApp 类型通道的号码发送量统计指标。
-
您可调用此接口查询号码发送量指标,也可在通道管理>管理>客户统计日报界面查询号码发送量指标。
-
在调用此接口前,请先调用 EnableWhatsAppROIMetric 接口开启 WhatsApp ROI 指标统计,开启后至少需一天才会有统计数据,开启前的消息发送量指标将不进行统计。
-
开启 WhatsApp ROI 指标统计后,请确保您创建的通道已有成功发送的消息。您可在通道管理>管理>消息发送界面发送消息,或通过 SendChatappMessage 、 SendChatappMassMessage 接口发送消息。
QPS 限制
本接口的单用户 QPS 限制为 50 次/秒。超过限制,API 调用会被限流,这可能会影响您的业务,请合理调用。
调试
您可以在OpenAPI Explorer中直接运行该接口,免去您计算签名的困扰。运行成功后,OpenAPI Explorer可以自动生成SDK代码示例。
调试
授权信息
|
操作 |
访问级别 |
资源类型 |
条件关键字 |
关联操作 |
|
cams:GetChatappPhoneNumberMetric |
get |
*全部资源
|
无 | 无 |
请求参数
|
名称 |
类型 |
必填 |
描述 |
示例值 |
| IsvCode |
string |
否 |
ISV 校验码,用于校验子账号是否由 ISV 授权。 |
skdi3kksloslikd**** |
| CustSpaceId |
string |
否 |
ISV 子客户的 SpaceId/实例 ID。即通道 ID,在通道管理界面查看。 |
cams-************ |
| Granularity |
string |
否 |
指标粒度。取值:
|
DAILY |
| Start |
integer |
是 |
查询开始时间。时间戳,单位:毫秒。 |
1756742399000 |
| End |
integer |
是 |
查询结束时间。时间戳,单位:毫秒。 |
1758902399000 |
| PhoneNumber |
string |
否 |
商业号码。即为您发送消息的号码,在通道管理>管理>WABA 管理>号码管理界面查看。 |
861380000**** |
返回参数
|
名称 |
类型 |
描述 |
示例值 |
|
object |
返回数据。 |
||
| AccessDeniedDetail |
string |
访问被拒绝详细信息。 |
None |
| RequestId |
string |
请求 ID。 |
608F9CCA-B5EB-3D72-8047-B25D6D75BDEC |
| Message |
string |
错误提示信息。 |
None |
| Data |
array<object> |
返回数据列表。 |
|
|
object |
返回数据对象。 |
||
| DeliveredCount |
integer |
到达量。 |
5 |
| Start |
integer |
指标统计开始时间。时间戳,单位:毫秒。 |
1669619491000 |
| PhoneNumber |
string |
商业号码。 |
861380000**** |
| End |
integer |
指标统计结束时间。时间戳,单位:毫秒。 |
1667196043904 |
| Granularity |
string |
指标粒度。 |
DAILY |
| SentCount |
integer |
发送量。 |
10 |
| Code |
string |
请求状态码。取值:
|
OK |
示例
正常返回示例
JSON格式
{
"AccessDeniedDetail": "None",
"RequestId": "608F9CCA-B5EB-3D72-8047-B25D6D75BDEC\n",
"Message": "None",
"Data": [
{
"DeliveredCount": 5,
"Start": 1669619491000,
"PhoneNumber": "861380000****",
"End": 1667196043904,
"Granularity": "DAILY",
"SentCount": 10
}
],
"Code": "OK"
}
错误码
|
HTTP status code |
错误码 |
错误信息 |
描述 |
|---|---|---|---|
| 400 | Product.Unsubscript | You have not subscribed to the specified product. | 您尚未订阅指定的产品。 |
| 400 | Ram.PermissionDeny | You are not authorized to perform the operation. | 您无权执行该操作。 |
| 400 | System.LimitControl | The system is under flow control. | 系统处于流控制之下。 |
| 400 | Unknown.ResourceOwnerId | The resource does not belong to the current user. | 资源不属于当前用户。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。