功能描述
本插件支持用户通过与机器人对话，快捷创建飞书项目工单。
250px|700px|reset
使用场景
- ITR 问题管理场景
- 日常业务沟通群快速记录需求、Bug
飞书应用配置
首先需要创建（或使用存在的）飞书企业应用进行配置
250px|700px|reset
创建一个应用
250px|700px|reset
查看App ID、App Secret
250px|700px|reset
配置事件与回调
安装插件
250px|700px|reset
事件回调、获取Verification Token
- 在飞书项目插件配置里复制webhook地址
250px|700px|reset
- 配置飞书应用事件订阅与回调。此处不需要生成Encrypt Key，开启会导致验证失败。
250px|700px|reset
添加事件
250px|700px|reset
机器人权限开通
配置的飞书机器人需要至少开通以下权限
添加一个机器人
250px|700px|reset
250px|700px|reset
250px|700px|reset
应用发布
应用发布时，是否需要审核及审核流程由飞书企业管理员进行管理配置
250px|700px|reset
插件配置
250px|700px|reset
飞书机器人配置可参考上面获取指南
250px|700px|reset
工单配置
工作项及模板配置：当用户与机器人对话时，将自动创建配置的工作项实例
提交人存储字段：用于存储与机器人对话的机器人的员工信息（仅可选单行文本类型字段），由于开放能力技术限制，目前并不能将建单人直接设置为工作项角色人员。插件提供了“建单人”控件，使用该控件可以快速调起与建单人的飞书对话
250px|700px|reset
User Key：userkey是飞书项目对于人员的唯一标识，插件里用于调用飞书项目的openapi，该人员信息会被记录在工作项创建者字段及操作记录内。如配置张三的userkey，则通过该机器人创建的工作项创建者会显示为张三，操作记录显示为张三(From plugin-快捷建单)
250px|700px|reset
飞书机器人配置
配置信息来源于第一步飞书应用配置里
操作配置
目前支持配置是否自动回复消息
功能使用
- 打开飞书APP，找到机器人
250px|700px|reset
建议开启自动回复，配置方式如下：
250px|700px|reset
自动建群功能
250px|700px|reset
250px|700px|reset
- 创建工单
建单后将自动给与机器人对话的提单人发送工单链接信息。
250px|700px|reset
FAQ
- 是否支持富文本类型的消息？
- 目前仅支持纯文本类型的消息，富文本（如消息里贴了图片）类型的消息目前无法识别
- 建单人是否可以设置为工单创建者？
- 暂不支持
- 可否进行跨租户的提单？
- 暂不支持
- 通过机器人新建的工作项是否会校验必填
- 不会，目前通过openapi新建工作项不会校验必填表单
- 没有空间访问权限的人员是否能用机器人建单
- 可以，因为创建工单时调用的是固定的userkey，只要插件配置的usekey有新建权限且该人员有飞书机器人的使用权限即可
