客服电话：13904310313 一、功能简介
飞书机器人助手（BotBuilder）是一个可视化的机器人应用搭建工具，可以帮助用户在没有代码基础的情况下快速搭建机器人应用，并根据自己的需要配置发送消息的流程。飞书机器人助手支持联动飞书套件内的其他功能，从而实现企业日常工作的自动化。
二、操作流程
- 管理应用
创建应用
从空白创建应用
进入飞书机器人助手首页后，点击 + 新建应用 按钮，即可创建一个新的机器人应用。
创建应用时，需配置以下内容：
- 应用名称：机器人应用的名称
- 应用描述：展示在机器人应用名称下方的描述信息
- 应用图标：机器人应用的图标，支持选择默认图标和自定义图标
从模板创建应用
首页的 模板 板块中提供了多个场景的模板。点击相应模板的 立即创建 按钮，即可通过模板快速创建一个应用。创建应用后，用户可根据企业的具体场景修改模板中的配置。
编辑应用信息
在 应用管理 页面中，点击 编辑 按钮，即可编辑应用的名称、描述、图标等基础信息。
转移应用所有权
主动转移
在 应用管理 页面中，点击 转移应用所有权 按钮。
搜索成员姓名或邮箱，点击 确认转移 即可完成应用所有权的转移。转移成功后，之前的应用所有者自动成为普通的应用管理员。
自动转移
应用所有者离职后，应用所有权将默认转移给其直属上级。企业管理员也可以手动指定将应用的所有权转移给谁。
删除应用
在 应用管理 页面中，点击 删除应用 按钮。二次确认后，即可完成删除操作。仅应用所有者可以删除应用（每个应用仅 1 个所有者，默认为应用创建者），应用内其他管理者都无法删除应用。
此外，只有未发布或已停用的应用才能被删除。应用如未被停用，需先联系管理员停用此应用。
应用被删除后，在飞书机器人助手平台、管理后台或飞书上均不可见。
- 流程设计
流程设计可以帮助用户根据自己的需要快速配置相关流程，比如定时发送消息、数据变动通知、新人入群提醒等。流程设计需要包含至少 1 个触发器 和 1 个行动节点。在设计流程时，请确保保证流程完整、可用。
创建流程
在 流程设计 页面，点击 创建流程 按钮，即可进入流程设计页。
选择触发器
流程设计中首先需要设置触发节点，目前系统支持 4 种触发器，包括：定时任务、工作表变化、用户进群 和 新员工入职。
配置操作
逻辑节点
逻辑节点用于筛选和查找数据，不可以成为工作流的结束节点。目前系统支持创建 2 种逻辑节点，分别是 筛选 和 查找。
行动节点
行动节点指的是满足某一触发时机后相应的操作行为。目前系统支持 5 种行动节点，包括 填写表单、发送消息、新增记录、修改记录 和 删除记录。
- 页面设计
页面是面向终端用户的前台输入界面，用于收集企业成员的相关信息和反馈。
新增问题
进入 页面设计 页面，点击页面底部的 新增问题，即可添加新的问题。默认的问题类型是文本，可以按需修改问题类型为日期、成员等。
问题类型是指该问题下提交的信息类型。比如选定日期 类型，则该问题下用户只能选择某个日期进行提交。
问题设置
点击页面上的问题可以进行问题属性的设置，目前可以进行以下的问题设置：
- 选择问题类型
- 选择问题是否必填
- 删除问题
- 通过拖动来修改问题的位置
注：一个页面默认至少应包含一个问题。包含多个问题时，第一个问题可以修改，但无法删除。
页面设置
在页面右侧，可以进行页面相关的设置，可配置的设置项如下：
- 允许成员多次提交
- 点击选中后，该页面允许同一个成员多次提交
- 定时提醒成员填写
- 设置后，接收者会在对应的时间收到消息通知，提醒该接收者去填写信息
- 有人提交时发送提醒
- 设置后，有人填写信息并提交后，接收人会收到消息通知
- 数据管理
数据管理 页面是应用里的数据中心，用于存储和管理应用内的相关数据。数据管理里会包含所有跟该应用相关的数据。每个页面都会有一个对应的数据表格，里面包含页面上所有问题对应的字段，通过该页面提交的数据记录都会记录和展现在该数据表格里。
新增字段
字段是数据表格的列。点击数据表表头最右侧的 + 按钮，即可新增字段。
支持设置字段名称和字段类型，并可以设置是否在页面上同步新增该字段。
注：
- 只有拥有数据编辑权限的用户才可以输入和修改记录，该权限可以在 权限设置 中设置；
- 修改字段类型后，不符合字段类型的记录值会出现格式变化或被置空；
- 不支持新增和修改某个单元格的记录值，新增和修改数据必须对整条记录进行操作。
- 权限设置
权限设置支持自定义设置不同成员的 应用设计 和 数据编辑 权限。
角色管理
系统会自动创建应用管理员角色（应用创建者默认为应用管理员）。该角色拥有全部操作权限，且不可修改。
点击右侧的 新增角色 按钮，即可新增用户的协作者角色。
新增角色时，可以设置该角色的应用设计权限和数据相关权限。数据权限支持设置单张工作表的只读或编辑权限；仅有应用设计权限的角色成员只能在工作表看到字段设置，无法看到具体的数据。
成员管理
每个角色下均可增删成员。如果新增成员在应用可用范围之外，则需要经过审核；待审核成功后，才能进入应用后台。有关应用可用范围的相关介绍，请参考本文下方的描述。
注：管理员角色下需至少有一名成员。
- 发布应用
在飞书机器人助手上创建的机器人应用，本质上是飞书上的自建应用。和其他自建应用一样，机器人应用的可用范围和权限需要经过企业管理员审核。
进入 应用发布 页面后，可看到系统已根据当前配置自动添加所需权限，并提示需要审核的权限，也已根据当前配置自动添加可用范围内的成员（如添加群后自动将群成员加入可用范围）。申请理由为选填项，填写后企业管理员可见。点击 发布 按钮后，如本次发布内容无需审核，应用将自动发布；如果需要审核，应用将在企业管理员通过审核后发布。
应用权限
应用权限是指应用配置过程中调用的相关能力权限，比如配置新人入职流程时，需要获取企业的组织架构权限。为了降低开发者操作的难度，在应用配置过程中，系统会帮助用户自动添加权限、可用范围。
可用范围
应用的可用范围是指哪些用户可以使用该应用，在可用范围内的用户可以进行以下操作：
- 查看和搜索该应用
- 收到该应用发送的相关消息
应用创建者可以配置可用范围，建议尽量将所有需要查看应用的部门和个人都列入可用范围。如果应用配置需要扩大可用范围，系统会自动将相关用户添加至可用范围内并提交审核。比如，当流程中添加了发送消息的接收者或权限设置中添加了新成员时。
对大部分企业来说，应用可用范围的扩大都需要企业管理员的审核。审核通过后，应用才可以按照配置项正常使用。
应用审核
应用审核指当应用的可用范围或权限发生变更，触发所属企业的应用审核规则时，用户修改应用内容后，需对修改集中发布。
此外，应用权限和可用范围支持编辑。推荐开启的权限默认打开，用户可手动关闭，可选权限默认关闭，用户可手动打开。
可用范围支持添加部门、搜索人员。
应用发布申请提交后，如需审核，其状态将改为“应用审核中”。免审权限将直接通过，需审核权限标记待审核。你也可以点击下方的 撤销发布 按钮，撤回发布申请。
三、常见问题
- 配置流程后没有收到消息，该如何排查？
保存相关问题
首先，你可以确认下保存流程的时候是否报错。如果报错，请参考问题 3。
发布相关问题
第 1 步：确认应用是否已发布成功。
第 2 步：检查流程的可用范围是否包含了需要接收信息的人。
流程配置相关问题
第 1 步：如果消息内容中添加了超链接，请确认超链接的格式，其中不可包含空格等异常字符。
第 2 步：如果设置了定时触发，请检查触发时间是否 和工作流配置时间过于接近。
第 3 步：如果消息中配置了给群组发消息，并且使用了“@所有人”功能，请确认群组设置。如果群组开启了“仅群主和群管理员可@所有人”，那么也会导致发送不成功。
“查找节点”相关问题
第 1 步：如果查找条件是日期（今天、明天、昨天），请确认数据表字段的日期类型是否为 mm-dd，只有 mm-dd 的日期类型查找时才会忽略年份。
第 2 步：如果想查找全部数据，请确认选择字段是否为空。只有为空时才会查找所有数据，填的话会视为“匹配指定字段为空”。
- 为什么会多次收到消息？
请确认发送消息节点前是否有查找节点。查找节点查找 N 条数据，后面的节点会触发 N 次。
- 保存应用时，为什么会失败？
第 1 步：首先请尝试刷新页面，确认是否有多人协同编辑。飞书机器人助手不支持多人协同编辑，如果其他人编辑了应用，当前用户便会保存失败。
第 2 步：如果是流程保存失败，请确认消息节点或者新人入群触发器是否有选择群组。如果选择了群组，请确认：
a. 选择的群组中是否有外部群（外部群不支持拉机器人进群）
b. 群组是否设置了只有群主可以拉人，而应用操作者不是群主
第 3 步：请确认你是否是应用管理员，不是管理员的话，就无法编辑应用。
注：如果看不到 “权限设置”，同样表示没有权限。
如果你没有权限，可联系应用创建者为你添加管理员权限。企业管理员可前往 飞书管理后台 > 工作台 > 应用管理，查看应用的创建者。
