GoHighLevel发送含URL按钮的WhatsApp模板消息变量配置问题

问题概述 #

使用GoHighLevel作为CRM发送WhatsApp模板消息时，正文/头部变量能正常替换，但带自定义URL按钮的模板始终无法正确配置按钮变量，调用接口https://services.leadconnectorhq.com/conversations/messages时收到WhatsApp返回的错误：

(#131008) Required parameter is missing - buttons: Button at index 0 of type Url requires a parameter

错误原因分析 #

1. JSON语法错误：原始请求载荷中"buttons: []缺少闭合引号，属于无效JSON，会导致请求解析失败。
2. 按钮占位符格式错误：之前尝试的几种写法不符合GoHighLevel对WhatsApp模板按钮参数的封装要求。

正确请求载荷示例 #

{
  "locationId": "[location_id]",
  "contactId": "[contact_id]",
  "type": "WhatsApp",
  "message": "Trying hard",
  "whatsapp": {
    "type": "template",
    "template": {
      "name": "template_3_1",
      "lang": "en"
    },
    "placeholders": {
      "header": [],
      "body": [
        "Aftab"
      ],
      "buttons": [
        "GLNQ56Z4l0"
      ]
    }
  }
}

关键配置说明 #

• 修正JSON语法：确保buttons字段的键名正确闭合引号（"buttons": []）。
• 按钮参数顺序：placeholders.buttons是数组结构，数组元素的索引对应模板中按钮的顺序（第一个元素对应第一个URL按钮，第二个元素对应第二个URL按钮，以此类推），直接传入按钮需要替换的参数值即可。
• 模板前置验证：确认你的WhatsApp模板在创建时，URL按钮已配置可变参数（例如使用{{1}}作为占位符），如果模板本身没有设置可变参数，传入参数会触发错误。

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