跳到主要内容

短信模板

Logto 提供四种不同的模板用于自定义短信内容,这些模板根据其使用类型分类为:Register、SignIn、ForgotPassword 和 Generic。强烈建议你为不同的用例使用不同的模板,否则可能会达到速率限制,导致服务暂时中断。

短信模板类型和示例

以下是一些仅供参考的示例:

usageType场景模板示例
SignIn用户使用手机号登录,并通过输入短信验证码而不是密码进行验证。Logto 登录验证码:{{code}}。10 分钟内有效。
Register用户使用手机号创建账户,并通过输入 Logto 发送到其手机号的验证码进行验证。Logto 注册验证码:{{code}}。10 分钟内有效。
ForgotPassword如果用户在登录时忘记密码,他们可以选择先使用手机号验证身份以重置密码Logto 密码重置验证码:{{code}}。10 分钟内有效。
Generic此模板可以用作各种场景的一般备选方案,包括测试连接器配置、在登录后验证或关联手机号等。Logto 验证码:{{code}}。10 分钟内有效。
OrganizationInvitation使用此模板向用户发送邀请链接以加入组织。Logto 组织邀请验证码:{{code}}。10 分钟内有效。
UserPermissionValidation在应用使用过程中,可能会有一些高风险操作或风险等级较高的操作需要额外的用户验证,例如银行转账、删除正在使用的资源和取消会员资格。在这些情况下,可以使用 UserPermissionValidation 模板来定义用户收到的短信验证码的内容。Logto 验证码:{{code}}。10 分钟内有效。
BindNewIdentifier当用户修改其个人资料时,他们可能会将手机号绑定到当前账户。在这种情况下,可以使用 BindNewIdentifier 模板来自定义验证短信的内容。Logto 账户关联验证码:{{code}}。10 分钟内有效。

了解这些参数很重要:

  • 验证码有效期为 10 分钟。目前我们不支持自定义过期时间。
  • Logto 会将短信模板中的 {{code}} 占位符替换为验证码。因此,请确保模板中保留了一个占位符。
备注:

由于合规要求,一些国家和地区可能不允许通过短信发送未经批准的内容。短信模板需要在使用前由短信提供商注册和批准。在这种情况下,内容可能会通过模板 ID 索引到相应的模板。