模板

了解模板、模版的用途和限制，以及您可以创建的各种类型的模板。

模板是 WhatsApp Business 业务账户资产，可通过云端 API 或 Lite 版营销消息 API 以模板消息的形式发送。模板消息是唯一一种可在客户服务窗口之外向 WhatsApp 用户发送的消息类型，因此模板通常用于以下场景：一是向用户群发消息时，二是当您需要向某一用户发送消息，但您与该用户之间暂无打开的客服窗口时。

创建

WhatsApp 管理工具中的消息模板面板来创建模板。或innopaas平台中的Templates创建模板

使用常用语法通过 API 创建模板。大部分差异均体现在类别字符串（用于为模板分配类别）和组件数组（用于定义构成模板的各个组件）中。详细请参阅WhatsApp接口文档。

注意：在 WhatsApp Business 业务账户中，每小时最多可创建 100 个模板。

名称

每个模板必须有一个名称，但名称无需唯一。这种灵活性允许您创建多个具有相同名称但使用不同语言的模板。

模板名称的长度上限为 512 个字符，由小写字母、数字和下划线组成。

类别

每个模板均须归类为​身份验证​、营销或​实用型消息​。我们的模板分类文档说明了如何为模板分配适当的类别，以及如果我们认为模板分类错误会发生什么情况。

请注意，模板类别也会对定价产生影响。

组件

模板由各类文本、媒体和互动式 UI 组件构成，这些组件需在创建模板时进行定义。

语言

创建模板时，您必须为其分配一个模板语言代码。Meta 不会对模板字符串和变量进行翻译，因此，您需自行负责提供对应语言版本的字符串内容及示例参数。

如果您创建多个名称相同但语言不同的模板，每个模板都会计入您的模板数量限制。

参数格式

有些模板组件允许您定义包含一个或多个参数的字符串（在 WhatsApp 管理工具中称为“变量”）。这些字符串会在您发送模板时，被替换为您在发送消息纳入的值。具体参考WhatsApp接口文档。

媒体素材

模板标题组件可以显示媒体素材。如果您正在创建带有媒体标题的模板，获取素材句柄，并在模板创建请求中包含该素材的句柄。示例素材将作为模板审核的一部分接受审核。

模板审核

模板在创建或编辑后会自动审核。如果您的模板通过审核，其状态将被设置为 APPROVED，您可以开始在模板消息中发送它。如果模板被驳回，或其状态变为任何其他值，则将不能在模板消息中发送它。

如需详细了解模板审核流程、常见驳回原因，以及模板被驳回后可采取的应对措施，请参阅我们的模板审核文档。

模板状态

模板必须为 APPROVED 状态，才能作为模板消息发送。模板的状态最初由模板审核流程设置，但可以根据使用情况和质量反馈更改为其他值。

模板状态更改通过 Webhook 传达，但您可以随时使用模板列表接口请求 来获取模板状态auditStatus 字段。

WhatsApp 管理工具

WhatsApp 管理工具中的管理模板面板也会显示模板状态，并附加对获批 (active) 模板的质量评分：

• ​审核中​：表示模板仍在审核中。审核最多需要 24 小时。
• ​未通过​：模板在审核过程中未通过审核，或违反我们的一项或多项政策。
• ​使用中 - 质量待审核​：尚未收到客户对消息模板的质量反馈或读取率信息。您可以将此状态的消息模板发送给客户。
• ​使用中 - 高质量​：几乎未收到或未收到客户对模板的负面反馈。您可以将此状态的消息模板发送给客户。
• ​使用中 - 中等质量​：已收到多位客户对模板的负面反馈或低读取率信息，模板状态可能会很快变为已暂停使用或已禁用。您可以将此状态的消息模板发送给客户。
• ​使用中 - 中等质量​：已收到多位客户对模板的负面反馈或低读取率信息。您可以将此状态的消息模板发送给客户，但此模板面临很快被暂停或禁用的风险，因此建议您尽快解决客户举报的问题。
• ​已暂停使用​：模板因收到客户的持续负面反馈或低读取率已被暂停使用。您不能将此状态的消息模板发送给客户。请参阅模板暂停使用。
• ​已禁用​：模板因收到客户的持续负面反馈已被禁用。您不能将此状态的消息模板发送给客户。
• ​已提出申诉​：表示已提出申诉。

模板限制

WhatsApp Business 业务账户可以拥有的模板数量由该账户的父级业务资产组合决定。

如果父级业务资产组合未经认证，则其下每个 WhatsApp Business 业务账户最多可拥有 250 个消息模板。但是，如果资产组合已经过认证，且至少有一个 WhatsApp Business 业务账户具有业务电话号码和经批准的商家显示名，则每个 WhatsApp Business 业务账户最多可拥有 6,000 个模板。

此外，您可以发送的模板数量也存在限制，同时部分流程也可能影响模板的送达：

• 消息限额 — 可以在客户服务时间窗之外发送的消息模板数量限制。
• 模板调控 — 为 WhatsApp 用户留出时间对消息模板提供反馈的流程。
• 模板暂停使用 — 对收到负面反馈的消息模板实施临时暂停使用的流程。
• 每位用户的营销模板消息限额 — 对特定 WhatsApp 用户可从任意商家处接收的营销模板消息数量进行限制的流程。

送达期限

如果发送给 WhatsApp 用户的消息无法送达，系统会在一段时间内继续尝试送达，这段时间称为“送达期限”(TTL)。您可以在创建模板时自定义模板的送达期限。

生存时间

如果我们无法将消息送达给WhatsApp用户，我们将在被称为“活出时间”（“TTL”）或消息有效期内重新尝试该传递。

你可以自定义通过云API发送的认证和实用模板的默认TTL，以及通过Marketing Messages Lite API（“MM Lite API”）发送的营销模板。

我们建议您为所有认证模板设置TTL，最好是等于或少于验证码的过期时间，以确保客户只有在验证码仍可用时才收到消息。

默认值、最小值/最大值及兼容性表

当TTL超过时：丢弃消息 无法在默认或自定义TTL内投递的消息会被丢弃。

如果你在TTL超过前没有收到已送达的消息webhook，就当消息被丢弃了。

如果你发送的消息未能送达，收到 webhook 之前可能会有小延迟，所以你可能需要先设置一个小缓冲区，再假设消息被丢弃。

质量评分

模板质量评分是一套用于评估消息模板质量的系统，其评估依据包括模板的使用情况、客户反馈及互动数据。此评分有助于维护高质量的消息生态系统，并助力确保您发送的消息具有相关性且能获得良好的用户接受度。

请参阅我们的模板质量评分文档，详细了解质量评分、其如何影响模板的状态，以及如何收到模板质量评分变化的通知。

多条消息的送达顺序

发送一系列消息时，无法保证消息的接收顺序与您的 API 请求顺序一致。如需保证消息接收顺序，请在发送您消息顺序中的下一条消息之前，确认已通过状态消息 Webhook 接收到 delivered 状态。