团队
通过四个分级角色、按成员的权限覆盖以及仅追加的审计日志，与队友共享您的 TelegramOS 工作区。
团队是一个共享工作区。成员在角色允许的范围内，操作团队所有者的账号、收件箱、自动化、机器人和数据分析，而无需共享所有者的登录凭据。团队在“设置 > 团队”中管理。
创建团队和邀请成员需要具备 team 能力的套餐（Growth 和 Agency；7 天试用也包含该能力）。成员可以使用任何套餐，包括 Free。列出成员、更改角色和退出团队从不受套餐限制。
角色
角色按等级排列：viewer < operator < admin < owner。每个角色都有一组固定的默认权限。
| 角色 | 默认权限 |
|---|---|
| Owner（所有者） | 全部权限，包括 team:settings:write 和 billing:manage |
| Admin（管理员） | 账号读取/写入/删除，任务读取/运行/写入/删除，收件箱读取/回复，数据分析，机器人读取/写入，成员读取/邀请/移除/更新，审计日志读取，账单读取 |
| Operator（操作员） | 账号读取，任务读取/运行，收件箱读取/回复，数据分析读取，机器人读取，成员读取 |
| Viewer（查看者） | 账号读取，任务读取，收件箱读取，数据分析读取，机器人读取，成员读取 |
等级规则
- 非所有者只能分配严格低于自身等级的角色，并且只能更改或移除等级低于自身的成员。因此管理员可以管理操作员和查看者，但不能管理其他管理员。
- 所有者可以分配任何角色，包括
owner。所有权转移正是如此：将某个成员提升为所有者。在有人更改之前，原所有者会保留所有者角色，因此一个团队可以有多个所有者。 - 最后一位所有者不能被降级。
- 所有者不能被移除，也不能退出团队。其他所有成员都可以在“设置 > 团队”中退出。
- 可以在 Settings > Team > Manage 中重命名团队（名称旁的铅笔图标）。重命名需要
team:settings:write且角色为 owner 或 admin：owner 默认拥有该权限键，admin 需要通过覆盖单独授予。名称长度为 1 到 100 个字符。团队无法删除，其描述也无法编辑。 - 团队变更操作的速率限制为每位用户每分钟 30 次。
按成员覆盖
每位成员都带有一张从权限键到 true/false 的映射表。覆盖优先于角色默认值，因此您可以给查看者授予 inbox:reply，或从管理员那里收回 accounts:delete。打开“设置 > 团队 > 管理”，展开某位成员并使用开关即可。
您只能授予自己持有的权限。完整的键集合如下：
| 分组 | 键 |
|---|---|
| 账号 | accounts:read、accounts:write、accounts:delete |
| 任务 | tasks:read、tasks:run、tasks:write、tasks:delete |
| 收件箱 | inbox:read、inbox:reply |
| 数据分析 | analytics:read |
| 机器人 | bots:read、bots:write |
| 团队 | team:members:read、team:members:invite、team:members:remove、team:members:update、team:settings:write |
| 审计 | audit:logs:read |
| 账单 | billing:read、billing:manage |
邀请成员
- 进入“设置 > 团队 > 管理 > 邀请成员”。
- 输入队友的电子邮箱并选择一个角色（viewer、operator 或 admin）。
- 该邮箱必须属于一位已存在的 TelegramOS 用户。如果不存在，请求会失败并提示“No user with that email. They must sign up first.”
- 成员会被立即添加，并收到一条应用内通知。没有邀请邮件，没有待处理状态，无需接受，也没有任何会过期的内容。
邀请自己或已是成员的人会失败。
成员能看到什么
团队成员身份扩大了成员可操作的资源范围。您所属每个团队的账号、对话、自动回复规则、机器人、数据分析和账单视图都会与您自己的内容并列显示，并按各接口所需的权限进行过滤。没有工作区切换器；您始终看到的是一份合并后的列表。
- 只有当某个团队的所有者启用了消息数据分析时，该团队的数据分析才可见（参见数据分析）。
- 账单视图需要
billing:read；默认只有所有者拥有billing:manage。 - 您自己的账号和钱包永远不会对您所加入的团队可见。
审计日志
团队服务会为 team.create、team.rename（含新旧名称）、team.member.invite、team.member.update（含新旧角色）、team.member.remove 和 team.member.leave 写入一条仅追加的 audit_logs 记录。每条记录保存操作者的用户 id 和邮箱、所属团队、资源、结构化元数据、客户端 IP、User-Agent 以及 UTC 时间戳。
- 通过
GET /audit/logs?team_id=…读取（需要audit:logs:read，所有者和管理员默认持有）。不带team_id时返回您自己的操作。筛选参数：action、resource_type、limit（最大 200）、offset。 - 控制台中没有审计页面，也没有 CSV 导出。
- 记录永不删除或更新：数据库触发器会拒绝
UPDATE、DELETE和TRUNCATE。没有分级保留期。 - 其他服务（账号、代理、营销活动）各自保留自己的日志，不会写入此表。