发送带变量的消息模板
消息模板变量按位置传递,而不是按名称传递。您需要按顺序为每个组件发送参数列表,数量必须与模板定义完全一致。这样做错会产生 3 种不同错误,每种错误都对应不同问题。
参数如何匹配
按位置匹配,而不是按名称匹配。正文列表中的第 1 个参数会填入第 1 个占位符,第 2 个参数会填入第 2 个占位符,依此类推。您无法为变量命名;如果交换两个参数,消息仍会成功发送,但值会出现在错误位置。
最后一种情况最危险,因为不会发生失败。客户收到订单确认时,日期可能出现在金额的位置,而且任何地方都不会记录错误。
组件使用不同列表
标题变量和正文变量不共用同一个列表。每个组件都有自己的参数;把它们合并会导致数量不匹配。
- 标题参数放在标题组件中,最多只能有 1 个。
- 正文参数放在正文组件中,并按顺序排列。
- 按钮 URL 参数放在按钮组件中,并按按钮建立索引。
- 为所有组件发送一个扁平列表会返回错误 132000。
正确设置语言
模板由名称和语言共同标识,因此同名但语言不同的是两个模板。模板创建时使用的是 en_US,您发送 en 不会自动回退,而会因错误 132001 失败;该错误显示为模板不存在。
请列出该号码上的模板,并复制准确的语言字符串,不要自行假定其格式。这是最常见、也最不明确的模板错误。
类型化参数
大多数参数都是普通文本,但有些不是。将这些参数作为文本发送会失败,并返回错误 132012。
- 货币参数包含金额、货币代码和备用字符串。
- 日期和时间参数包含带备用值的结构化对象。
- 媒体标题参数包含媒体 ID 或链接,而不是文件名。
- 如果收件人的应用无法格式化该值,显示的就是备用字符串。
各错误分别代表什么
这 3 种失败可以区分。如果分别记录,而不是统称为模板错误,就能减少大量猜测。
错误 132001 表示名称和语言组合无法解析,请先检查语言。错误 132000 表示数量错误,请与模板自身的定义进行比较。错误 132012 表示值的格式错误,通常是把类型化参数作为普通字符串发送。
常见错误
- 以为 en 会回退到 en_US。事实并非如此,该错误会显示为模板不存在。
- 把标题和正文参数合并到一个列表中。它们属于不同组件。
- 把货币或日期作为普通文本发送。类型化参数有明确格式。
EasyCoexistence 会通过控制台和 MCP 连接器列出模板的准确名称及语言代码,因此发送时使用的是 Meta 实际存储的值。
常见问题
消息模板变量有名称吗?
没有。它们按位置传递,因此参数顺序就是完整约定。
为什么我的模板不存在?
通常是语言代码的问题。模板由名称和语言共同标识,并且不会自动回退。
如果我发送了过多参数,会怎样?
错误 132000。参数过多和参数过少会以相同方式失败。
如何发送金额?
使用包含金额、货币代码和备用字符串的货币参数,而不是普通文本。
继续阅读
准备开始了吗?
几分钟即可设置 WhatsApp Coexistence,而不是几个月。应用会继续在手机上运行。
开始免费试用验证时间