开发WhatsApp Cloud API Webhook：回复消息遇131047错误求助

云上老周

2026-6-19

解决WhatsApp Cloud API错误代码131047的问题

问题根源

错误代码131047是WhatsApp核心规则限制导致的：用户最后一次主动回复你的号码后，超过了24小时的会话窗口期限，此时无法发送普通会话消息，必须使用官方审核通过的**消息模板（HSM）**才能触达用户。

解决方案

1. 明确会话窗口规则

用户主动发起消息后，你拥有24小时的「自由会话期」，可发送任意内容的普通消息
超过24小时后，仅能发送预先通过Meta审核的模板消息，这类消息多用于通知、服务提醒场景，内容需符合WhatsApp商业政策

2. 使用审核通过的消息模板发送

先在Meta Business Manager中创建并提交消息模板，等待审核通过后，用以下格式发送：

{
  "messaging_product": "whatsapp",
  "recipient_type": "individual",
  "to": "MY_NUMBER",
  "type": "template",
  "template": {
    "name": "已审核通过的模板名称",
    "language": {
      "code": "zh_CN" // 对应模板的语言代码，如en_US
    },
    "components": [
      {
        "type": "body",
        "parameters": [
          {
            "type": "text",
            "text": "替换模板中的变量内容"
          }
        ]
      }
    ]
  }
}