Meta Cloud API(v19.0) 非活跃用户WhatsApp模板请求参数报错求助

错误原因分析 #

你收到的(#100) Invalid parameter错误，核心问题是模板消息的body参数缺少必填的name字段。Meta WhatsApp模板消息API要求，填充模板自定义参数时，必须明确指定每个参数对应的模板参数名称（即你在Meta Business Manager创建模板时定义的参数名）。

你的请求体中，components[0].parameters数组里的每个对象仅包含type和text，缺少name字段，这直接触发了「Parameter name is missing or empty」的错误。

修复后的请求示例 #

根据Meta API规范，补充每个参数的name字段（需与你在Meta后台创建的模板参数名完全一致），修改后的请求体如下：

POST https://graph.facebook.com/v19.0/{{phone_number_id}}/messages

{
    "messaging_product": "whatsapp",
    "recipient_type": "individual",
    "to": "91**********95",
    "type": "template",
    "template": {
        "name": "order_confirmation_no_buttons",
        "language": {
            "code": "en"
        },
        "components": [
            {
                "type": "body",
                "parameters": [
                    {
                        "type": "text",
                        "name": "customer_name", // 替换为模板中定义的用户名参数名
                        "text": "John Doe"
                    },
                    {
                        "type": "text",
                        "name": "order_id", // 替换为模板中定义的订单ID参数名
                        "text": "9999"
                    },
                    {
                        "type": "text",
                        "name": "order_status", // 替换为模板中定义的订单状态参数名
                        "text": "Confirmed"
                    },
                    {
                        "type": "text",
                        "name": "order_amount", // 替换为模板中定义的订单金额参数名
                        "text": "199"
                    }
                ]
            }
        ]
    }
}

额外排查要点 #

• 参数名称一致性：确保name字段的值与Meta Business Manager中模板的参数名完全匹配（区分大小写，比如模板里是customerName就不能写成customer_name）。
• 参数数量匹配：检查请求中参数的数量与模板定义的参数数量完全一致，多传或少传都会触发参数错误。
• 参数格式验证：如果模板参数指定了类型（比如数字、日期），确保text字段的格式符合要求（例如金额传字符串类型而非数字，避免JSON类型解析问题）。

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