摘要
本指南介绍了如何使用 Wati 的 API 通过 WhatsApp 发送一次性密码 (OTP)。您将学习如何创建身份验证模板、获得批准以及使用 /sendTemplateMessage API 触发 OTP 消息。
注意:Broadcasts 现在是 Campaigns – 同样强大的功能,更新的名称!
可用性
Growth、Pro 和 Business 计划的 Wati 客户可以使用身份验证模板。
如果您使用的是 Wati 的旧版计划,则 Standard 和 Professional 计划可以使用身份验证模板。
操作说明
请参阅此视频演练,了解如何通过 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注意:对于使用 Wati API 发送身份验证 OTP 消息的商家,您可以启用 SMS 回退,以帮助确保 OTP 交付,并在 WhatsApp 消息失败时保持顺畅的业务运营。
设置 SMS 回退(如果 WhatsApp OTP 失败)
如果 WhatsApp OTP 消息失败,请按照以下步骤设置 SMS 作为回退:
步骤 1:升级到 Wati Business 计划
SMS 回退仅在 Business 计划中可用。
步骤 2:将 Wati 与 Twilio 连接
在 Wati 中,转到更多 → 集成。
添加您的 Twilio 帐户并启用为失败的 Campaign 发送自动 SMS。
步骤 3:创建 WhatsApp OTP 模板
在 Wati 中,创建将用于 WhatsApp 身份验证 OTP 的消息模板。
步骤 4:创建 SMS OTP 模板
创建匹配的 SMS 模板,并将其映射到您在步骤 3 中创建的 WhatsApp OTP 模板。
步骤 5:使用 Wati API 发送 WhatsApp OTP
当您的系统调用 Wati API 发送 WhatsApp OTP 模板时,如果 WhatsApp 交付失败,Wati 将通过 Twilio 自动发送 SMS 回退。
提示:要了解有关身份验证模板的更多信息,请参阅 Meta 的官方指南。
常见问题 (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 计划支持身份验证模板?
Growth、Pro 和 Business 计划支持它们。在旧版计划中,Standard 和 Professional 计划支持它们。
8. 什么是 SMS 回退,谁可以使用它?
SMS 回退通过在 WhatsApp OTP 失败时发送 SMS 来确保 OTP 交付。它仅在 Wati Business 计划中可用。
9. 如何在 Wati 中启用 SMS 回退?
在 Wati 中的更多 → 集成下连接您的 Twilio 帐户,并启用失败的 Campaign 的自动 SMS。您还必须创建 WhatsApp 和 SMS OTP 模板,并将它们映射在一起,以便回退可以自动工作。

