跳到主内容

Tokenjoy 后台功能使用说明

4. 建立组织架构

适合角色:超级管理员 / 组织管理员 · 前置条件:已进入企业 导航:组织与权限 → 数据源 / 组织架构

4.1 选择数据源平台

进入 数据源(/org/data-source),选择对接的第三方协作平台:

平台 状态 凭证字段
飞书 可用 App ID、App Secret
钉钉 可用 Corp ID、Client ID、Client Secret
企业微信 即将支持 Corp ID、Secret、Agent ID

也可跳过第三方平台,直接用 「CSV 批量导入」。

数据源页
数据源页

4.2 配置数据源(三步向导)

点「开始配置」进入向导,共三步:

  1. 凭证配置 —— 填写对应平台凭证,点「测试连接」。 成功后提示「连接成功,凭证已保存」;失败提示「连接失败,请检查凭证信息」。

    凭证配置
    凭证配置
  2. 字段映射 —— 把源字段映射到 Tokenjoy 目标字段(姓名 / 手机号 / 邮箱 / 部门名称 / 部门 ID / 状态 / 角色 / 忽略)。 需先「测试映射」通过才能「下一步」。

  3. 定时同步 —— 配置自动同步策略:

    配置项 取值 默认
    自动同步 开关 关
    每日开始时间 时间 02:00
    同步频率 每 6 / 12 / 24 小时 24 小时
    删除成员保护阈值 数字(单次删除超过此数将暂停同步) 10
    删除部门保护阈值 数字 3
    异常通知方式 手机短信 / 邮箱 / IM 通知(多选) 短信

    点「保存并完成」后卡片显示「数据源已连接」+「上次导入:…」,并提供「重新配置」「前往组织架构」。

同步规则:第三方数据以第三方为准(新增加入、离职软删除、改名跟随);本地手动添加的数据不受同步影响;超过删除保护阈值会暂停同步并通知超管。

4.3 管理与导入成员

组织架构(/org/structure)左侧是部门树(支持「搜索部门...」),右侧是成员表。

组织架构
组织架构
  • 新增部门:部门树上的「+」,弹窗「添加子部门」(或重命名),输入「部门名称」→「确定」。

    添加子部门
    添加子部门
  • 删除部门:若部门下有子部门或成员,会提示「请先移动或删除该部门下的子部门和成员」,阻止删除。

  • 添加成员:点「添加成员」填写表单 —— 姓名*、主部门*、手机号/邮箱(至少一项)、昵称、工号*、职位、入职时间。

    添加成员
    添加成员
  • CSV 批量导入:在数据源页点「CSV 批量导入」,先「下载 CSV 模板」,再拖拽/选择文件,预览校验后「确认导入 N 名成员」。 模板列:姓名*、工号*、部门*、手机号、邮箱、昵称、职位、入职时间(手机号与邮箱至少填一项,入职时间格式 YYYY-MM-DD 或 YYYY/M/D)。

    CSV 导入
    CSV 导入
  • 批量操作:勾选多名成员后,底部操作栏提供「转移部门 / 启用 / 停用 / 删除 / 取消选择」。

  • 成员表字段:姓名、昵称、部门、职位、状态(已激活/已停用/待激活)、角色、来源(手动/CSV/飞书/钉钉/企微/邀请/导入/链接邀请)、操作。

停用成员会使其 Key 同步失效。

4.4 邀请成员

工具栏 「邀请链接」 打开弹窗:

  • 说明文案:「通过链接注册的人将作为普通成员直接加入公司。」
  • 配置:有效期(永久 / 7 / 30 / 90 天)、人数上限(不限 / 10 / 20 / 50)。
  • 点「新建链接」生成并自动复制到剪贴板。
  • 已生成链接显示状态(有效 / 已过期 / 已用满 / 已失效)与用量(如「已加入 0/20 人」「7 天后过期」),可「使失效」或「删除记录」。
邀请链接
邀请链接

若列表顶部提示「当前有 N 名成员尚未激活」,可点「发送激活邀请」批量重发;或对单个成员用行内菜单「获取邀请链接 / 重新发送邀请」。

本章共 7 张界面截图,点击图片可查看原图。