安装商店版 ZAI
从飞书应用中心安装 ZAI 后，怎样把企业连接到 Z Tag 组织、成员怎样开始使用、ZAI 以飞书 Bot 身份能做什么，以及怎样停用、断开与申诉。
商店版 ZAI 是从飞书应用中心安装的 ZAI：企业安装后，把企业连接到一个 Z Tag 组织，大家就可以在飞书里使用它。由 Z Tag 管理员为组织配置的企业自建 ZAI 不走这一页，见配置飞书应用。同一个企业不要同时使用两种 ZAI，否则两个 ZAI 会各自回复。
谁来做
| 谁 | 做什么 |
|---|---|
| 飞书企业管理员 | 安装 ZAI、同意它申请的权限、设置可用范围；需要时在管理后台停用或重新启用 ZAI |
| 应用管理员 | 在管理后台审核和管理应用的管理员；在私聊里向 ZAI 获取配对码，把企业连接到组织 |
| 组织 Owner | 在控制台用配对码把企业连接到本组织，或断开连接；恢复飞书 Bot 身份 |
| 成员 | 在群里或私聊里直接使用 ZAI；可以选择连接自己的账号 |
安装
- 飞书企业管理员在飞书应用中心找到 ZAI，获取并安装，同意安装时飞书展示的权限。
- 设置可用范围：可用范围决定企业里谁能使用 ZAI，规则见谁可以使用 ZAI。
- 安装后，ZAI 会私聊安装的人一张「欢迎使用 Z Tag」卡片，上面有 获取配对码。
ZAI 申请的权限包括：读取它所在的群与私聊里的消息、读取群信息与成员的基础资料、发送和回复消息，以及在获得授权后读写云文档、电子表格、多维表格与知识库；它不能管理云空间里的文件夹和文件。具体权限以安装时飞书展示的为准。
企业连接到 Z Tag 组织之前，ZAI 还不能工作：在群里 @ 它或私聊它，只会收到「本企业还没有连接 Z Tag 组织」开头的说明。
连接组织
连接分两步：本企业的应用管理员在私聊里向 ZAI 获取配对码，组织 Owner 在 Z Tag 控制台用这个码把企业连接到组织。连接后，组织下多出这个企业的 Workspace。
- 应用管理员点欢迎卡片上的 获取配对码，或私聊 ZAI 发送
/connect，收到配对码卡片。卡片的用法、有效期和风险说明见连接 Z Tag 组织。 - 应用管理员自己点卡片上的 在控制台连接，用飞书登录控制台，可以新建组织，或连接到他担任 Owner 的组织。
- 也可以把配对码交给要连接本企业的组织 Owner，由他在控制台的 IM 接入 里粘贴连接，见用配对码连接。
一个企业只能连接一个组织；一个组织可以连接多个企业。连接完成后，获取配对码的人会在私聊里收到「本企业已连接到一个 Z Tag 组织」的通知。
成员开始使用
连接后，可用范围内的人可以直接在群里 @ZAI，或私聊它，不需要先登录控制台。
企业连接之后第一次打开与 ZAI 的私聊时，ZAI 会发来一张「欢迎使用 Z Tag」卡片，说明怎样开始，并附上 连接我的账号。连接之前已经私聊过 ZAI 的人（例如安装的人和获取配对码的应用管理员）不会再收到这张卡片；他们发送 /connect 同样能看到 连接我的账号。
连接我的账号
欢迎卡片和已连接企业里 /connect 的回复上都有 连接我的账号。点开后用飞书登录 Z Tag 控制台，你在飞书里的身份就连接到了控制台账号，之后可以在控制台管理只供自己使用的资源，见我的资源。
这一步是可选的：不连接也能照常在飞书里使用 ZAI。它和应用管理员用配对码「连接 Z Tag 组织」不是一回事，不会改变企业连接的组织。
飞书 Bot 身份
企业连接后，连接的 Z Tag 组织决定 ZAI 在这个企业里做什么：组织给 ZAI 布置任务、配置资源。ZAI 工作时会以本企业 ZAI 的 Bot 身份直接调用飞书开放平台：在获得授权后读写和分享云文档、电子表格、多维表格与知识库，权限以 ZAI 在本企业获准的为准；收发消息和读取群消息仍走 ZAI 自己的通道。这些调用不经过 ZAI 的 发送前审阅（见设置回复审阅），范围与飞书应用身份的推荐配置相同。
这就是配对码卡片上风险说明的含义：配对码相当于把 ZAI 在本企业的 Bot 权限交给对方组织，只交给你信任的人，见连接 Z Tag 组织。
- 这份身份默认对本企业的全部群生效：ZAI 在本企业任何群里执行的任务都能使用它，不论任务由哪位成员发起，能读写、删除和分享的文档不限于这个群里分享过的。它只在连接这个企业的 Workspace 里生效，不带到组织的其他企业。
- 在群的话题里，ZAI 默认用这份身份把超过约一屏的长文档建成飞书云文档，设为本企业内获得链接的人都能阅读；标明保密、仅限本群或涉及个人隐私的材料，以及私聊里的结果，仍用附件发回，见群话题里的飞书云文档。
- 组织 Owner 和 Admin 在控制台的连接器列表里，从 飞书 Bot 身份（Z Tag 签发） 查看每个企业的状态，点 打开连接器 进入这份身份所在的连接器。组织 Owner 可以在那里调整它的使用范围（见范围设置），Owner 和 Admin 可以撤销它；撤销后不会自动恢复，只有组织 Owner 能点 恢复；企业断开后重新连接时，这份身份会按默认重新开通。
- 企业要立刻停止，就在飞书管理后台停用 ZAI。
停用与断开
- 企业这一侧：飞书企业管理员在管理后台停用 ZAI 后，它在本企业停止工作，还没用掉的配对码随即失效；重新启用后，ZAI 连回原来的组织。企业这一侧不能断开与组织的连接。
- 组织这一侧：组织 Owner 在控制台断开连接，见断开与本组织的连接。断开后，在群里 @ZAI 或私聊它会收到「本企业还没有连接 Z Tag 组织」开头的说明；应用管理员可以重新获取配对码，连接到原来的组织或别的组织。
隐私政策、服务条款与申诉
商店版 ZAI 的隐私政策和服务条款在 Z Tag 官网，从官网页脚打开。
对这条连接有异议，例如配对码被他人兑换、企业被连接到陌生的组织时，按《服务条款》「联系我们」里的方式申诉；已连接企业里 /connect 的回复也写明了申诉方式。
- 申诉处理前请保持 ZAI 停用：重新启用会连回原来的组织。核实身份所需的材料会在回复邮件里说明，不需要重新启用 ZAI。
- 申诉经核实后，处理方式是断开连接。断开时为个人提醒保存的消息正文随即删除；连接期间产生的其他消息记录、任务记录、记忆与交付物留在当时连接的组织，申诉不能取回或删除。
常见问题
| 如果你看到 | 这表示 | 这样做 |
|---|---|---|
| 「只有本企业的应用管理员可以获取配对码。」 | 发送 /connect 的人不是本企业的应用管理员 | 请应用管理员获取配对码 |
| 「配对码只会私聊发给应用管理员，请私聊我发送 /connect。」 | 在群里发送了 /connect | 应用管理员改在与 ZAI 的私聊里发送 |
| 「获取配对码太频繁了。」开头的回复 | 短时间内获取配对码的次数过多，此前发出的配对码已全部失效 | 按回复里的时间后再获取 |
| 「本企业还没有连接 Z Tag 组织」开头的说明 | 企业还没有连接组织，或连接已被断开 | 请应用管理员获取配对码完成连接，见连接组织 |
| 登录控制台时看到 本企业还没有连接 Z Tag 组织 | 企业还没有连接组织，或连接已被断开 | 请应用管理员在私聊里向 ZAI 发送 /connect 完成连接，见连接组织；你就是拿到配对码的应用管理员时，点页面上的 连接组织，粘贴配对码继续 |
| 在控制台兑换配对码时提示 这个企业已经连接到另一个 Z Tag 组织 | 一个企业只能连接一个组织 | 须先由那个组织的 Owner 断开 |
| 点 在控制台连接 后，页面要求填写 配对码 | 打开页面时没有带上配对码 | 从配对码卡片复制配对码，粘贴后点 继续 |
| 点 连接我的账号 后看到 登录未完成 | 这个组织暂时还不能为你完成登录 | 先在私聊里给 ZAI 发一条消息，再点 连接我的账号；仍然不行时联系组织 Owner |
| 收到「本企业已连接到一个 Z Tag 组织」的通知，但不是你预期的组织 | 有人兑换了本企业的配对码 | 在管理后台停用 ZAI，再按申诉的方式申诉 |
| 同一个群里有两个 ZAI 都在回复 | 企业同时用了商店版 ZAI 和企业自建的 ZAI | 只保留一种，停用另一个 |
| 可用范围外的人 @ZAI 没有反应 | 可用范围决定谁能使用 ZAI | 请飞书企业管理员调整可用范围，见谁可以使用 ZAI |