关于通过WhatsApp Cloud API无第三方发送广播消息及相关问题咨询

1. 不借助第三方工具，能否通过WhatsApp Cloud API发送广播消息？ #

可以直接通过官方WhatsApp Cloud API实现广播消息发送，无需第三方工具，主要有两种合规方式：

• 方式一：使用预先创建的广播列表ID
  先通过WhatsApp Business客户端或Business Management API创建广播列表，获取列表ID后，调用Cloud API的消息发送端点，将to参数设为该广播列表ID即可。
• 方式二：直接指定多个收件人
  在API请求中使用recipients参数，传入最多256个符合要求的用户电话号码（需用户已与你的业务账号互动过，或已获得用户的明确许可）。

示例请求（直接指定多个收件人）：

POST /v18.0/<你的电话号码ID>/messages
Host: graph.facebook.com
Authorization: Bearer <你的访问令牌>

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "recipients": ["+1234567890", "+0987654321"],
  "text": {
    "body": "这是一条广播测试消息"
  }
}

注意：若发送给未主动发起互动的用户，必须使用Meta审核通过的业务消息模板，替换上述text字段为template参数。

2. 广播消息的替代方案及状态查询方法 #

替代方案 #

• 模板消息批量发送：针对未主动互动的用户，使用Meta审核通过的合规模板，通过recipients参数批量发送，符合WhatsApp商业政策要求。
• Business Management API管理分组：通过该API批量创建、更新用户分组或广播列表，再结合Cloud API发送消息，适合管理大量用户分组的场景。
• 分段式批量发送：将用户按标签或属性分组，分批次调用Cloud API发送消息，避免单次请求收件人过多触发平台限制。

查询消息已送达/已读状态 #

要获取消息的送达和已读状态，需配置并订阅Webhook事件：

1. 在Meta开发者后台为你的应用配置Webhook URL，并完成端点有效性验证。
2. 订阅messages和message_status两类Webhook事件。
3. 当消息状态变化时，Meta会向你的Webhook URL发送POST请求，其中包含关键状态标识：
   • delivered：消息已送达用户设备
   • read：用户已阅读消息

示例Webhook接收的状态通知Payload：

{
  "entry": [
    {
      "changes": [
        {
          "value": {
            "statuses": [
              {
                "id": "<消息ID>",
                "recipient_id": "<用户电话号码ID>",
                "status": "read",
                "timestamp": "1690000000"
              }
            ]
          },
          "field": "messages"
        }
      ]
    }
  ]
}

你可以通过消息ID关联本地发送记录，实时更新消息状态。

内容的提问来源于stack exchange，提问作者m appanasamy