# WhatsApp 模板指南

您编写的模板必须通过 Bird 的提交检查和 Meta 的审核才能使用。本页说明 Bird 检查的内容限制、如何提供变量以及如何应对审核决定。通过本地验证不代表 Meta 会批准模板，也不保证后续投递成功。

Bird 还提供托管目录模板。阅读 [WhatsApp 模板](/docs/guides/whatsapp/templates) 以查看可用语言和当前可发送状态，阅读[编写模板](/docs/guides/whatsapp/authoring-templates)以在您自己的账户上创建模板。

## 各组件的字符限制

提交编写的内容时，Bird 会检查以下限制：

| 组件           | 限制         | 备注                               |
| -------------- | ------------ | ---------------------------------- |
| 文本标题       | 60 个字符    | 每个模板一个标题，最多支持一个变量 |
| 正文           | 1,024 个字符 | 支持多个变量                       |
| 页脚           | 60 个字符    | 不支持变量                         |
| 按钮标签       | 25 个字符    | 适用于电话、URL 和快捷回复按钮     |
| URL 按钮目标   | 2,000 个字符 | 支持一个变量，追加在 URL 末尾      |
| 复制代码按钮值 | 20 个字符    | 复制到设备剪贴板的字符串           |

轮播卡片正文有单独的 160 个字符限制。类别和组件规则同样适用：身份验证模板使用 Meta 生成的措辞，而 GIF 标题、轮播和优惠券复制代码按钮属于 Bird 编写流程中的营销模板。请检查验证响应中受影响的语言和字段。

## 变量

变量是模板中在发送时填充的部分。根据您正在编写的组件匹配格式：

- Bird 使用位置参数创建身份验证模板，写作 `{{1}}` 和 `{{2}}`。其措辞来自 Meta 的身份验证格式。实用和营销模板的顶层文本使用命名参数，例如 `{{order_number}}`。
- 位置占位符是从 `{{1}}` 开始递增的索引编号，示例值和发送值均按占位符出现的顺序读取。正文从 `{{2}}` 跳到 `{{5}}` 会被拒绝。
- 命名占位符使用小写字母、数字和下划线，例如 `{{order_number}}`，同一语言中名称不能重复。其值按名称匹配而非按位置匹配，因此提供值的顺序无关紧要。
- 每个占位符都要用双花括号包裹。轮播卡片文本使用位置参数和位置示例值。变量 URL 按钮使用一个末尾位置占位符，例如 `https://example.com/orders/{{1}}`，即使模板正文使用的是命名参数。
- 不要在占位符内使用 `#`、`$` 和 `%` 等特殊字符。
- 模板不能以变量开头或结尾。Meta 会拒绝悬空参数，因为以替换文本开头或结尾的消息无法为读者提供上下文。
- 每个占位符周围要有固定文本来说明替换值的含义。Meta 会拒绝占位符过多而上下文过少的模板，因为大部分都是变量的正文看起来像空白表格而非消息。增加措辞，或减少变量数量。
- 提交模板时附带示例值。审核基于渲染后的预览进行，没有示例值的提交无法被评估。

## 格式

WhatsApp 在正文中支持少量内联格式：粗体、斜体、删除线和等宽字体。正文和按钮中允许使用 Emoji，标题文本则完全不支持格式标记。

Meta 不接受 HTML、不接受以锚文本样式呈现的链接，也不支持除您手动输入的换行符之外的行长控制。正文中的 URL 会以原始链接形式渲染，这正是 URL 按钮存在的意义。

## 审核与批准

提交新语言或编辑会启动相应的审核流程。请在 Bird 和 WhatsApp Manager 中查看当前状态，而不是按照预期的审核时间安排上线。发送前，请确认所需语言可用、发送号码属于正确的账户，且接收者符合条件。

批准和质量是分开的。Meta 根据使用情况和接收者反馈更新模板质量。中等或低评级需要排查问题；被暂停或禁用的语言无法用于发送。关注当前状态和 Meta 显示的操作建议，不要假设评级变化会自动恢复模板。

Bird 会显示模板的状态和每种语言的审核结论。[WhatsApp 模板](/docs/guides/whatsapp/templates)定义了每个值及其对发送的含义。

## 模板被拒绝的原因

查看针对受影响语言返回的原因。需要检查的问题包括：

- **变量格式。** 花括号不匹配、占位符编号不连续、变量出现在开头或结尾，或变量多于固定文本。
- **重复。** 如果模板的正文和页脚与您账户上已注册的措辞一致，会作为重复被拒绝。Meta 会在拒绝信息中指出已有模板的名称，您可以改用该模板发送。身份验证模板不受此检查限制。
- **政策。** 违反 WhatsApp Business Messaging Policy 的内容，或对于交易类内容，违反 Commerce Policy 的内容。禁售商品是最典型的情况，但接收者无法辨认为来自您的消息同样会被拒绝。
- **类别错误。** 最常见的是将营销消息作为实用类提交。类别决定了 Meta 允许的内容和消息费用，因此 Meta 会予以纠正而非放行。

在 WhatsApp Manager 或 Business Support Home 中以及 Meta 提供的通知中查看审核决定。修复报告的问题后重新提交。如果决定提供了申诉选项且您不同意，请提供所需的上下文和示例值。跟踪审核状态；批准和完成时间无法保证。

## 后续步骤

- [WhatsApp 模板](/docs/guides/whatsapp/templates)：Bird 中的目录、状态和变量
- [发送 WhatsApp 消息](/docs/guides/whatsapp/sending-whatsapp)：在发送时填充模板的变量
- [WhatsApp 客服窗口](/docs/knowledge-base/whatsapp/customer-service-window)：何时需要使用模板联系对方

## Related resources

- [Building and submitting a WhatsApp template](/learn/whatsapp/building-and-submitting-a-whatsapp-template) (video)
- [What is a WhatsApp message template?](/explained/whatsapp/what-is-a-whatsapp-message-template) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp templates](/products/whatsapp/templates) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp-templates)