WhatsApp 消息有效期:让验证码、提醒和物流通知不再迟到
客户的手机关机了几个小时,开机后 WhatsApp 才把早已过期的验证码送到,或者把一条“快递员 20 分钟后到达”送到一个中午就已签收的包裹上。消息有效期决定 WhatsApp 什么时候放弃重试。本文介绍各类模板的默认值、不同消息适合设多少,以及如何在 MonoChat 中设置。
MonoChat 团队 更新于: 2 分钟阅读
一位客户在登机口申请登录验证码,随后手机切换到飞行模式。四个小时后落地开机,WhatsApp 才把那条 10 分钟就失效的验证码送到。另一位客户在晚上收到“快递员 20 分钟后到达”,而包裹中午就已经放在了邻居家。一家诊所的“您的预约 1 小时后开始”,到第二天早上才出现在患者手机上。
这些消息发出时都没有错,错的是它们到达的时间。WhatsApp 会不断尝试把消息送到关机或离线的手机上,对大多数模板,这个重试期最长可达 30 天。消息有效期(TTL)就是告诉 WhatsApp 何时停止重试的设置。
自 3.8.46 版本起,MonoChat 的模板创建工具除营销模板外,也可以为实用工具和身份验证模板设置它。对做出海业务的团队来说,客户分布在不同时区,消息发出时对方的手机未必在线,这个设置尤其有用。
本文介绍消息有效期的运作方式、各类别的默认值和范围、不同消息适合设多少,以及设置步骤。
WhatsApp 如何重试一条消息
发送模板消息时,WhatsApp 会先尝试把它送到客户的手机。如果手机关机、没有网络,或者已经离线一段时间,消息会留在 WhatsApp 一侧等待并重试。Meta 把这段重试时长称为消息的有效期。
有效期耗尽时会发生两件事:
- 消息被丢弃。 Meta 的文档说明,系统会丢弃无法在默认或自定义有效期内送达的消息,客户永远看不到它。
- 您收不到“已送达”状态。 Meta 的建议很简单:如果在有效期结束前没有收到已送达的 webhook,就当作消息已被丢弃。
默认的重试期很长,是因为多数消息过几天仍然有用:收据、对账单、资讯。本文关注的则是那些过时就没用的消息。
各类别的默认值和范围
Meta 按模板设置消息有效期,允许的范围取决于模板的类别:
| 类别 | 默认值 | 可设置的范围 | 在 MonoChat 中(秒) |
|---|---|---|---|
| 身份验证 | 10 分钟(2024 年 10 月 23 日前创建的模板为 30 天) | 30 秒到 15 分钟 | 30 到 900 |
| 实用工具 | 30 天 | 30 秒到 12 小时 | 30 到 43200 |
| 营销 | 30 天 | 12 小时到 30 天 | 43200 到 2592000,需账号已接入营销消息 API(Marketing Messages API) |
有三个细节容易被忽略:
- 老的身份验证模板仍是 30 天。 如果您的验证码模板创建于 2024 年 10 月 23 日之前,并且从没设置过有效期,验证码仍可能迟到好几周。为它设置一个值就能解决。
- 实用工具类别没有短的默认窗口。 没设置有效期的物流通知会重试 30 天,和一封资讯邮件一样久。
- 类别变更会清空该值。 Meta 把模板转到另一个类别时,会清空有效期,模板回到新类别的默认值,直到您在该类别的范围内重新设置。
哪种消息设多少
把有效期设在消息不再成立或不再有用的那一刻,而不是您希望客户读到它的那一刻。下面是一些起步参考:
| 消息 | 类别 | 建议有效期 | 原因 |
|---|---|---|---|
| 有效期 10 分钟的登录或验证码 | 身份验证 | 600 秒或更短 | Meta 建议消息有效期等于或短于验证码的有效期 |
| 有效期 5 分钟的支付确认码 | 身份验证 | 300 秒 | 验证码在失效后才到,只会多出一个客服工单 |
| “您的快递约 30 分钟后送达” | 实用工具 | 1800 秒 | 过了这段时间,快递员要么已经到了,要么已经走了 |
| “您的餐位已就绪”或“您的订单可以自提了” | 实用工具 | 1800 到 3600 秒 | 客户在附近时才有用 |
| 预约前 3 小时发送的提醒 | 实用工具 | 10800 秒 | 预约时间一过就丢弃,避免发出让人困惑的消息 |
| 当日送达时段确认 | 实用工具 | 21600 到 43200 秒 | 到了晚上这个时段就已经过去了 |
| 订单确认、收据、发票 | 实用工具 | 留空 | 过几天仍然有用 |
| 48 小时限时抢购 | 营销 | 172800 秒 | 活动结束,优惠也就结束了 |
两条经验法则:
- 晚到也无妨的消息,就留空。 明天才到的收据,也好过收不到。对必须送达的消息,不要设置很短的有效期。
- 晚到比不到更糟的消息,先想好备用方案。 验证码被丢弃后,应该能在您的应用里点“重新发送验证码”;“快递员就在附近”被丢弃后,可以由快递员直接打电话。缩短有效期之前,先把这件事定下来。
如何在 MonoChat 中设置
您需要先将一个 WhatsApp 号码以 WhatsApp Business (Cloud) 渠道接入。
1. 打开模板。 进入 设置 › 聊天 › 渠道,打开该渠道的 ⋮ 菜单,选择 模板消息。
2. 创建模板。 点击 创建,选择类别:更新类通知选 实用工具,验证码选 身份验证。验证码选择 一次性密码 类型;更新类通知选择 标准,或者选择 来自 Meta 模板库,从 Meta 现成的实用工具模板开始(见我们的模板库指南)。
3. 填写消息有效期。 在名称和语言下方填写 消息有效期(秒)。您输入的数字超出范围时,MonoChat 会即时提示:实用工具显示“请输入 30 到 43200 秒之间的值”,身份验证显示“请输入 30 到 900 秒之间的值”。留空则沿用 WhatsApp 的默认值。
4. 验证码要与有效期一致。 在一次性密码模板中,验证码有效期(分钟,1–90) 可填 1 到 90 分钟。把消息有效期设成与它相同或更短。验证码有效期 10 分钟、消息有效期 600 秒,就不会出现验证码在失效后才到的情况。
5. 提交。 照常完成消息、按钮和示例(我们的如何创建 WhatsApp 模板消息逐项介绍了每个字段),然后提交。消息有效期随模板一起走:无论是从聊天、流程、群发还是您自己的系统发出,用这个模板发送的每条消息都使用同一个值。
营销模板 只有在您的 WhatsApp Business 账号已接入 Meta 的营销消息 API(Marketing Messages API)时才会显示这个字段,MonoChat 会自动检测。此时的范围是 43200 到 2592000 秒。
示例:深圳一家独立站卖家的当日消息
一家在深圳、通过 Shopify 独立站向东南亚和中东客户发货的家居小店,在 MonoChat 中用流程发送三类 WhatsApp 消息,流程由店铺的订单 webhook 触发:
- 订单确认(实用工具,不设有效期)。客户第二天才看到也有用。
- 派送前 3 小时的提醒(实用工具,10800 秒)。如果客户的手机整个上午都关机,提醒会在派送时间过后被丢弃,而不是在包裹送到后才姗姗来迟。
- “快递员正在派送,预计晚 20 分钟”(实用工具,1200 秒)。它只在接下来的二十分钟内是真的。
流程用 发送模板消息 节点发送每一条。当客户回复“能不能改到明天下午?”时,这条回复会开启 24 小时客户服务窗口,并进入共享收件箱,由客服用自由文本回复。
如果店里不在意时效,订单确认本可以和提醒共用一个模板。但消息有效期是按模板设置的,所以生命周期不同的消息需要各自的模板。
费用
Meta 按每条送达的消息,以模板类别和收件人所在国家/地区对应的费率收费。其定价页面说明,企业只在消息送达时才被收费,因此在有效期结束时被丢弃的消息不收费。缩短有效期绝不会多花钱,最多只是省下一条迟到后已经没用的消息的费用。Meta 直接向您的企业结算,MonoChat 是 Meta 官方商业合作伙伴(official Meta Business Partner),不加价。用群发消息费用计算器估算一次活动的费用。
清单
- 列出所有过一段时间就不再成立的模板:验证码、“正在派送”、“已就绪”、当日提醒、限时抢购
- 身份验证模板:消息有效期等于或短于 验证码有效期
- 2024 年 10 月 23 日前创建的身份验证模板:设置一个值,否则仍是 30 天
- 与时间相关的实用工具通知:有效期在通知失效时结束
- 收据、确认和发票:留空
- 生命周期不同的消息使用各自的模板
- 为被丢弃的消息准备备用方案:在应用里重发、打电话、客户来信时再发新消息
- Meta 调整模板类别之后:重新设置消息有效期
来源
- Meta for Developers: Configure message time-to-live(重试、各类别的默认值和范围、被丢弃的消息、已送达 webhook、身份验证建议、类别变更;2026 年 11 月 6 日查阅)
- Meta for Developers: Pricing on the WhatsApp Business Platform(“Businesses are only charged when a message is delivered”;2026 年 11 月 6 日查阅)
- MonoChat 帮助中心:模板消息(消息有效期字段和范围、一次性密码的验证码有效期、营销消息 API;2026 年 11 月 6 日查阅)
- MonoChat 更新日志 3.8.46(实用工具和身份验证模板的消息有效期;2026 年 11 月 6 日查阅)
用 MonoChat 付诸实践