WhatsApp 模板的字符限制
Meta 的模板组件文档对模板的每个部分都设有硬性限制。超出限制的提交会在 API 层直接失败,人工审核员根本看不到,所以最好在撰写时就检查。
字符按您看到的方式计数:一个表情符号或一个阿拉伯字母算一个字符。换行也计入,*粗体* 中的星号等 Markdown 式格式字符同样计入。
来源:Meta,Template components,https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/components(2026 年 10 月核查)。
- 模板名称:最多 512 个字符,仅限小写字母、数字和下划线。
- 文字页眉:最多 60 个字符,且最多 1 个变量。媒体页眉可以是图片、视频或文档;位置页眉仅限实用型和营销类。
- 正文:最多 1,024 个字符,必填,变量数量不限。
- 页脚:最多 60 个字符,不能含变量。
- 按钮:总数最多 10 个,其中快捷回复最多 10 个、网址按钮最多 2 个、电话按钮最多 1 个、复制代码按钮最多 1 个。按钮文字最多 25 个字符,网址最多 2,000 个,电话号码最多 20 个,复制代码最多 20 个。
导致驳回的变量规则
大多数被驳回的模板问题出在占位符,而不是措辞。Meta 的模板审核指南列出了会被驳回的变量问题:参数不连续、含有 #、$ 或 % 等特殊字符、花括号不匹配,或位于消息最开头或最末尾(即“悬空参数”)。
Meta 还会驳回变量相对篇幅过多的模板。Meta 没有公布确切比例,因此当每个变量对应的固定文字少于三个词时,本工具会发出警告。审核员也常常驳回并排放置的两个变量,例如 {{1}} {{2}};请将它们合并,或在中间加入文字。
提交时每个变量都需要一个贴近真实的示例值。审核员通过示例来理解消息的真实内容,因此填写“test”或“xxx”容易被驳回。
来源:Meta,Template review,https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-review。
模板被驳回?解读 Meta 给出的原因
切换到“被驳回?粘贴 Meta 的原因”标签页,粘贴来自 WhatsApp Manager、Business Support Home、驳回通知邮件或 message_template_status_update Webhook 的原因。工具能识别 Meta 的原因代码,例如 INVALID_FORMAT、INCORRECT_CATEGORY、TAG_CONTENT_MISMATCH、PROMOTIONAL、SCAM 和 ABUSIVE_CONTENT,也能识别 Meta 模板审核指南中常见原因的措辞,然后给出可能的原因和修改建议。
被驳回的模板可以修改后重新提交,也可以在补充示例值后到 WhatsApp Manager 提出申诉;Meta 表示申诉会在 24 小时内作出决定。原因为 NONE 表示模板被暂停,而不是被驳回。
实用型、营销与身份验证类别的区别
类别同时决定审核结果和价格。实用型模板用于跟进客户已做过或已提出的事项,例如订单、预订、账户变更或提醒,且必须不含促销内容。身份验证模板承载一次性验证码,使用 Meta 规定的固定措辞。其余的一切,包括购物车提醒、优惠和重新激活,都属于营销类。
Meta 的类别划分指南指出,同时包含实用内容和促销内容的模板属于营销类。折扣码、促销优惠、追加销售、购物车提醒和应用下载提示,都会让模板落入营销类。Meta 会定期复查已批准的模板,把看起来带促销性质的实用型模板划入营销类,通常只提前一天通知。
检查器会用英语、阿拉伯语、法语、西班牙语、德语和葡萄牙语扫描您的措辞中的促销用语,在 Meta 为您重新划分类别之前发出警告。只有身份验证模板可以发送一次性验证码,因此它也会标出其他类别中的验证码措辞。
来源:Meta,Template categorization,https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/template-categorization。
按钮:分组、动态网址以及客户看到的效果
快捷回复按钮和行动号召按钮必须分组:所有快捷回复放在其他按钮之前,或全部放在之后。夹在两个链接之间的快捷回复会被 API 拒绝。
网址按钮可以带一个变量,且必须位于网址末尾,例如 https://shop.example.com/orders/{{1}}。发送的值需要做百分号编码(空格变为 %20)。请避免使用短链接服务:它们会隐藏真实目的地,看起来像垃圾信息。
当模板的按钮超过三个时,WhatsApp 只显示两个,其余收在“查看所有选项”之后。有四个或更多按钮,或快捷回复与其他按钮混用的模板,无法在 WhatsApp 桌面客户端中查看,所以请把最重要的操作放在最前面。
从预览到大规模发送
导出的 JSON 遵循 WhatsApp Business Management API 中 POST /<WABA_ID>/message_templates 的请求体格式,并包含示例值。对于媒体页眉,请使用 Resumable Upload API 上传示例文件,并替换占位的句柄。
模板获批后,按名称和语言发送,并为每个变量填入真实值。OmniChannels.ai 可跨 WhatsApp 商业账号管理模板,跟踪审核状态与质量,并通过统一的 REST API、群发活动或共享收件箱发送已批准的模板,在 WhatsApp 不可用时回退到短信。
