查询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 |
是 |
查询开始时间。时间戳,单位:毫秒。 |
1693107714687 |
End |
integer |
是 |
查询结束时间。时间戳,单位:毫秒。 |
1693407714687 |
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. | 资源不属于当前用户。 |
访问错误中心查看更多错误码。
变更历史
更多信息,参考变更详情。