WhatsApp模板参数数量无效错误：请求配置问题排查

核心错误点 #

• 参数绑定的组件类型错误：你的模板内容lorem ipsum {{1}}, dolor sit amet {{2}}是属于**消息正文（body）**的参数，但你在请求里把参数放到了header类型的组件中，WhatsApp无法匹配模板里的参数位置，导致判定参数数量异常。
• 多余的组件定义：你的模板没有header部分，不需要声明header类型的components，应该用body类型组件来传递正文参数。

修正后的请求代码 #

data = {
    'messaging_product': 'whatsapp',
    'recipient_type': 'individual',
    'to': f'{mobile}',
    'type': 'template',
    'template': {
        'name': 'inform',
        'language': {
            'code': 'pt_PT',
        },
    },
    'components' : [{
        'type': 'body',  # 改成body，匹配模板的正文参数位置
        'parameters': [{
            'type': 'text',
            'text': name,  # 对应模板里的{{1}}
        },
        {
            'type': 'text',
            'text': msg,   # 对应模板里的{{2}}
        }]
     }]
}

额外注意事项 #

• 确保参数的顺序和模板里{{1}}、{{2}}的顺序完全一致，顺序错误也会触发参数相关报错。
• 如果你的模板确实包含header部分（比如带图片/文本header），需要分别定义header和body组件，各自传递对应位置的参数。

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