求WhatsApp互动模板消息示例代码及Postman调用报错2012解决方案

开发者阿泽

2026-9-28

错误原因

你提交的请求体JSON存在结构错误：components 数组内的同一个对象中重复定义了 type 字段，后续声明的 type: "button" 会覆盖前面的 type: "header"，导致平台无法识别到header配置，误判你没有传入符合要求的视频header参数。

修正后的请求示例

需要将header组件和button组件拆分为两个独立对象放入components数组，参考代码如下：

{
    "to": "91NUMBER",
    "type": "template",
    "template": {
        "namespace": "NAMESPACE_ID",
        "language": {
            "policy": "deterministic",
            "code": "en"
        },
        "name": "TEMPLATE_NAME",
        "components": [
            {
                "type": "header",
                "parameters": [
                    {
                        "type": "video",
                        "video": {
                            "link": "https://res.cloudinary.com/MY_VIDEO_LINK"
                        }
                    }
                ]
            },
            {
                "type": "button",
                "sub_type": "url",
                "index": "0",
                "parameters": [
                    {
                        "type": "text",
                        "text": "9rwnB8RbYmPF5t2Mn09x4h"
                    }
                ]
            }
        ]
    }
}