订单更新需要固定的措辞以及与该笔购买相关的具体信息。模板将审批过的措辞与订单号等变量值分开管理。
什么时候需要模板？
在客户的 24 小时服务窗口之外发送消息时，需要使用经过审批的模板。
在窗口开启期间，你可以用自由格式的内容回复。发送模板本身不会重新打开窗口；客户的回复才会。
审批不能替代客户许可。请遵循 Meta 的消息政策来发送你要发送的消息。
模板在 Bird 中包含什么？
模板标识可复用的内容，而它的版本保存每种语言的措辞。
发送时使用 slug。显示名称用于标注模板，但不是发送时解析所用的标识。
创建模板时选择 authentication、marketing 或 utility。Bird 在创建后将声明的类别和 slug 锁定。
一种语言的内容包含一个必需的 body 块。它还可以包含 header、footer、buttons 或 carousel，具体取决于模板的内容规则。
要查看已审批的内容，请从模板中读取 live_version_id。然后通过语言命令获取该版本的语言。
没有上线版本的模板无法发送。其草稿仍可能包含尚未通过审核的内容。
发送时将使用哪种语言和类别？
通过 available_languages 检查可发送的语言。通过语言自身的 category 查看 Meta 的计费分类。
模板的 status 汇总了其语言信息。active 状态的模板至少有一种可发送的语言。其他语言可能处于被拒绝、暂停或禁用状态。
Meta 可能在上线后撤销某种语言的审批或可用性。发送时请检查语言状态，而不是依赖部署时保存的固定列表。
Meta 也可能在不改变你声明的类别的情况下重新分类某种语言。估算费用时，请使用该语言的分类及已公布的 WhatsApp 费率。
在提交语言之前，使用示例检查类别：
| 示例内容 | 类别选择要点 |
|---|---|
Your order {{reference}} has shipped. | 特定交易更新属于 utility 模式 |
Your code is {{code}}. | 身份验证消息使用 authentication 类别及其编写规则 |
Get 20% off your next order. | 促销优惠属于 marketing 路径 |
示例仅作参考。Meta 审核提交的语言内容后，可能将其归入与你选择的类别不同的分类。
设置 on_missing_language 来决定当请求的语言没有可用副本时的处理方式。Bird 将新建的 WhatsApp 模板默认设为 fail。每种语言单独审批和计费，因此静默替换可能发送意料之外的内容并产生非预期的费率。
该策略仍允许更宽泛的标签匹配：pt 可以响应对 pt-BR 的请求。但它不会替换同级变体 pt-PT。
仅当用配置的默认语言替换对你的收件人来说可以接受时，才选择 fallback。由 Bird 管理的模板保持其固定的缺失语言策略。
如何修改已提交的内容？
创建新草稿。编写更正后的语言内容。将该版本提交审核。
Bird 使已提交的版本不可变，因此编辑模板标签不会改变已审批的消息内容。
| 字段 | 含义 |
|---|---|
draft_version_id | 存在未提交的草稿 |
pending_version_id | 已提交的版本仍有未决语言 |
live_version_id | 该版本提供用于发送的内容 |
一种语言的审批通过可以使其所在的整个版本上线。该版本上的其他语言仍可能处于待审核或被拒绝状态。
查看已提交版本的语言以跟踪审核进度。在替换版本等待审批期间，模板仍可能显示先前的上线版本。
如何发送模板？
指定模板名称。提供你要发送的语言所需的变量。
使用以下方式查找可用模板：
bird whatsapp templates list使用 bird whatsapp templates get 查看所选模板。在组装发送所需的 components 之前，先获取其语言内容，这些载荷携带该模板变量的值。
在控制台中，模板详情页提供了一个包含该模板示例值的 cURL 示例。发送前请将收件人、凭据和变量替换为你的实际值。
创建的模板需要同一 WhatsApp Business Account 上的发送者。按照发送流程操作。通过送达事件跟踪返回的消息标识符。
202 响应表示请求已被接受并进入处理。在收到后续的送达结果之前，不要将消息视为已送达。
简而言之
发送前检查语言。
处于活跃状态的模板可能包含不可用的语言。使用
available_languages检查收件人的语言是否可发送。查看语言的分类。
Meta 可能将某个语言归入与你声明的类别不同的分类。计费以 Meta 的分类为准。
通过新草稿编辑。
Bird 会冻结已提交的版本。创建新草稿来修改内容，然后将更正后的语言提交审核。
使用变量发送已审批的内容。
指定模板名称并提供其语言所需的变量值。请求被接受并不代表已送达。