安装商店版 ZAI
从 Z Tag 提供的安装链接把 ZAI 装进 Slack 工作区后，怎样连接到 Z Tag 组织、成员怎样开始使用，以及卸载、重装与断开。
商店版 ZAI 是从 Z Tag 提供的安装链接装进 Slack 工作区的 ZAI：工作区安装后，把工作区连接到一个 Z Tag 组织，大家就可以在 Slack 里使用它。它没有在 Slack Marketplace 上架。由 Z Tag 管理员为组织配置的 Slack 自建应用不走这一页，见配置 Slack 应用。同一个工作区不要同时使用两种 ZAI，否则两个 ZAI 会各自回复。
谁来做
| 谁 | 做什么 |
|---|---|
| Slack 工作区管理员 | 工作区的管理员、所有者和主所有者：安装 ZAI 或批准安装；在私信里向 ZAI 获取配对码，把工作区连接到组织；需要时从工作区移除它 |
| 组织 Owner | 在控制台用配对码把工作区连接到本组织，或断开连接 |
| 成员 | 在 ZAI 所在的频道里 @ 它，或私信它；可以选择连接自己的账号；工作区允许时，也可以安装 ZAI |
安装
- 打开 Z Tag 提供的安装链接，在 Slack 的授权页选择要安装的工作区，同意 ZAI 申请的权限。ZAI 只能装进单个工作区，不能装进整个 Enterprise Grid 组织。
- 安装成功后，浏览器打开 Z Tag 官网的「ZAI 已装进工作区」页面，点 打开 Slack 进入 ZAI 的应用页面。工作区还没有连接组织时，安装的人会在 消息 标签页收到一条「感谢安装 Z Tag。」开头的私信，提示工作区管理员发送
!connect获取配对码；每个工作区只发一次，重新安装不再发。
工作区开启了应用审批时，不是工作区管理员的人发起的安装，要先由工作区管理员在 Slack 里批准 ZAI；批准后，再由发起安装的人从安装链接安装。
ZAI 能读取什么见应用能读取什么；它不申请加入公开频道的权限。具体权限以安装时 Slack 授权页显示的为准。
工作区连接到 Z Tag 组织之前，ZAI 还不能工作：在频道里 @ 它或私信它，只会在消息列里收到「本工作区还没有连接 Z Tag 组织」开头的说明，与其他组织或其他工作区共享的频道里不回复；成员第一次打开 消息 标签页时也会收到这句说明。说明里提到的 !connect 只有工作区管理员能用。
连接组织
连接分两步：本工作区的工作区管理员在私信里向 ZAI 获取配对码，组织 Owner 在 Z Tag 控制台用这个码把工作区连接到组织。连接后，组织下多出这个工作区的 Workspace（控制台里的一层范围，见你会看到的词）。
- 工作区管理员在私信里发送
!connect，收到「连接 Z Tag 组织」配对码消息；在频道里发送@zai !connect时，配对码同样私信发给他。消息的用法、有效期和风险说明见连接 Z Tag 组织。 - 工作区管理员自己点消息上的 在控制台连接，用 Slack 登录控制台（在 Slack 授权页选择本工作区），可以新建一个以工作区名命名、由他担任 Owner 的组织；只有获取配对码的人能用这个码新建组织。要连接到他已担任 Owner 的组织，先在同一个浏览器里从那个组织的 IM 入口登录控制台，再点 在控制台连接。
- 也可以把配对码交给要连接本工作区的组织 Owner，由他在控制台的 IM 接入 里粘贴连接，见用配对码连接。
一个工作区只能连接一个组织；一个组织可以连接多个工作区。连接完成后，获取配对码的人会在私信里收到「本工作区已连接到一个 Z Tag 组织」的通知，工作区里之后的消息由 ZAI 照常处理。新建组织后，按组织上线清单从第 3 步继续。
成员开始使用
连接后，除访客外的工作区成员可以在 ZAI 所在的频道里 @zai，或私信它，不需要先登录控制台。ZAI 不会自行加入频道：在频道里发送 /invite @zai，或在频道详情里添加 Z Tag 应用，见邀请 ZAI 进频道。与其他组织共享的频道（Slack Connect），以及同一个 Enterprise Grid 组织里多个工作区共享的频道里，商店版 ZAI 不回复，也不发说明。谁能使用、访客与 Slack Connect 频道的其他规则见Slack 工作区管理员须知。
工作区连接之后，成员第一次打开 消息 标签页时，ZAI 发来一条欢迎私信，说明怎样开始，并附上 连接我的账号。没有收到欢迎的人在私信里发送 !connect（频道里 @zai !connect，回复只有自己看得到），同样能看到 连接我的账号。
连接我的账号
欢迎私信和已连接工作区里 !connect 的回复里都有 连接我的账号。点开后用 Slack 登录 Z Tag 控制台（在 Slack 授权页选择本工作区），你在 Slack 里的身份就连接到了控制台账号，之后可以在控制台管理只供自己使用的资源，见我的资源。访客和已停用的账号不能登录。
这一步是可选的：不连接也能照常在 Slack 里使用 ZAI。连接我的账号 与发送 !organization 后从回复里打开控制台是同一个入口，效果相同；它和工作区管理员用配对码「连接 Z Tag 组织」不是一回事，不会改变工作区连接的组织。
读取历史较慢
Slack 限制在 Slack Marketplace 之外分发的应用读取频道和消息列历史的频率，商店版 ZAI 也受这个限制：
- ZAI 读较长的频道历史时，常常只看到最新的一段；翻页和搜索会分几次返回。
- 主动协助和免确认介入要读的消息较多时，这一轮分析可能不会完成。
- 私信里的编辑和表情回复，ZAI 可能晚几分钟才看到。
需要 ZAI 参考较早的内容时，把要点直接发给它。
卸载、重装与断开
- 工作区这一侧：工作区管理员从工作区移除 ZAI 后，它几秒内停止在本工作区工作：进行中的任务停止，还没用掉的配对码失效，工作区成员也不能再经它登录控制台。与组织的连接仍然保留，不会发出断开通知；工作区这一侧不能断开与组织的连接。
- 重新安装：从 Z Tag 的安装链接重新安装后，ZAI 连回原来的组织，不再发安装欢迎；它不在原来的频道里，要重新邀请进去，见邀请 ZAI 进频道。卸载期间各项功能的变化见ZAI 被移出频道时。
- 组织这一侧：组织 Owner 在控制台断开连接，见断开与本组织的连接。断开后，获取配对码的人收到「本工作区与 Z Tag 组织的连接已断开」的通知；在频道里 @zai 或私信它会收到「本工作区还没有连接 Z Tag 组织」开头的说明；工作区管理员可以重新获取配对码，连接到原来的组织或别的组织。
常见问题
| 如果你看到 | 这表示 | 这样做 |
|---|---|---|
| 安装时看到 安装未完成，说明以「Slack 没有授权这次安装」开头 | 安装被取消了，或者工作区要求工作区管理员先批准应用 | 重新安装；需要批准时，请工作区管理员批准 ZAI 后再从安装链接安装 |
| 安装时看到 安装未完成，说明以「安装等待的时间过长」开头 | 在 Slack 授权页停留太久，或在其他页面重新发起了安装 | 从安装链接重新安装 |
| 安装时看到「Z Tag 只能安装到单个工作区」开头的说明 | 在 Enterprise Grid 里选择了装进整个组织 | 重新安装，并选择一个工作区 |
| 「只有本工作区的工作区管理员可以获取配对码。」 | 发送 !connect 的人不是本工作区的工作区管理员 | 请工作区管理员获取配对码；刚成为工作区管理员的人，过几分钟再试 |
在频道里发送 @zai !connect 后，看到只有自己看得到的「已私信回复你，请在私信里查看。」 | 配对码或说明已经私信发给你 | 打开与 ZAI 的私信查看 |
| 「获取配对码太频繁了。」开头的回复 | 短时间内获取配对码的次数过多，此前发出的配对码已全部失效 | 按回复里的时间后再获取 |
| 「暂时无法获取配对码，请稍后重试。」开头的回复 | ZAI 这时没能确认你能否获取配对码 | 稍后重新发送 !connect |
| 「本工作区还没有连接 Z Tag 组织」开头的说明 | 工作区还没有连接组织，或连接已被断开 | 请工作区管理员获取配对码完成连接，见连接组织 |
| 登录控制台时看到 本工作区还没有连接 Z Tag 组织 | 工作区还没有连接组织，或连接已被断开 | 请工作区管理员在私信里向 ZAI 发送 !connect 完成连接，见连接组织；你就是拿到配对码的工作区管理员时，点页面上的 连接组织，粘贴配对码继续 |
| 登录控制台时看到 这个 Slack 应用属于其他工作区 | 在 Slack 授权页选择的工作区没有安装 ZAI | 重新打开链接，在授权页选择本工作区 |
| 在控制台兑换配对码时提示 这个工作区已经连接到另一个 Z Tag 组织 | 一个工作区只能连接一个组织 | 须先由那个组织的 Owner 断开 |
| 兑换配对码时提示 这个工作区卸载了应用或撤销了它的凭证 | ZAI 已从工作区移除 | 重新安装后，请工作区管理员重新获取配对码 |
| 点 在控制台连接 后，页面要求填写 配对码 | 打开页面时没有带上配对码 | 从配对码消息复制配对码，粘贴后点 继续 |
| 收到「本工作区已连接到一个 Z Tag 组织」的通知，但不是你预期的组织 | 有人兑换了本工作区的配对码 | 立即从工作区移除 ZAI，重新安装会连回这个组织；通知里写有申诉方式时，按它申诉 |
| 重新安装后，控制台的 IM 接入 仍显示 已停用 | 少数情况下，重新安装后 ZAI 在工作区里的身份变了 | 请组织 Owner 断开连接，再由工作区管理员重新获取配对码连接 |
| 同一个频道里有两个 ZAI 都在回复 | 工作区同时用了商店版 ZAI 和 Z Tag 管理员配置的自建应用 | 只保留一种，从工作区移除另一个 |