如何修复WhatsApp API的按钮参数异常及模板参数数量不匹配错误

错误原因解析 #

• body参数不匹配：请求中给body传递了1个参数，但Meta商务平台创建的velvetek_gaming模板的body部分未定义可替换占位符，导致API提示参数数量与预期不符。
• 按钮参数异常：若之前出现url键意外出现的情况，多因按钮类型与参数不匹配，比如误给QUICK_REPLY按钮配置URL参数，或按钮类型填写错误。

修复步骤 #

1. 修正body参数问题 #

如果模板body为固定文本、无需替换参数，直接移除body的parameters数组即可：

{
  'type': 'body'
  // 移除多余的parameters数组
}

若模板body确实需要参数，需前往Meta商务平台检查velvetek_gaming模板的body占位符数量（如{{1}}），确保请求中的参数数量与占位符数量完全一致。

2. 确认按钮配置正确性 #

当前代码中QUICK_REPLY按钮的配置符合规范，需注意：

• QUICK_REPLY按钮仅支持text类型参数，不需要url字段
• 按钮的index需与模板中按钮的顺序对应（第一个按钮index为0）

修复后的完整请求代码 #

const payload = {
  'messaging_product': 'whatsapp',
  'to': phoneNumberString,
  'type': 'template',
  'template': {
    'name': 'velvetek_gaming',
    'language': { 'code': 'en' },
    'components': [
      {
        'type': 'header',
        'parameters': [
          {
            'type': 'image',
            'image': {
              'link': 'https://scontent.whatsapp.net/v/t61.29466-34/425192705_2193394084357501_7755989335530972859_n.png?ccb=1-7&_nc_sid=8b1bef&_nc_ohc=ByZFeTJNrlMQ7kNvgGB_Cp1&_nc_ht=scontent.whatsapp.net&edm=AH51TzQEAAAA&oh=01_Q5AaIKkP-QjlEe9thFos0I2mPJIJyZWJpoPhR23yvSvTleBH&oe=66DC37EF'
            }
          }
        ]
      },
      {
        'type': 'body'
      },
      {
        'type': 'button',
        'sub_type': 'QUICK_REPLY',
        'index': '0',
        'parameters': [
          {
            'type': 'text',
            'text': 'Call Us Now'
          }
        ]
      }
    ]
  }
};

const response = await axios.post(url, payload, { headers });
console.log('Message sent:', response.data);
return response.data;

额外检查项 #

• 确认velvetek_gaming模板已通过Meta审核
• 确保模板语言设置与请求中的language.code一致（均为'en'）
• 若使用URL按钮类型，参数需改用url字段，但当前场景为QUICK_REPLY，无需此配置

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