WhatsApp API 消息模板：关键术语与机制解析

关键说明：

• 模板是WhatsApp商业API账户资产，企业通过 WhatsApp API发送结构化模板消息。
• 模板消息是唯一可在 客服窗口之外向WhatsApp用户发送的消息类型。
• 模板通常用于批量消息、营销活动消息、提醒通知、OTP验证码以及客服窗口关闭后的跟进消息。

模板创建

打开YCloud控制台 → WhatsApp管理器 → 模板 → 新建模板

• 该 分类 告诉 WhatsApp 模板是营销类、实用类还是认证类。
• 该 组件 定义了模板包含的内容，例如标题、正文、页脚、按钮、变量或媒体。

您每小时可以为每个 WhatsApp 商业账户创建最多 100 个模板。

常见 API 语法

curl 'https://graph.facebook.com/v23.0/<WHATSAPP_BUSINESS_ACCOUNT_ID>/message_templates' \
-H 'Authorization: Bearer <ACCESS_TOKEN>' \
-H 'Content-Type: application/json' \
-d '
{
  "name": "<NAME>",
  "category": "<CATEGORY>",
  "language": "<LANGUAGE>",
  "parameter_format": "<PARAMETER_FORMAT>",
  "components": [<COMPONENTS>]
}'

名称

• order_update 英语
• order_update 印地语
• order_update 西班牙语

模板名称只能包含：

• 小写字母
• 字母数字字符
• 下划线

• order_confirmation
• payment_reminder
• login_otp
• cart_recovery_offer

• Order Confirmation
• Payment-Reminder
• Login OTP!

类别

• 营销
• 实用类
• 认证类

• 营销类 用于促销活动、优惠信息、产品更新、再营销和客户重新互动。
• 实用类 用于非促销性质的更新，例如订单确认、付款提醒、配送通知、账户更新和支持跟进。
• 认证类 用于一次性密码、登录验证码、账户恢复和身份验证。

Read this One-Stop Guide to WhatsApp API Message Template Categories to know about WhatsApp API Message Template in detail.

• 模板审核
• 消息限制
• 定价
• 分类审查
• WhatsApp未来的重新分类

组件

• 头部 ——显示在消息顶部的文本、图片、视频、文档或位置。
• 正文 ——消息的主要文本内容。这是大多数变量和客户特定详细信息使用的地方。
• 页脚 —— 简短的辅助文本，通常用于免责声明或补充说明。
• 按钮 —— 可点击的操作，如访问网站、拨打电话、复制一次性密码(OTP)或快速回复。

语言

• en_US 表示英语
• hi 表示印地语
• es 表示西班牙语
• pt_BR 表示巴西葡萄牙语

• order_update 英语版本
• order_update 印地语版本
• order_update 西班牙语版本

参数格式

• 这里， {{first_name}} 和 {{order_number}} 就是参数。

• 选择参数格式： 命名参数 或 位置参数
• 为每个参数添加示例值
• 后续在发送消息负载中传递真实值

命名参数

• 必须唯一
• 使用小写字母和下划线
• 用双大括号包裹
• 参数值可以任意顺序发送，因为每个参数都有名称

Thank you, {{first_name}}! Your order number is {{order_number}}.

[
  {
    "type": "text",
    "parameter_name": "first_name",
    "text": "Jessica"
  },
  {
    "type": "text",
    "parameter_name": "order_number",
    "text": "SKBUP2-4CPIG9"
  }
]

位置参数

• 必须从 {{1}}
• 必须与模板文本中的顺序一致
• 参数值必须按相同序列发送

Hi {{1}}! Your order number is {{2}}. Thank you.

[
  {
    "type": "text",
    "text": "Jessica"
  },
  {
    "type": "text",
    "text": "SKBUP2-4CPIG9"
  }
]

命名参数 vs 位置参数

媒体

• 产品图片
• 优惠横幅
• 发票 PDF 文件
• 票证或预订文件
• 视频预览

模板审核

在审核过程中，WhatsApp 会检查以下内容：

• 所选类别是否正确
• 消息是否遵循模板指南
• 变量和示例是否清晰
• 内容是否符合业务用例
• 媒体、按钮和组件是否有效

Know How WhatsApp Assigns a Category During Template Creation

模板状态

常见模板状态包括：

• 已批准 ——模板通过审核，可以使用。
• 待审核 ——模板仍在审核中。
• 已拒绝 ——模板未通过审核，无法使用。
• 已暂停 ——模板因质量问题被临时停用。
• 已禁用 ——模板永久不可用。

请求示例

curl 'https://graph.facebook.com/<API_VERSION>/<TEMPLATE_ID>?fields=status' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

响应示例

{
  "status": "APPROVED",
  "id": "1259544702043867"
}

WhatsApp管理器

接下来，我们来看看模板限制以及您的企业可以创建多少个WhatsApp API消息模板。

模板限制

• 消息发送限制 ——控制在客户服务窗口之外可以发送的模板消息数量。
• 模板发送节奏控制 ——减慢发送速度，以便WhatsApp用户可以在模板进一步扩展之前提供反馈。
• 模板暂停 ——暂时停止接收不良反馈或参与度低的模板。
• 模板归档 ——归档并删除已闲置 12个月或更长时间。归档的模板在 28天 后会被删除，除非被恢复。
• 每位用户的营销模板限制 ——限制WhatsApp用户可以从企业接收多少营销模板消息。

生存时间

"message_send_ttl_seconds": 900

"message_send_ttl_seconds": -1

TTL过期会发生什么？

TTL与分类更新

质量评级

请求示例

curl 'https://graph.facebook.com/v25.0/<TEMPLATE_ID>?fields=quality_score' \
-H 'Authorization: Bearer <ACCESS_TOKEN>'

响应示例

{
  "quality_score": {
    "score": "GREEN",
    "date": 1758754645
  },
  "id": "1387372356726668"
}

多条消息的送达顺序

1. 订单已确认
2. 付款已收到
3. 配送已安排

• OTP流程
• 支付旅程
• 订单更新
• 逐步引导
• 多消息营销活动
• 客户支持自动化

模板管理

• 只有 已批准、已拒绝或已暂停 的模板可以编辑。
• 已批准的模板可以编辑 30天内最多10次 或 24小时内一次.
• 无法单独编辑组件。编辑组件时，整套组件将被替换。
• 如果删除已批准的模板，在 30天内无法创建同名模板。
• 连续 12个月或更久 未使用的模板可能被归档，并在 28天后安排删除。

使用YCloud AI更快创建WhatsApp API模板

• 促销活动
• 订单更新
• 付款提醒
• 验证码
• 售后跟进
• 用户召回活动

如何获取YCloud？

如何免费获取YCloud？

总结