WhatsApp模板API调用报错：参数数量与预期不匹配问题排查

可能的原因及解决方法 #

• 模板未完成审核：添加变量后，WhatsApp模板需重新审核。若模板仍在审核流程中，API会默认调用旧的无参数版本，导致传入参数数量不匹配。前往Meta Business Manager查看statement_available_2模板的审核状态，确保已通过审核。
• 模板变量与传入参数数量不符：核对Meta后台创建的statement_available_2模板，确认body部分确实仅包含1个{{1}}变量。避免出现误加多个变量或保存未生效的情况，必要时重新编辑并保存模板。
• 组件结构遗漏错误：检查模板是否包含header、footer等其他带变量的组件。若模板中存在其他需要参数的组件，而当前请求仅传入了body的参数，就会触发报错。确保请求的components数组覆盖所有带变量的组件，且每个组件的参数数量与模板变量数对应。
• 模板名称拼写错误：确认调用的模板名称statement_available_2与创建的带变量模板完全一致，排查是否存在拼写错误或误用旧模板名称的情况。

额外验证步骤 #

可在Meta WhatsApp Business Platform测试工具中，使用相同模板和参数发送测试消息。若测试工具同样报错，问题大概率出在模板配置上；若测试工具发送成功，再检查代码中是否存在变量替换逻辑错误（注：phoneNumber参数不影响本次参数数量报错）。

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