创建和管理范围角色

快速设置

你可以在约 5 分钟内创建或更新组织或酒店中的角色。

本指南将帮助你在获准的范围内创建、编辑和查看角色。

快速参考

任务	操作位置	结果
不使用模板创建	Create New Role → Start from scratch	打开没有复制权限的空白角色
使用模板	Create New Role	自动填充角色详情和权限
复制列表中的角色	Roles 行操作	打开创建表单，并选中该角色
编辑角色	Roles 行操作 → Edit	将获准的更改保存到现有角色
管理分配	Account Management → Permissions	更改或移除所选上下文中的员工角色
查找操作	Search features or actions…	搜索功能名称、以操作为先的说明或权限代码
查看访问权限	Selected actions only 和 Review changes	显示当前选择以及新增或移除的访问权限
重置编辑内容	Reset to source role	恢复所选源角色的值
保存副本	Create Role	创建独立的自定义角色
查找已分配用户	Roles 行操作 → View assigned users	打开已针对该角色筛选的账户结果
删除未使用的范围角色	Roles 行操作 → Delete Role	从目录中移除未分配的自定义角色

开始前准备

• 使用 Superadmin 权限登录，或使用具有 user:permissions 权限的管理者角色。
• 确认源角色包含所需权限。
• 确定新角色适用于全局、某个组织，还是某家酒店。

组织和酒店管理者只能管理由其获准上下文拥有的角色。 他们不能为另一家酒店创建或编辑角色，也不能授予超过自身上限的权限。 角色目录只显示所选组织或酒店可用的角色。 范围权限目录只显示 AVA 当前支持的权限。 已停用的权限不会出现在新角色表单或分配选项中。

全局模板

在你的访问权限允许时，全局模板仍可作为起点。 复制模板会在你选择的范围内创建独立角色。

独立副本

新角色与源角色没有持续关联。 对任一角色的更改都不会更新另一个角色。

编辑全局内置角色

当已持久化的内置角色范围为全局时，你可以编辑该角色。 AVA 在保存更改时会保留该角色的全局范围。 编辑表单允许你更改 Role Name、Description 和 Permissions。 全局内置角色的 Role Scope 字段已锁定。

1. 前往 Superadmin → Permissions → Roles，或打开管理者账户可用的角色区域。

2. 找到要更改的全局内置角色。

3. 点击 Edit。

4. 更新 Role Name、Description 或 Permissions。

5. 确认 Role Scope 仍为 Global。

6. 点击 Update Role。

   ✓ AVA 会将更改保存到现有的全局内置角色。

保持内置角色为全局范围

不要将内置角色更改为组织范围或酒店范围。 AVA 会拒绝对内置角色的范围更改。 非全局内置角色无法编辑。

不使用模板创建角色

你可以在不复制现有角色的情况下创建范围角色。

1. 前往 Superadmin → Permissions → Roles。

2. 点击 Add New Role。

3. 选择 Start from scratch。

4. 输入角色详情并选择所需权限。

5. 选择获准的 Role Scope 和分配对象。

6. 点击 Create Role。

   ✓ AVA 会创建仅包含你所选权限的自定义角色。

选择角色模板

1. 前往 Superadmin → Permissions → Roles。

2. 点击 Add New Role。

3. 打开 Start from an existing role。

4. 搜索系统角色或自定义角色。

5. 选择要用作起点的角色。

   ✓ AVA 会预填角色名称、描述、范围、分配对象和权限。

复制后的名称以 Copy of 开头。 权限列表使用规范的冒号分隔键，例如 admin:billing。

直接从角色列表复制角色

无需打开空白表单，你可以直接从特定角色开始创建。

1. 在 Roles 列表中找到源角色。

2. 点击 Create based on this role。

3. 检查预填的详情和权限。

   ✓ 系统会打开同一个创建表单，并选中该角色作为源角色。

定制新角色

1. 编辑 Role Name 和 Description。

2. 选择 Role Scope。

3. 当范围要求时，选择 Organization 或 Hotel。

4. 在分组的权限编辑器中选择或清除操作。

5. 查看功能说明和以操作为先的描述。

6. 查看继承、新增和移除的权限数量。

7. 确认所选权限不超过你获准授予的权限范围。

8. 点击 Create Role。

   ✓ AVA 会使用你编辑后的权限集保存新的自定义角色。

仔细检查范围

更改范围会清除已选择的组织或酒店。 保存前请重新选择所需的分配对象。

编辑范围角色

当自定义角色属于你的组织或酒店范围时，你可以编辑该角色。 你可以在获准授予的权限上限内更改其名称、描述和权限。

1. 打开当前组织或酒店的 Roles 列表。

2. 找到自定义角色并点击 Edit。

3. 查看角色范围和当前分配对象。

4. 更新 Role Name、Description 或 Permissions。

5. 点击 Update Role。

   ✓ 只有当角色范围和权限仍获准时，AVA 才会保存该角色。

范围和权限限制

AVA 会拒绝对当前上下文之外角色的更改。 AVA 也会拒绝超过你获准授予上限的权限。

删除未分配的范围角色

你可以删除由你的组织或酒店拥有的自定义角色。 该角色不得分配给任何账户。

1. 打开当前组织或酒店的 Roles 列表。

2. 找到自定义角色并查看其已分配账户数量。

3. 如果已分配用户，点击 View assigned users。

4. 重新分配或移除列出的每个账户。

5. 返回 Roles 列表并点击 Delete Role。

6. 确认删除。

   ✓ 未使用的角色会从可用角色目录中移除。

无法删除已分配的角色

请先重新分配或移除每个账户。 内置角色、全局角色、非自有角色和范围外角色无法删除。

查找已分配角色的用户

需要查看或更改分配给某个角色的所有用户时，请使用角色操作。

1. 打开当前组织或酒店的 Roles 列表。

2. 找到角色并点击 View assigned users。

3. 查看已按该角色筛选的账户列表。

4. 需要缩小组织结果范围时，使用 Filter by Hotel。

5. 从 Account Management 更改或移除分配。

   ✓ 查看结果时，AVA 会保留所选的角色和酒店筛选条件。

精确的角色筛选

账户列表会在分页前发送所选角色筛选条件。 这样可以将结果限制为分配给该角色的用户。

分配或移除员工角色

使用 Account Management → Permissions 管理员工的角色分配。 你需要 user:permissions 权限，并且只能管理获准的分配。

1. 在组织或酒店上下文中打开 Account Management。

2. 找到员工并点击 Permissions。

3. 选择 Organization access 或特定的 Hotel access 条目。

4. 从可用目录中选择角色。

5. 点击 Update Role。

   ✓ AVA 会更新所选分配，并保持当前上下文之外的分配不变。

要移除分配，请选择该分配，点击 Remove Role，然后确认。 AVA 会保护你当前的角色，并拒绝超出你获准范围的更改。

组织和酒店之间的转换

在组织访问权限和酒店访问权限之间切换，可能会替换员工当前的访问类型。 保存前请查看确认信息。 当所选上下文允许时，独立的酒店分配仍会彼此分开。

添加员工时使用范围角色

创建账户和发送邀请使用与角色分配相同的范围规则。 选择组织或酒店后，角色选项会刷新。

1. 打开 Account Management。

2. 选择 Add Account 或 Invite User。

3. 选择 Organization access 或 Hotel access。

4. 对于酒店访问权限，选择每家酒店并分别选择其角色。

5. 对于组织访问权限，选择组织角色。

6. 选择 Create Account 或 Send Invite。

   ✓ AVA 会排除不在你获准范围内酒店的角色。

选择角色前先更改范围

更改所选酒店会清除其角色选择。 等待角色列表刷新后，再次选择角色。

查找和查看权限

权限编辑器按功能对操作进行分组。 每项功能默认折叠，便于你快速查看角色。

1. 打开功能，查看其说明和可用操作。

2. 使用 Search features or actions… 搜索描述或技术权限代码。

3. 使用 Feature 筛选器显示一项功能。

4. 选择 Selected actions only 以隐藏未选中的操作。

5. 使用功能复选框选择或清除该功能中的所有操作。

6. 展开 Review changes，检查新增和移除的访问权限。

   ✓ 每项当前权限都有对其允许操作的直接说明。 技术权限代码会保留在下方，供支持和故障排查使用。

现有权限

当前目录之外的权限属于已停用权限。 你可以编辑、撤销、替换或删除过时的角色来清理这些权限。 移除已停用的权限，然后再将该角色分配给其他账户。

AVA 会在可用时使用已翻译的说明或 API 提供的说明。 如果两种说明都无法解析，AVA 会显示本地化的 Unrecognized permission 消息。 该消息会显示可读的权限代码，而不是内部翻译键。

管理 Video Call 访问权限

Video Call 权限显示在 Communication 类别中。 当员工只需要 Video Call 工作流的一部分时，请分别分配这些权限。

权限	授予的访问权限
video_call:settings:manage	查看和更改入口、计划及相关设置
video_call:activity:read	查看 Video Call 活动和转录内容
video_call:activity:manage	查看活动和转录内容、召回通话并运行活动分析
video_call:device_pairing:manage	管理账户拥有的 AVA Alarm 设备配对控制

内置的 Owner 和 Hotel Manager 角色包含全部四项权限。 自定义角色仅包含你所选择的操作。

General Settings 权限不再授予 Video Call 访问权限。 对于需要 Video Call 的每个自定义角色，请使用专用权限。 video_call:activity:read 仅允许查看。 video_call:activity:manage 还允许召回通话和进行活动分析。 当账户配对可用时，已登录员工仍可配对自己的移动设备。

1. 从 Superadmin → Permissions → Roles 打开角色编辑器。

2. 搜索 Video Call，或打开 Communication。

3. 选择角色所需的操作。

4. 查看更改，然后点击 Create Role 或 Update Role。

   ✓ 该角色只会获得所选的 Video Call 功能。

管理 Phone AI 和 Voice Translation 访问权限

Phone AI 和 Voice Translation 权限显示在 Communication 类别中。 当员工需要某项功能但不需要广泛的 Settings 访问权限时，请分别分配这些权限。

权限	授予的访问权限
phone_ai:read	打开 Phone AI 并查看通话活动和转录内容
phone_ai:manage	配置、测试并激活 Phone AI
voice_translation:read	查看 Voice Translation 设置
voice_translation:manage	更改 Voice Translation 设置

每项 manage 权限也会授予对应的 read 权限。 读取访问权限不会授予管理访问权限。 General Settings 权限不会授予这些新功能权限。

1. 从 Superadmin → Permissions → Roles 打开角色编辑器。

2. 搜索 Phone AI 或 Voice Translation。

3. 选择角色所需的操作。

4. 查看更改，然后点击 Create Role 或 Update Role。

   ✓ 该角色只会获得所选的 Phone AI 和 Voice Translation 功能。

查看角色但不编辑

你可以打开角色详情，在不更改角色的情况下查看其访问权限。

1. 前往 Superadmin → Permissions → Roles。

2. 找到要检查的角色。

3. 点击 View permissions。

4. 查看按功能分组的权限明细。

   ✓ 详情视图会显示角色描述、已分配账户数量和已授予的操作。

重置或替换起始角色

保存前，你可以重置编辑内容或选择其他源角色。

重置编辑内容

1. 点击 Reset to source role。

2. 查看确认消息。

3. 点击 Reset role。

   ✓ 表单会恢复为所选源角色的详情和权限。

选择其他源角色

1. 打开角色模板搜索字段。

2. 选择其他角色，或选择 Start from scratch。

3. 查看确认消息。

4. 点击 Use this role 或 Start from scratch。

   ✓ AVA 仅在你确认后替换表单值。

未保存的编辑内容

选择其他源角色可能会替换你的名称、描述、范围、分配对象和权限。 如果需要保留编辑内容，请取消确认。

现象 → 修复

角色模板仍在加载

**现象：**模板字段显示 Loading available role templates...。

**修复：**等待角色列表完成加载，然后再次搜索。 如果加载失败，请创建空白角色并手动选择权限。

更改源角色后编辑内容消失

**现象：**选择源角色后，表单显示了另一个角色的详情。

**修复：**更改源角色前取消确认。 如果已经确认，请重新输入编辑内容，或再次使用正确的源角色。

复制的角色范围不正确

**现象：**复制的角色指向源角色所属的组织或酒店。

**修复：**选择正确的 Role Scope。 然后在创建角色前选择所需的 Organization 或 Hotel。

复制的权限似乎缺失

**现象：**旧角色中的权限未出现在权限目录中。

**修复：**确认该权限已停用，并将其从复制的角色中移除。 保存角色，然后重新打开以验证当前权限。

AVA 会从新角色和角色分配中排除已停用的权限。

权限说明无法识别

**现象：**某项权限显示 Unrecognized permission 和可读代码。

**修复：**查看权限代码；如果该访问权限符合预期，请保留该权限。 如果无法确定它授予的访问权限，请联系支持团队。

无法创建或编辑所选角色

**现象：**AVA 隐藏了角色操作，或拒绝保存。

**修复：**确认你拥有 user:permissions 权限。 切换到拥有该角色的组织或酒店，然后重试。 如果需要更大的范围或权限授予，请向更高级别的管理员寻求帮助。

角色分配被拒绝

**现象：**AVA 拒绝 Update Role 或 Remove Role。

**修复：**确认员工和所选分配属于你的当前上下文。 不要更改你自己的当前角色。 从可用目录中选择角色，然后重试。

如果角色包含已停用的权限，请编辑角色并先移除该权限。 然后保存角色并重试分配。

Delete Role 已禁用

**现象：**Delete Role 已禁用，或 AVA 表示该角色已被分配。

修复：

1. 点击该角色的 View assigned users。
2. 重新分配或移除列出的每个账户。
3. 等待已分配数量变为零后返回角色列表。
4. 重试 Delete Role。

角色删除被拒绝

**现象：**AVA 因范围或所有权问题拒绝删除。

**修复：**确认该角色是由当前组织或酒店拥有的自定义角色。 切换到拥有该角色的上下文，然后重试。

更换酒店后角色列表为空

**现象：**选择其他酒店后没有显示角色，或列表短暂刷新。

**修复：**等待酒店专属角色加载完成。 如果列表仍为空，请确认该酒店在你的范围内。 然后关闭并重新打开账户或邀请表单。

AVA 会在后台刷新期间保留之前加载的角色结果。 这样你可以在最新结果加载时继续查看角色。

仍然无法解决？

如果出现以下情况，请联系 success@vouch-technologies.com：

• ❌ 角色模板始终无法完成加载
• ❌ 确认的更改在保存后没有显示
• ❌ 新角色的权限或范围不正确

请提供源角色名称、新角色名称、截图和问题发生时间。

相关指南

• 角色权限未保存
• 设置多物业访问权限
• 设置你的账户