如何通过WhatsApp Business API获取24小时消息发送上限及已发量？

可以通过WhatsApp Business API获取24小时内的消息发送限制及相关统计数据。

正确的API调用接口 #

你当前使用的GET /{phone-number-id}/phone_numbers接口无法返回具体额度数值和已发送统计，需调用以下专用接口：

GET https://graph.facebook.com/v17.0/{phone-number-id}/message_limits?access_token={access_token}

返回结果示例及说明 #

该接口会返回符合你需求的格式数据，示例如下：

{
  "id": "your-phone-number-id",
  "quality_rating": "GREEN",
  "message_limit": 1000,
  "next_limit_reset_timestamp": "2024-06-06T00:00:00Z",
  "tier": "TIER_1"
}

各核心字段含义：

• message_limit：当前24小时周期内的最大可发送消息数
• next_limit_reset_timestamp：限制额度重置的时间戳
• tier：当前对应的发送等级（对应官方的1K/10K/100K/无限量层级）
• quality_rating：账号质量评级，直接影响发送限制等级

补充说明 #

官方定义的商家发起对话限制层级分为：

1K商家发起对话
10K商家发起对话
100K商家发起对话
无限量商家发起对话

通过message_limits接口可实时获取当前额度及已发送数量（部分API版本返回会包含messages_sent字段），以此控制应用的消息发送逻辑，避免触发限制。

内容的提问来源于stack exchange，提问作者Ivano Mercuri