主题订阅模块
微语主题订阅模块，可以理解为一套“消息分发规则中心”。
它的作用不是单纯再发一条消息，而是先定义“哪一类消息属于哪个主题”，再决定“谁应该收到、谁可以监控、谁可以介入处理”。这样一来，企业在客服、协同、通知和运营场景里，就能把消息触达做得更清晰、更可控。
对于非技术人员来说，不必把 Topic 理解成代码概念。更简单地说，Topic 就是一种“消息频道标签”或“业务通道名称”。只要某个用户订阅了这个主题，就代表他有资格接收或处理这条通道里的消息。
这个模块解决什么问题
很多企业在消息协同上会遇到几个典型问题：
- 同一类消息不知道该发给谁，容易遗漏。
- 主管想旁观、介入或接管服务会话时，缺少标准入口。
- 平台级、组织级、客服级消息混在一起，权限边界不清楚。
- 新增业务场景后，很难快速把“消息场景”和“接收对象”匹配起来。
主题订阅模块的价值，就是把这些问题变成一套统一配置：
- 先定义消息属于哪个主题。
- 再决定主题属于哪个层级。
- 最后把订阅关系配置给具体用户。
这样，微语就能根据主题，把正确的消息送到正确的人手里。
哪些场景会用到主题订阅
- 客服会话分发：把工作组、坐席或统一接入口相关消息送给对应人员。
- 会话监控：主管订阅监控类主题，实时查看服务现场。
- 强插与接管：当投诉升级、风险事件或高优先级客户出现时，授权人员可以直接介入。
- 组织内部协同：把组织、成员、部门、群组等业务消息按主题路由给对应人员。
- 平台统一能力：如系统通知、文件助手、剪贴板助手等平台级消息场景。
在微语里，主题大致分为三层
1. 平台级主题
平台级主题适合“全平台统一能力”场景。它更像平台内置的标准消息通道，常见包括：
user/{user_uid}：用户默认订阅主题。file/{user_uid}：文件助手相关主题。system/{user_uid}：系统通知相关主题。group/{group_uid}：群组会话主题。private/{self_user_uid}/{other_user_uid}：用户私聊主题。
如果你把微语理解成一个统一消息底座，这一层就是平台通用能力所在。
2. 组织级主题
组织级主题适合企业内部协作与组织结构相关场景，强调“这条消息属于哪个组织、成员或业务单元”。常见包括：
org/{org_uid}：组织级默认主题。org/member/{member_uid}：成员级主题。org/department/{department_uid}：部门主题。org/group/{group_uid}：组织内群组主题。org/robot/{robot_uid}/{visitor_uid}：组织机器人会话主题。
这一层最适合企业内部管理、部门协同和组织化运营。
3. 客服与工单主题
这是最贴近客服业务的一层，主要用于接待、监控、接管、排队和工单流转。常见包括：
org/agent/{agent_uid}：坐席默认主题。org/agent/{agent_uid}/{visitor_uid}：一对一客服会话主题。org/workgroup/{workgroup_uid}：工作组默认主题。org/workgroup/{workgroup_uid}/{visitor_uid}： 工作组客服会话主题。org/unified/{unified_uid}/{visitor_uid}：统一客服入口主题。org/queue/{uid}：排队相关主题。org/ticket/department/{department_uid}/{ticket_uid}：部门工单主题。org/ticket/workgroup/{workgroup_uid}/{ticket_uid}：工作组工单主题。org/ticket/org/{org_uid}/{ticket_uid}：组织级工单主题。
如果你的重点是客服管理、服务质检、会话升级或工单协同，这一层就是最常见的使用区域。
主题订阅里的“订阅类型”是什么意思
主题订阅不仅决定“收到什么消息”，还决定“以什么方式参与这类消息”。当前模块内置 4 类订阅类型：
- CHAT：订阅聊天消息。适合正常接收和处理会话消息。
- MONITOR：订阅监控消息。适合主管、质检或培训场景下的只看或观察。
- TAKEOVER：订阅接管消息。适合需要把会话正式交由某人处理的场景。
- INSERT：订阅强插消息。适合管理者临时加入会话、协助当前接待人员的场景。
从管理视角看，可以把这 4 种类型理解为“普通处理、监督观察、正式接手、临时介入”四种不同权限动作。
主题订阅里的“层级”是什么意思
除了订阅类型，主题订阅还区分配置归属层级。当前管理后台主要使用两种：
- PLATFORM：平台级。适合超级管理员配置全平台统一规则。
- ORGANIZATION：组织级。适合企业管理员配置本组织内部规则。
这意味着，同样是一个主题订阅规则，不同层级看到的人、管理的人、影响范围都不一样。
谁会使用这个模块
主题订阅模块并不是面向所有员工日常操作的入口，它更适合以下角色：
- 平台超级管理员：负责平台统一消息规则与平台级订阅配置。
- 企业管理员：负责本组织的消息分发、会话协同与角色授权。
- 客服主管/质检负责人：负责监控、强插、接管等服务管理动作。
- 运营负责人：负责把新业务场景映射到合适的消息主题与接收对象。
换句话说，这个模块更偏“管理配置”，而不是“普通员工使用功能”。
一个典型使用流程
以“客服主管需要监控重点工作组会话”为例：
- 管理员先确定要使用的主题，例如工作组会话主题。
- 选择订阅类型为 MONITOR。
- 选择订阅层级，例如 ORGANIZATION。
- 把这个订阅关系绑定给具体主管账号。
- 当相关主题下出现会话或消息时，主管就能进入监控视角查看现场。
- 如需进一步介入，可再配置 TAKEOVER 或 INSERT 类型能力。
同样的思路，也可以扩展到工单、统一入口、组织协同消息等场景。
对企业的实际价值
1. 消息分发更清楚
企业不需要靠“人工记住谁该看什么消息”来维持流程，而是把规则提前固化到主题订阅中。
2. 服务管理更标准
监控、强插、接管这些管理动作，都可以通过订阅关系来落地，减少临时授权和人工协调。
3. 平台与组织边界更明确
平台级规则和组织级规则分开配置，更适合 SaaS 模式、多组织运营和权限隔离。
4. 新业务接入更容易复制
当新增一个业务场景时，只要定义好主题并配置订阅对象，就能快速进入既有分发体系，而不用每次重做一套消息机制。
总结
微语主题订阅模块，本质上是把“消息要发到哪里、谁能看到、谁能介入”这件事，做成一套标准化配置能力。
它特别适合客服管理、组织协同、平台通知和复杂消息路由场景。对于希望把服务流程、管理权限和消息触达统一起来的企业来说，这是微语里一项很底层、但很关键的能力模块。