查看 IM 接入
在控制台查看本组织每个 Workspace 绑定的 IM 应用、安装与连接状态，以及它从组织继承的配置；商店版 ZAI 的企业在这里用配对码连接与断开。
组织 Owner 和 Admin 在 组织管理 → IM 接入 查看本组织接入 IM 的每个 Workspace，以及 Z Tag 与它的 IM 应用之间的连接状态。每个 Workspace 对应一个飞书企业里的一个 ZAI 应用，一个组织可以有多个 Workspace，见一个组织接入多个 IM。
谁可以做：组织 Owner 和 Admin 可以查看；用配对码连接和断开只有组织 Owner 可以；我的资源 里没有这一页。
自建应用的行标注 自建应用 · 由 Z Tag 管理员配置：这些 IM 应用由 Z Tag 管理员配置，控制台只能查看，不能绑定、修改或删除。IM 平台上的应用怎样配置，见应用配置。商店版 ZAI（从飞书应用中心安装的 ZAI）的行标注 商店应用，它所在的企业由组织 Owner 用配对码连接到本组织，也可以在这里断开，见用配对码连接与断开与本组织的连接。
页头的 用配对码连接 只接受商店版 ZAI 的配对码；组织只用自建应用时用不到它。
列表
每一行是一个 Workspace，列出平台、应用 ID、安装 状态与 连接状态，以及状态的上报时间。没有关联飞书企业的 Workspace 不出现在这里。点击 Workspace 名称打开它的详情。
安装状态
自建飞书应用的安装状态是 已安装。自建应用被停用、App Secret 被重置时，安装状态不变，问题显示在连接状态的 被平台拒绝 和它的原因里，处理见常见故障。
这个 Workspace 关联着飞书企业、但当前没有生效的 IM 应用时，显示 未安装，这一行只写平台：商店应用断开后，请该企业的应用管理员重新获取配对码连接；自建应用需要恢复时，请 Z Tag 管理员登记应用。
商店版 ZAI 在企业里停用后，安装状态显示 已停用，下方写明原因：
| 原因 | 表示什么 | 怎么恢复 |
|---|---|---|
| 企业已停用应用 | 这个企业的管理员在飞书管理后台停用了 ZAI | 企业重新启用 ZAI 后自动恢复 |
| 飞书平台已停用应用 | 飞书平台停用了 ZAI，它已停止在这个企业工作 | 请联系 Z Tag 管理员 |
| 企业已解散 | 这个飞书企业已解散 | — |
已停用 下方没有原因时，是飞书拒绝了 ZAI 在这个企业的调用；Z Tag 会自动重新核对，确认可用后恢复。
连接状态
| 连接状态 | 表示什么 | 怎么处理 |
|---|---|---|
| 已连接 | Z Tag 正常接收这个应用的消息 | — |
| 部分连接异常 | Z Tag 与这个应用的部分连接中断，消息仍由其余连接接收 | 持续出现请联系 Z Tag 管理员 |
| 被平台拒绝 | IM 平台拒绝了这个应用，状态下方显示原因 | 原因可能是 应用已被停用或卸载、应用凭证被拒绝、接口调用额度已用尽 或 事件连接被拒绝，各自的处理见常见故障 |
| 正在重试连接 | 连接失败，Z Tag 正在自动重试 | 几分钟后仍未恢复时，请联系 Z Tag 管理员 |
| 暂无状态 | 没有收到这个应用的连接状态，通常是 Z Tag 的接收服务没有运行或正在重启 | 持续出现请联系 Z Tag 管理员 |
| 连接状态 | 表示什么 | 怎么处理 |
|---|---|---|
| 等待平台凭证 | 这个应用正在等待飞书下发首张凭证，收到后自动连接 | 无需处理；长时间不变时请联系 Z Tag 管理员 |
飞书企业当月的接口调用额度用完后，连接通常仍是 已连接，状态下方显示 接口调用额度已用尽：ZAI 照常收消息，但回复可能失败；这个企业里的主动协助、免确认介入和 Dream 暂停，见后台能力的暂停。下个月额度恢复、ZAI 的调用重新成功后，这行提示自动消失。需要马上恢复时，请飞书企业管理员升级飞书版本：升级后回复马上恢复，后台能力和这行提示仍要等到下个月，想提前恢复请在升级后联系 Z Tag 管理员。
Z Tag 同时用多条连接接收同一个应用时，状态旁会显示其中正常的条数，例如 2 / 3 个连接正常。
详情
点击 Workspace 名称打开详情：
- 外部租户：标签是 飞书企业，显示的是企业的租户标识（tenant key，一串字符，不是企业名）。
- 应用类型：商店应用 或 自建应用。商店应用另列 企业名称。
- 应用 ID、安装时间 和 最近变更。
- 接收方式：长连接 或 HTTP 回调。长连接对应飞书开放平台的“使用长连接接收事件”，HTTP 回调对应“将事件发送至开发者服务器”。
从组织继承
详情还列出这个 Workspace 与组织内其他 Workspace 共享的配置：
- 整个组织的资源：使用范围包含整个组织的资源，对这个 Workspace 的每个 Channel 生效。
- 全体成员授权：对每位成员与 ZAI 的私聊生效，也包括这个 Workspace 的成员。
- 模型路由：Engine / Model 与 模型上游 的生效值和来源。
点开这一块的链接，会打开 范围设置 的对应分区，再在左栏选择这个 Workspace 查看。不想让某个 Workspace 继承的资源，请改为授权给具体的 Workspace、Channel 或成员，见范围设置；模型路由见配置模型路由与回复审阅。
用配对码连接
商店版 ZAI 装进企业后，本企业的应用管理员在私聊里向 ZAI 发送 /connect 获取配对码，见连接 Z Tag 组织。应用管理员点配对码卡片上的 在控制台连接 可以新建组织或连接到他担任 Owner 的组织；配对码交给你时，在这里连接：
- 在 IM 接入 页点 用配对码连接，粘贴配对码，点 查看。
- 核对企业名、获取配对码的人和剩余时间。配对码 15 分钟内有效，只能使用一次。
- 确认数据共享范围：连接后，这个企业里能使用 ZAI 的人都可以直接使用它，并与本组织共享成员、每位成员在组织内通用的记忆，以及授权给整个组织和全体成员的资源；这个企业的群及其记忆只属于它自己的 Workspace。
- 点 连接到本组织。列表里多出这个企业的 Workspace，获取配对码的人会在私聊里收到「本企业已连接到一个 Z Tag 组织」的通知。
谁可以做：只有组织 Owner；Admin 看到的 用配对码连接 不可点，并提示 需要 Owner 角色。
配对码不能使用时（码不对、已过期、已被新码替换或已经用过），请应用管理员重新获取。一个企业只能连接一个组织：已经连接到其他组织的企业，须先由那个组织的 Owner 断开。本组织已经通过另一开发者的应用接入这个企业时，也不能连接。
断开与本组织的连接
在商店应用的 Workspace 详情页头点 更多 → 断开与本组织的连接，输入企业名称确认后断开：
- ZAI 立即停止在这个企业工作：进行中的任务取消，待发的消息不再发出；获取配对码的人会收到「本企业与 Z Tag 组织的连接已断开」的通知。
- Channel、记忆与历史留在本组织，为后台个人提醒保存的最近 7 天消息正文随即删除；经这个企业加入的成员仍是本组织成员；控制台不能移除成员，需要时请联系 Z Tag 管理员。
- 这个 Workspace 仍在列表里，显示 未安装。要重新连接，请该企业的应用管理员重新获取配对码；连接回本组织时沿用原来的 Workspace。
谁可以做：只有组织 Owner；Admin 打开 更多 时这一项不可点，并写明 需要 Owner 角色。企业这一侧不能断开连接。