WhatsApp Business API媒体模板发送报错（#132012）求助

问题原因分析 #

出现(#132012) Parameter format does not match format in the created template错误，是因为你的发送请求存在3个关键格式问题：

• 头部类型大小写不匹配：模板中头部组件的type是大写HEADER，但发送请求中写成了小写header，严格来说必须和模板定义一致。
• 参数结构错误：parameters字段需要是包含单个参数对象的数组，你直接将参数对象赋值给了parameters，不符合API要求。
• 图片链接无效：你使用的是Imgur相册链接，不是直接的图片文件URL，WhatsApp要求必须指向可直接下载的图片文件（后缀为.jpg/.png等）。

修复后的请求代码 #

以下是修正后的发送请求参数：

$message = [
    "messaging_product" => "whatsapp",
    "to" => "8801704158504",
    "type" => "template",
    "template" => [
        "name" => $template->name,
        "language" => [
            "code" => $template->language
        ],
        "components" => [
            [
                "type" => "HEADER", // 与模板定义的大写保持一致
                "parameters" => [
                    [ // 参数必须用数组包裹
                        'type' => 'image',
                        'image' => [
                            'link' => 'https://example.com/your-valid-image-file.jpg' // 替换为直接的图片文件URL
                        ]
                    ]
                ]
            ]
        ]
    ]
];

额外注意事项 #

1. 图片链接必须是公开可访问的，且文件大小不超过5MB，格式为JPG或PNG。
2. 确保language.code与模板的language完全一致（比如模板是en_US，不能简写为en）。
3. 模板头部格式为IMAGE，发送时参数类型必须严格指定为image，不能混用其他媒体类型。

内容的提问来源于stack exchange，提问作者Md Sehirul Islam Rehi