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!

分类

• 营销类
• 实用
• 身份验证

• 营销 用于促销、优惠、产品更新、重新定位和客户重新参与。
• 实用 用于非促销更新，如订单确认、付款提醒、配送提醒、账户更新和支持跟进。
• 身份验证 用于一次性密码（OTP）、登录代码、账户恢复和身份验证。

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

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

组件

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

语言

• 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"
  }
]

命名参数与位置参数

媒体

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

模板审核

• 所选类别是否正确
• 消息是否符合模板规范
• 变量和示例是否清晰
• 内容是否匹配业务场景
• 媒体、按钮和组件是否有效

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 Manager

接下来，我们来看看模板限制以及您的企业可以创建多少个 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小时内编辑1次.
• 您无法编辑单个组件。如果您编辑组件，整个组件集将被替换。
• 如果您删除了一个已批准的模板，您将无法在 30天内创建同名模板。
• 模板停用超过 12个月或更长时间 可能会被归档，并在 28天后安排删除。

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

• 促销
• 订单更新
• 付款提醒
• OTP
• 支持跟进
• 再营销活动

如何获取YCloud？

如何免费获取YCloud？

总结！