使用WhatsApp API含动态URL按钮模板时遇参数缺失错误求助

你当前的请求存在两个核心问题：

1. 结构错误：components字段必须嵌套在template对象内部，不能和template同级。WhatsApp API只会读取template内的组件配置，根节点的components会被忽略，导致URL按钮的参数无法被识别，触发缺失参数的错误。

2. 模板匹配问题：确保你在WhatsApp后台创建的invitation模板中，URL按钮确实设置了动态占位符（比如{{1}}），否则即使传了参数也会报错。

修正后的请求体 #

{
  "messaging_product": "whatsapp",
  "to": "001555444555",
  "type": "template",
  "template": {
    "name": "invitation",
    "language": {
      "code": "he"
    },
    "components": [
      {
        "type": "body"
      },
      {
        "type": "button",
        "sub_type": "url",
        "index": 0,
        "parameters": [
          {
            "type": "text",
            "text": "1234567"
          }
        ]
      }
    ]
  }
}

额外注意事项 #

• 电话号码建议使用E.164标准格式（比如+1555444555），避免格式兼容问题。
• 确认invitation模板已通过WhatsApp平台审核，且URL按钮的动态参数配置和请求体中的参数数量、顺序一致。

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