---
title: "编写 WhatsApp 身份验证模板"
description: "创建带有复制验证码按钮的 WhatsApp 身份验证模板，配置其安全提示和过期提示文本，并提交每种语言以供审核。"
canonical: "https://bird.com/zh-sg/wendang/guides/whatsapp/authoring-templates/authentication"
---

# 编写 WhatsApp 身份验证模板

创建身份验证模板，用于发送登录、账户验证或账户恢复所需的一次性验证码。消息文案由 Meta 提供。你可以选择是否包含其安全建议和验证码过期提示。

## 开始之前

连接[你自己的号码和 WhatsApp Business 账户](/docs/guides/whatsapp/numbers/connect)。在创建或复制身份验证模板之前，请检查该账户的[企业验证状态](/docs/guides/whatsapp/templates/authentication#before-you-send)。

Bird 支持带有 **Copy code** 按钮的身份验证模板。Meta 还介绍了 Android 一键填充和零点击模板，但 Bird 的编写 API 和编辑器不提供这些按钮类型。请参阅 [Meta 的身份验证模板指南](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/authentication-templates)。

## 创建模板

1. 打开 [**Approved templates**](https://bird.com/dashboard/w/whatsapp/templates)，选择 **New template**，然后选择 **Start from scratch**。
2. 选择 **Authentication** 和已连接的企业账户。输入名称并选择默认语言。
3. 选择 **Create template** 以打开编辑器。

如需基于现有模板开始，请选择 **Start with a template**，并将一个身份验证模板复制到你的账户。副本是草稿，需要单独提交。导入的身份验证模板可能会以 [`E15024`](/docs/api/errors/E15024) 拒绝复制；此时请从头创建模板。

## 配置消息

**Authentication settings** 面板会取代自由文本编辑器：

1. 启用 **Add security recommendation**，在消息中加入 Meta 提供的请勿分享验证码的提示。
2. 设置 **Code expiration (minutes)** 以加入过期提示。留空则不显示该提示。请使其与应用实际执行的验证码有效期一致；该提示本身不会让应用中的验证码过期。
3. 检查手机预览（包括 **Copy code** 按钮），然后选择 **Save as draft**。

![身份验证模板编辑器，显示安全建议开关、验证码过期时间字段，以及带有 Copy code 按钮的手机预览](/images/docs/dashboard-whatsapp-template-builder-auth.png)

Meta 接受 1 到 90 分钟的过期提示。身份验证内容不能包含 URL、媒体或表情符号，验证码最多 15 个字符。这些限制来自 [Meta 的复制验证码模板文档](https://developers.facebook.com/documentation/business-messaging/whatsapp/templates/authentication-templates/copy-code-button-authentication-templates)。

添加应用所需的语言，并逐一检查每种语言的设置和预览。审核按语言分别进行。

## 提交与测试

1. 选择 **Submit for review**。
2. 等待该语言获得批准，并在线上版本中可用。
3. 使用新模板的 slug 和已获批的语言[发送测试消息](/docs/api/reference/create-whatsapp-message)。将 `from` 设为模板所属企业账户的号码，将 `to` 设为测试收件人的电话号码。在正文和 **Copy code** 按钮参数中提供相同的验证码。

确认消息已送达，**Copy code** 复制的是预期值，并且您的应用接受该验证码、在过期后拒绝它。身份验证消息会在收件人的主 WhatsApp 设备上显示验证码；关联设备会提示收件人到主设备上查看。

如果创建失败并返回 [`E15043`](/docs/api/errors/E15043)，请检查所连接账户的验证状态。如果提交失败，请先查看受影响语言上的错误，再进行编辑或重试。

## 后续步骤

- [创作概览](/docs/guides/whatsapp/authoring-templates)：草稿、语言和审核状态
- [发送身份验证模板](/docs/guides/whatsapp/templates/authentication)：验证码参数和发送方要求
- [Verify](/docs/guides/verify/overview)：托管式验证码生成与验证
- [模板语言 API](/docs/api/reference/upsert-whatsapp-template-language)：通过 API 编写内容

## Related resources

- [Connecting WhatsApp to Bird: from buying a number to a live channel](/learn/whatsapp/connecting-whatsapp-to-bird) (video)
- [What is the 24-hour customer service window on WhatsApp?](/explained/whatsapp/what-is-the-24-hour-customer-service-window) (answer)
- [WhatsApp message builder](/tools/whatsapp-message-builder) (tool)
- [WhatsApp](/whatsapp-api) (product)

[Get an implementation brief](/learn/workspace?topic=whatsapp)