> ## Documentation Index
> Fetch the complete documentation index at: https://docs.ycloud.com/llms.txt
> Use this file to discover all available pages before exploring further.

# 模板概览

> 了解何时使用 WhatsApp 模板、选择类别，并做好审核和发送准备。

消息模板是与 WhatsApp 商业账户 (WABA) 关联的可重用消息结构。在用于发送模板消息之前，您需要将其提交给 Meta 进行审核。

当您需要在客户服务窗口之外向客户发送消息时，请使用模板。您也可以在窗口开启期间使用模板。有关窗口规则，请参阅[服务消息](/zh/documentation/whatsapp-business-platform/messaging/service-messages#customer-service-window)。

<Info>
  模板获得批准并不代表您已获得联系客户的许可。发送前请检查客户的同意情况和退订偏好。
</Info>

## 选择模板类别

请根据消息的目的选择类别，而不是根据您希望支付的价格来选择。

| 类别 | 目的 | 示例场景 |
| - | - | - |
| [营销 (Marketing)](/zh/documentation/whatsapp-business-platform/messaging/message-templates/marketing-templates) | 推广、推荐、重新吸引客户或促成购买等操作。 | 向订阅了营销动态的客户分享优惠信息。 |
| [效用 (Utility)](/zh/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates) | 发送与客户请求、交易、账户或其他符合条件的重要目的相关的非推广性更新。 | 确认具体的预约或更新现有订单。 |
| [身份验证 (Authentication)](/zh/documentation/whatsapp-business-platform/messaging/message-templates/authentication-message-templates/index) | 使用一次性密码对用户进行身份验证。 | 验证登录或账户找回请求。 |

将交易更新与优惠信息结合的消息不属于纯效用类消息。Meta 会将混合了效用与推广内容的消息视为营销类消息。

有关类别标准和示例，请参阅 Meta 的[模板分类指南](https://developers.facebook.com/docs/whatsapp/updates-to-pricing/new-template-guidelines/)。

<Tabs>
  <Tab title="营销">
    <Frame caption="A promotional offer illustrates marketing content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-marketing-template-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=26b207935b6d6d53953bd583297490da" alt="带有折扣优惠和标注组件的 Meta 营销示例。" style={{ width: "100%", height: "auto", margin: 0 }} width="2321" height="1416" data-path="product-assets/whatsapp-platform-2026-09-22/meta-marketing-template-components.png" />
      </div>
    </Frame>

    来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/marketing-templates/custom-marketing-templates/)。
  </Tab>

  <Tab title="效用">
    <Frame caption="A reservation-specific update illustrates utility content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-utility-reservation-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=b58bfde95caac7202b309e340d1b5514" alt="带有标注组件的 Meta 预订确认示例。" style={{ width: "100%", height: "auto", margin: 0 }} width="590" height="452" data-path="product-assets/whatsapp-platform-2026-09-22/meta-utility-reservation-components.png" />
      </div>
    </Frame>

    来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/utility-templates/utility-templates)。
  </Tab>

  <Tab title="身份验证">
    <Frame caption="An OTP verifies a requested action; it is separate from marketing and utility content.">
      <div style={{ position: "relative", width: "100%", maxWidth: "590px", margin: "0 auto" }}>
        <img src="https://mintcdn.com/lchnan/Q9LYCM-XEE-Z8muf/product-assets/whatsapp-platform-2026-09-22/meta-authentication-components.png?fit=max&auto=format&n=Q9LYCM-XEE-Z8muf&q=85&s=d91f4d4ad03a1f5d54dded42d229a00c" alt="标注了验证码和安全文本的 Meta 身份验证示例。" style={{ width: "100%", height: "auto", margin: 0 }} width="2224" height="2211" data-path="product-assets/whatsapp-platform-2026-09-22/meta-authentication-components.png" />
      </div>
    </Frame>

    来源：[Meta 官方示例](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates/)。
  </Tab>
</Tabs>

## 理解模板与消息的区别

模板定义了经过审核的结构。您发送的消息则是为特定接收者填入所需的值。

例如，一个虚构的订单更新模板可能包含：

```text theme={"theme":{"light":"github-light","dark":"github-dark"}}
Your order {{1}} has shipped. Track its progress using the button below.
```

发送时，您需要提供订单编号及任何其他所需内容。请保持变量值与模板已批准的目的相符。切勿使用变量插入不相关的促销内容。

该示例仅作说明之用，并非预先批准的模板。

## 组件与格式

根据所选的类别和格式，模板可以包含：

* 页眉。
* 正文。
* 页脚。
* 按钮。
* 变量和示例值。

类别描述目的，格式描述呈现方式。轮播或媒体页眉属于格式选择，而非第四种模板类别。

并非每个类别或工作流都支持所有组件或格式。在设计消息之前，请查看 [YCloud 模板创建指南](/zh/documentation/channels/whatsapp-accounts-management/template-management/create-template/index) 支持的选项。

有关格式对比和详细指南，请参阅[模板组件与格式](/zh/documentation/whatsapp-business-platform/messaging/message-templates/template-components-and-formats)。

## 在 YCloud 中创建第一个可用模板

1. 打开 **模板**。如果您管理多个 WABA，请先切换到目标 WABA；在其他 WABA 中批准的模板不会自动提供给当前发送方使用。
2. 使用编辑器支持的小写字母、数字和下划线输入一个固定名称。选择一个能描述事件的名称，例如 `booking_confirmation`。
3. 根据实际用例选择 **Marketing**、 **Utility** 或 **Authentication** 。
4. 选择确切的语言变体。一个模板可以包含多个语言版本，但每个版本都需要正确的内容和审核结果。
5. 配置支持的页眉、正文、页脚和按钮。根据要求提供变量示例值和示例媒体。
6. 查看客户预览、提交并确认。在将模板接入生产环境发送前，请等待审核结果。

<Frame caption="Provide sample values for variables and check the customer preview before submitting.">
  <img src="https://mintcdn.com/lchnan/TsMGu8UTNQaUw-Rc/product-assets/english-help-demo-2026-09-23/template-editor-variables.png?fit=max&auto=format&n=TsMGu8UTNQaUw-Rc&q=85&s=fb0de20598b9ed27fb119450092cc245" alt="带有正文变量、示例 Alex 以及客户预览的英文营销模板编辑器。" width="3024" height="1656" data-path="product-assets/english-help-demo-2026-09-23/template-editor-variables.png" />
</Frame>

[完整控制台指南](/zh/documentation/channels/whatsapp-accounts-management/template-management/create-template/index)中包含了详细的界面操作流程。关键决策和要求已在此处介绍；您无需使用 Meta 的开发者工具来完成此控制台工作流。

### 语言与重用：常见误区

* **一种已批准的语言并不代表适用于所有语言。** 发送 `en_US` 不等同于发送 `en`。请选择确切批准的变体。
* **模板语言不会翻译变量值。** 您的系统必须提供面向客户的正确日期、标签和值。
* **批准属于其所在 WABA 中的模板资源。** 另一个 WABA 中名称相似的模板属于不同的资源。
* **模板不是收件人列表。** 创建模板不会发送该模板，也不会订阅任何人。
* **已获批的正文并不代表完整的消息。** 缺少变量、媒体文件错误或按钮参数错误仍然会导致发送失败。

进行首次测试时，请使用预期会收到消息的测试收件人，检查送达的内容及每个按钮，并核对最终的消息状态。在编辑器中成功提交并不代表端到端测试已完成。

## 从草稿到送达

1. **明确用途。** 确定应触发该消息的客户操作或业务事件。
2. **选择类别和内容。** 保持消息清晰，并为变量提供具有代表性的示例。
3. **创建并提交模板。** 使用 YCloud 的模板管理工作流或 API。
4. **检查审核结果。** 切勿发送仍在等待审核或不可用的模板。
5. **发送与监控。** 提供所需的值，并跟踪消息送达情况及客户反馈。

审核状态和质量是不同的维度。通过审核并不保证永久可用：后续的反馈或平台控制可能会影响模板。

有关审核结果和安全变更，请参阅[模板审核与生命周期](/zh/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle)；有关发送控制，请参阅[质量与发送控制](/zh/documentation/whatsapp-business-platform/pricing-limits-and-quality/quality-and-delivery-controls)。

## 发送前检查

* 确认客户预期会收到该沟通。
* 检查所选模板是否属于目标 WABA。
* 使用正确的已获批语言版本。
* 提供所有必需的值和媒体文件。
* 检查模板的当前状态。
* 确认当前定价以及任何发送限制。
* 处理发送失败和退订请求。

## 开始使用模板

<CardGroup cols={2}>
  <Card title="在 YCloud 中创建模板" icon="file-lines" href="/zh/documentation/channels/whatsapp-accounts-management/template-management/create-template/index">
    通过控制台创建并提交您的模板。
  </Card>

  <Card title="使用 API 管理模板" icon="code" href="/zh/api-reference/guides/whatsapp-platform/manage-whatsapp-templates">
    在您的集成中使用模板资源。
  </Card>

  <Card title="发送 WhatsApp 消息" icon="paper-plane" href="/zh/api-reference/guides/whatsapp-platform/send-whatsapp-message">
    提供模板以及针对收件人的特定参数值。
  </Card>

  <Card title="了解服务消息" icon="message" href="/zh/documentation/whatsapp-business-platform/messaging/service-messages">
    了解何时可以改用自由格式回复。
  </Card>
</CardGroup>

## 常见问题

<AccordionGroup>
  <Accordion title="我在审核期间修改了示例值。客户会收到该值吗？">
    审核示例有助于 Meta 理解占位符，它们并不是您针对客户发送的特定值。在发送时，请按照获批的结构和语言提供每个必需的参数。请使用合成值进行测试，以免审核示例被意外重复用作订单号、姓名或验证码。
  </Accordion>

  <Accordion title="我可以向使用任何语言的客户发送已获批的英文模板吗？">
    您必须发送目标 WABA 和模板名称下已存在的获批语言版本。选择其他语言代码既不会翻译内容，也不会自动批准新版本。请将收件人路由到匹配的获批版本，或者使用已存在的合适回退版本。
  </Accordion>

  <Accordion title="为什么同一个模板名称在一个号码上可以使用，但在另一个号码上却失败？">
    请检查这两个号码对应的 WABA。消息模板是 WABA 资产，而不是在您 YCloud 账户中全局可用的名称。请对比发送失败时的 WABA、名称、语言、状态以及提供的组件。如果是迁移或更换导致了资产变动，请更新调用方的引用，而不是反复重试旧的配置组合。
  </Accordion>
</AccordionGroup>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.