从事件和后续操作入手
清晰呈现发送消息的原因。如果在动态中掺杂优惠券、推荐或促销内容,可能会使其被归类为营销类消息。登录验证码需要使用身份验证模板。请参阅效用模板。

Meta example: a reservation confirmation gives the customer actions relevant to an existing booking.
1. 准备发送者、授权和数据
连接您的号码,确认接收动态的许可授权,并准备好事件、接收者、交易编号、变量和目标链接。发送前请检查客户当前的偏好设置。请参阅订阅(Opt-in)和退订(Opt-out)。2. 创建并测试模板
- 在对应 WABA 下打开 模板 → 添加模板 ,并选择 效用。
- 输入名称、语言和具体的动态内容。对客户或交易相关的值使用变量,并提供具有代表性的虚拟示例。
- 根据需要添加相关按钮,例如物流追踪入口。
- 提交并检查审核状态和类别。如遇拒绝或类别调整,请参阅审核与生命周期。
- 使用测试消息或 复制为 cURL ,通过测试接收者检查语言、变量、按钮和目标页面。
Your order {{1}} has shipped. Estimated delivery: {{2}}.,附带追踪按钮。此内容仅用于说明,并非已获批的模板。请参阅创建模板。
3. 连接发送工作流
应用程序事件:API- 在服务端检测发货、退款或其他事件。确认其为最新事件且尚未被处理。
- 选择已连接的发送者、正确的接收者、已获批的模板及语言,并映射该事件的变量。
- 使用
POST /v2/whatsapp/messages进行异步提交;若需要同步提交结果,请使用POST /v2/whatsapp/messages/sendDirectly。准备好服务端密钥并按照发送 WhatsApp 消息操作。 - 将消息与业务事件关联,并通过
whatsapp.message.updated接收后续更新。请求成功并不代表接收者已成功接收。
可选:符合条件商家的 Direct Send
拥有 Direct Send 权限后,您可以直接提交完整的效用类内容,由 Meta 进行匹配或生成模板。按照 Direct Send 指南 检查权限、提交代表性样本、确认分类,并携带必填字段发送。 这可以减少预先创建模板和变量映射的维护工作。内容、质量和计费规则仍然适用;该功能并非用于发送任意消息。如果没有该权限,请使用已获批的效用类消息模板。4. 查看结果
- 使用消息日志或回调来区分已发送、已送达、已读和失败状态。
- 针对重复和过期的事件进行测试。在支付成功后,不要重试旧的支付失败警告。
- 确认客户的回复能正常进入收件箱(Inbox)或预期的处理工作流。
- 按原因排查失败情况;模板获批并不等同于送达保证。

