摘要
本指南介绍如何通过 WATI 的 API 使用 WhatsApp 发送一次性密码(OTP)。您将学习如何创建身份验证模板、获取批准,并使用 /sendTemplateMessage API 触发 OTP 消息。
说明
请参考此视频教程,了解如何通过 WATI 使用 WhatsApp 发送 OTP:
步骤 1:创建身份验证模板
在发送 OTP 之前,您需要创建一个 身份验证模板消息 并获得 WhatsApp 的批准。该模板确保身份验证消息具有统一的格式。
身份验证模板中需要的元素:
包含 OTP 按钮的身份验证模板必须包含以下内容:
验证消息: 包含 OTP 占位符的预设文本。
<VERIFICATION_CODE>是您的验证码。安全免责声明(可选): 出于安全考虑,请勿共享此代码。
到期警告(可选): 此代码将在
<NUM_MINUTES>分钟内过期。按钮: 要么是 复制代码 按钮,要么是 一键自动填充 按钮。
重要说明:
URL、媒体和表情符号 不支持 身份验证模板。
这些模板可以降低被暂停的风险,因为它们仅由预设文本和按钮组成。
提交模板后,请等待 WhatsApp 的批准,然后再进行下一步。
步骤 2:使用 API 发送 OTP
批准后,您可以使用 WATI 的 /sendTemplateMessage API 触发 OTP。该 API 允许您的系统向用户发送预批准的身份验证消息。
API 端点:
https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
点击此处 了解有关 API 的更多信息。
可用性
身份验证模板可供 Wati 的 增长、专业 和 企业 计划客户使用。如果您使用的是 Wati 的 旧版计划,身份验证模板可供 标准 和 专业 计划使用。
有关详细信息,请参阅官方 WhatsApp Business API 身份验证模板指南。
注意:对于使用 Wati API 发送身份验证 OTP 消息的商家,您可以启用 短信备用,以确保 OTP 传递,并确保即使 WhatsApp 消息失败,业务运营也能顺利进行。
如果 WhatsApp OTP 消息失败,请按照以下步骤设置短信作为备用方案:
步骤 1: 升级到 Wati 企业计划
短信备用仅适用于企业计划。
步骤 2: 将 Wati 连接到 Twilio
在 Wati 中,转到 更多 → 集成。
添加您的 Twilio 账户,并启用 为失败广播发送自动短信。
步骤 3: 创建 WhatsApp OTP 模板
在 Wati 中,创建将用于 WhatsApp 身份验证 OTP 的消息模板。
步骤 4: 创建短信 OTP 模板
创建与步骤 3 中创建的 WhatsApp OTP 模板匹配的短信模板,并将其映射到该模板。
步骤 5: 使用 Wati API 发送 WhatsApp OTP
当您的系统调用 Wati API 发送 WhatsApp OTP 模板时,如果 WhatsApp 传递失败,Wati 将自动通过 Twilio 发送短信备用方案。
常见问题解答(FAQ)
身份验证模板和 OTP
1. 什么是 OTP 的身份验证模板?
这是 WhatsApp 要求通过 Wati 发送 OTP 时需要的预批准消息格式。它包含 OTP 占位符、预设的验证文本和按钮,例如复制代码或一键自动填充。
2. 身份验证模板必须包含哪些元素?
它必须包含带有 OTP 占位符的验证消息。可选字段包括安全免责声明和到期警告。它还必须包含类似复制代码或一键自动填充的按钮。
3. 身份验证模板可以包含 URL、媒体或表情符号吗?
不可以。身份验证模板不支持 URL、媒体和表情符号。
4. 身份验证模板需要 WhatsApp 的批准吗?
是的。您必须提交模板并等待 WhatsApp 的批准,然后才能发送 OTP 消息。
通过 Wati API 发送 OTP
5. 如何使用 Wati 发送 OTP 消息?
您的身份验证模板获批准后,可以使用 Wati 的 /sendTemplateMessage API 发送 OTP。
6. 发送 OTP 消息的 API 端点是什么?
端点是:https://{WATI_API_ENDPOINT}/api/v1/sendTemplateMessage
可用性和备用设置
7. 哪些 Wati 计划支持身份验证模板?
它们支持增长、专业和企业计划。在旧版计划中,它们支持标准和专业计划。
8. 什么是短信备用?谁可以使用它?
短信备用通过发送短信来确保 OTP 传递,如果 WhatsApp OTP 失败。它仅适用于 Wati 企业计划。
9. 如何在 Wati 中启用短信备用?
在 Wati 中的更多 → 集成下连接您的 Twilio 账户,并启用失败广播的自动短信。您还必须创建 WhatsApp 和短信 OTP 模板,并将它们映射在一起,以便备用方案可以自动工作。

