> ## 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 发送效用类消息
使用效用类消息发送有关现有交易、账户或服务请求的动态。客户可以查看物流、核对预约或回复寻求帮助。您的团队可以追踪通知结果，并减少重复的状态解释。
## 从事件和后续操作入手
| 场景 | 包含内容 | 客户操作 |
| - | - | - |
| 订单已发货 | 订单编号、物流状态和追踪入口。 | 追踪物流或寻求帮助。 |
| 预约已变更 | 现有预约及新时间。 | 查看详情或申请变更。 |
| 退款已完成 | 订单编号、金额和退款状态。 | 查看退款。 |
| 账户信息已变更 | 实际变更内容及相关说明。 | 确认变更或报告问题。 |
清晰呈现发送消息的原因。如果在动态中掺杂优惠券、推荐或促销内容，可能会使其被归类为营销类消息。登录验证码需要使用身份验证模板。请参阅[效用模板](/zh/documentation/whatsapp-business-platform/messaging/message-templates/utility-templates)。
来源：[Meta 效用模板](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/utility-templates/utility-templates)。
## 1. 准备发送者、授权和数据
[连接您的号码](/zh/documentation/quick-start/connect-whatsapp-to-ycloud)，确认接收动态的许可授权，并准备好事件、接收者、交易编号、变量和目标链接。发送前请检查客户当前的偏好设置。请参阅[订阅（Opt-in）](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-in)和[退订（Opt-out）](/zh/documentation/whatsapp-business-platform/consent-policies-and-account-health/customer-opt-out)。
## 2. 创建并测试模板
1. 在对应 WABA 下打开 **模板 → 添加模板** ，并选择 **效用**。
2. 输入名称、语言和具体的动态内容。对客户或交易相关的值使用变量，并提供具有代表性的虚拟示例。
3. 根据需要添加相关按钮，例如物流追踪入口。
4. 提交并检查审核状态和类别。如遇拒绝或类别调整，请参阅[审核与生命周期](/zh/documentation/whatsapp-business-platform/messaging/message-templates/template-review-and-lifecycle)。
5. 使用[测试消息](/zh/documentation/channels/whatsapp-accounts-management/template-management/test-a-message)或 **复制为 cURL** ，通过测试接收者检查语言、变量、按钮和目标页面。
例如：`Your order {{1}} has shipped. Estimated delivery: {{2}}.`，附带追踪按钮。此内容仅用于说明，并非已获批的模板。请参阅[创建模板](/zh/documentation/channels/whatsapp-accounts-management/template-management/create-template/index)。
## 3. 连接发送工作流
**应用程序事件：API**
1. 在服务端检测发货、退款或其他事件。确认其为最新事件且尚未被处理。
2. 选择已连接的发送者、正确的接收者、已获批的模板及语言，并映射该事件的变量。
3. 使用 `POST /v2/whatsapp/messages` 进行异步提交；若需要同步提交结果，请使用 `POST /v2/whatsapp/messages/sendDirectly`。准备好服务端密钥并按照[发送 WhatsApp 消息](/zh/api-reference/guides/whatsapp-platform/send-whatsapp-message)操作。
4. 将消息与业务事件关联，并通过 `whatsapp.message.updated` 接收后续更新。请求成功并不代表接收者已成功接收。
**选定受众群发：Campaign**
打开 **群发 → 添加群发 → WhatsApp**。选择发送者、效用类模板、语言和发送时间。选择接收者，映射变量，预览并提交。每位接收者都需要有真实对应的业务上下文。可以通过文件为每位客户提供不同的订单值；请参阅[创建群发](/zh/documentation/campaign/create-a-whatsapp-marketing-campaign)。
**多步骤或电商集成**
当需要等待、分支或后续操作时，使用支持的[用户旅程（Journey）](/zh/documentation/journey/create-a-journey)触发器和组件。Shopify 用户可以使用[已取消和已发货订单通知](/zh/documentation/integrations/e-commerce/shopify/notify-customers-about-canceled-or-fulfilled-orders)。为某项通知指定单一工作流，避免 API 和集成同时针对同一事件重复发送。
## 可选：符合条件商家的 Direct Send
拥有 Direct Send 权限后，您可以直接提交完整的效用类内容，由 Meta 进行匹配或生成模板。按照 [Direct Send 指南](/zh/api-reference/guides/whatsapp-platform/best-practices/direct-send) 检查权限、提交代表性样本、确认分类，并携带必填字段发送。
这可以减少预先创建模板和变量映射的维护工作。内容、质量和计费规则仍然适用；该功能并非用于发送任意消息。如果没有该权限，请使用已获批的效用类消息模板。
## 4. 查看结果
* 使用[消息日志](/zh/documentation/channels/whatsapp-accounts-management/data-analysis/message-logs)或回调来区分已发送、已送达、已读和失败状态。
* 针对重复和过期的事件进行测试。在支付成功后，不要重试旧的支付失败警告。
* 确认客户的回复能正常进入收件箱（Inbox）或预期的处理工作流。
* 按原因排查失败情况；模板获批并不等同于送达保证。
监控送达率、失败情况以及后续的客户操作。费用详情请参阅 [WhatsApp 价格](/zh/documentation/whatsapp-business-platform/pricing-limits-and-quality/whatsapp-pricing)。
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.