用户事件

用户事件行为提供了完整的用户身份认证和账户管理功能，支持微信小程序和网页端的注册、登录、绑定、验证码等操作，为应用构建安全可靠的用户体系。

用户事件行为包括：

小程序端：

1. 微信静默登录
2. 获取用户微信头像/昵称
3. 账户绑定/解绑
4. 验证码发送/验证

网页端：

1. 用户注册/登录
2. 验证码管理
3. 账户绑定/解绑
4. 密码重置
5. 登出/注销

小程序端用户事件

微信静默登录

作用

首次进入小程序时，通过【静默登录】行为获取 openid、unionid（如有），生成“游客身份”，并在 account 表添加用户数据。后续登录自动沿用该身份。

特殊说明

1. 可直接使用【当前用户数据】引用当前用户。
2. 静默登录以 openid/unionid 区分用户，unionid 需关注同主体公众号。
3. 项目创建后默认全局添加该行为，无需手动配置。

获取用户微信头像/昵称

作用

获取微信用户头像和昵称，自动修改账户表。常用于小程序登录场景。

配置与输出

在组件交互中添加“用户事件-获取用户微信头像/昵称”行为，通常在成功时配置【刷新当前用户数据】行为。

选择行为	配置成功时刷新	线上效果

特殊说明

• 微信页面需选择邮箱和昵称后点击确认，才能获取头像和昵称。

绑定

作用

为账户添加手机号或邮箱并验证，增强安全性，便于找回密码或接收通知。绑定成功后修改账户表。

配置与输出

1. 按钮添加绑定行为，绑定输入手机号/邮箱的组件。
2. 添加发送验证码按钮，验证码类型设为“绑定账号”。

绑定手机号	绑定邮箱

解绑

作用

移除账户中已绑定的手机号或邮箱，常用于更换联系方式或不再使用某方式接收信息。解绑成功后账户表对应字段置空。

配置与输出

按钮添加解绑行为，绑定输入验证码的组件。

• 验证码类型设为“解绑账号”。

解绑手机号	解绑邮箱

发送验证码

作用

用于登录、注册、重置密码、绑定/解绑账号、注销等敏感操作的安全身份验证。

• 系统内置服务：基于阿里云，配置开箱即用，但会消耗项目短信包额度。
• 接入自有服务：支持灵活接入第三方发送通道（如其他短信服务、邮件、微信通知等）。不消耗 Zion 短信包额度，且支持完全自定义发送模板与签名。

运行机制详解：

1. 生成：执行“发送验证码”行为时，系统自动生成 6 位纯数字验证码，并将账号、验证码与使用场景保存在数据库中（表不对外暴露）。
2. 发送：
   • 系统方式：通过内置通道直接发送。
   • 自定义方式：系统将接收账号、验证码、使用场景传入指定的行为流，由行为流完成发送逻辑。
3. 校验：执行登录/注册等最终行为时，系统自动将行为入参（手机号或邮箱、验证码、使用场景）与数据库中保存的验证码记录进行比对，一致则通过。

配置说明

1. 行为配置

“发送验证码”行为的配置项如下：

2. 自定义发送流程

若使用“自定义”发送方式，需依次完成以下 3 步配置：

第一步：创建发送行为流

1. 新建行为流，添加 3 个入参：接收账号、验证码、使用场景。
2. 添加发送节点，可使用内置的阿里云发送短信/阿里云发送邮件/Twilio 发送短信节点，或通过 API 等其他通道发送验证码。
3. 将上述入参绑定到发送节点的对应参数上。

第二步：添加自定义配置

1. 进入 设置 → 验证码，并添加自定义配置。
2. 填写基础信息：
   • 名称：自定义识别名（如：腾讯云短信）。
   • 发送验证码的行为流：选择【第一步】创建的行为流。
   • 行为流输入： 在数据绑定菜单的「常量」分类下，将 发送目标、验证码、场景 分别绑定到行为流的 接收账号、验证码、使用场景 入参。

第三步：使用自定义配置

在发送验证码行为的“自定义配置”中选择刚添加的自定义配置。即可使用自定义配置发送验证码。

校验验证码

作用

校验用户输入的验证码是否正确，正确时执行后续行为，错误时提示。

使用方法：

1. 添加校验验证码行为，选择发送方式，绑定手机号和验证码输入组件。
2. 验证成功/失败时配置后续行为。

选择行为	选择发送方式

网页端用户事件

注册

作用

用户创建新账户，需填写基本信息（姓名、邮箱、手机号、密码等），可选邮箱/手机验证。支持用户名、手机号、邮箱三种注册方式。

配置与输出

按钮添加注册行为，绑定输入组件获取注册信息。

用户名注册	手机号注册	邮箱注册

特殊说明

1. 注册成功后，Zion 会自动添加账户数据并建立一对一关联。
2. 注册成功/失败时建议配置【显示提示】行为。

登录

作用

已注册用户通过用户名、手机号、邮箱、验证码等方式登录应用。支持用户名、手机号验证码、手机号密码、邮箱、微信扫码、微信授权、企微登录等多种方式。

配置与输出

按钮添加登录行为，绑定输入组件获取登录信息。

用户名登录	手机号验证码登录	手机号密码登录	邮箱登录	微信扫码登录

微信登录前置条件

1. 登录设置中开启微信登录并填写 App-ID、App-Secret。
2. App-ID、App-Secret 获取方式：
   • 微信扫码登录：微信·开放平台  注册账号，创建网站应用，获取 App-ID、App-Secret，配置授权webhook地址：https://zionbackend.functorz.com/
   • 微信授权登录：微信·公众平台  注册公众号（服务号且认证），开发配置获取 App-ID、App-Secret，功能设置中配置网页授权域名为 Zion 网页端发布域名，要求下载的校验文件可上传至网页端全局设置-上传文件至根目录。

登录成功/失败时建议配置【显示提示】或跳转行为。

Web 端与小程序端的账号联通

在 Web 端使用“微信扫码登录”时，打开“跨客户端启用微信身份关联”开关,即可实现 Web 端与小程序端的账号联通。

其原理是扫码登录时通过微信的 Union ID 查找是否已经存在该微信账号，如果存在，则使用该账号登录；否则，创建新账号。

验证码

作用

敏感操作时向用户发送一次性验证码，增强账户安全。

配置与输出

按钮添加发送验证码行为，绑定输入组件获取手机号或邮箱。

绑定

作用

为账户添加手机号或邮箱并验证，增强安全性。

配置与输出

按钮添加绑定行为，绑定输入组件获取手机号或邮箱。

• 验证码类型设为“绑定账号”。

绑定手机号	绑定邮箱

解绑

作用

移除账户中已绑定的手机号或邮箱。

配置与输出

按钮添加解绑行为，绑定输入组件获取验证码。

• 验证码类型设为“解绑账号”。

解绑手机号	解绑邮箱

重置密码

作用

用户忘记密码时通过已绑定手机号或邮箱重置密码，需先验证身份。

配置与输出

按钮添加重置行为，绑定输入组件获取手机号、新密码、验证码。

手机号重置密码	邮箱重置密码

登出

作用

用户主动退出应用，结束当前登录会话，保护个人信息安全。

选择行为	线上效果

注销

作用

用户永久删除账户及数据，分验证码注销和密码注销两种方式。

• 验证码类型设为“注销”。

验证码注销	密码注销