LeanTicket

部署应用

LeanCloud 应用准备

1. 创建 LeanCloud 应用。

2. 调整应用选项：

   • 存储 -> 设置 -> 勾选「启用 LiveQuery」

3. 初始化数据表：将 ./resources/schema 目录下表结构导入到存储服务中。

4. 设置云引擎二级域名：云引擎 -> 设置 -> Web 主机域名

5. 添加新变量：云引擎 -> 设置 -> 自定义环境变量

   • WECHAT_TOKEN, API接收消息参数:token
   • WECHAT_SECRET, 企业微信应用secret
   • WECHAT_ENCODING_AES_KEY, API接收消息参数:EncodingAESKey
   • WECHAT_CORP_ID, 企业微信企业ID
   • WECHAT_AGENT_ID, 企业微信应用ID
   • TICKET_HOST, web 主机域名
   • SITE_NAME, 网站名称
   • OAUTH_KEY,
   • LEANCLOUD_SERVER_URL, api绑定域名

6. 企业微信设置：新建应用 -> 添加自定义菜单 -> 网页授权及JS-SDK启用 -> 设置接收消息 API接收消息URL: https://yoursite.host/webhooks/wechat

7. 使用git方式在线部署: https://github.com/sayue2019/leanTicket

获取应用源码：

git clone https://github.com/leancloud/ticket.git
cd ticket

使用 命令行工具 关联代码到 LeanCloud 应用：

lean switch

根据提示选择刚才创建的 LeanCloud 应用。

然后部署：

lean deploy

部署完成后，访问 https://<刚才设置的二级域名>.leanapp.cn 即可访问。

开始使用

注册管理员

应用注册的第一个账号默认会被设置为「管理员」和「客服」两种角色，之后可以使用该账号添加更多的账号到「客服」角色之中。(注：直接在结构化数据的_User中 -> 添加行 -> 新建一个用户即可登陆)

添加客服

任何一个拥有「客服」角色的账号，都可以在 右上角点击用户名 -> 设置 -> 技术支持设置 -> 成员 页面添加其他客服账号，输入希望添加账号的用户名，点击「添加为技术支持人员」。

添加工单分类

「客服」账号可以在 右上角点击用户名 -> 设置 -> 技术支持设置 -> 分类 页面来维护分类。

• 可以设置多个分类，如「账号问题」、「Android SDK」等，用户提交工单时可以选择对应的分类。
• 可以设置自己是否负责该分类，也可以看到其他客服负责的分类。
• 点击分类名称，可以设置「问题描述模板」，之后用户选择分类时模板自动填写，方便用户了解需要补充什么信息。

提交工单

应用的账号都可以提交工单，点击右上角「新建工单」，填写相关信息点击提交即可。

提示：「相关应用」是该应用使用在 LeanCloud 内部的一个选择框，没有配置 LeanCloud OAuth 相关信息时，该选择框为空。开发者二次开发时可以移除该功能。

回复工单

工单产生后，应用会根据「工单分类」的负责人，并排除掉「请假」人员，选择工单负责人，该负责人可以在「客服工单列表」中检索到自己负责的工单列表。在工单详情页可以回复用户的问题。

工单状态会随着用户或者客服回复，在「等待客服回复」和「等待用户回复」之间切换。

工单详情页还可以修改工单的分类和负责人信息。

解决或关闭工单

对工单的完结操作有两种「解决」和「关闭」，在工单页面右边可以操作。

• 如果用户认为问题已经解决，点击「已解决」按钮，则工单状态变为「已解决」。
• 如果用户认为问题不需要解决，点击「关闭」按钮，则工单状态变为「已关闭」。
• 如果客服认为问题已经解决，点击「已解决」按钮，则工单状态变为「待确认解决」，此时用户可以看到一个确认信息来「确认已解决」或「未解决」，前者将工单状态变为「已解决」，后者将工单状态变为「等待客服回复」。
• 如果客服认为问题无法解决，点击「关闭」按钮，则工单状态变为「已关闭」。

统计

应用会将工单的一些信息按周汇总统计，方便客服了解一些数据指标。

提示：因为某些原因，统计的时间分割为周五凌晨 0 点，也就是数据汇总是从上周五 0 点到本周五 0 点的数据。

客服个人设置

「客服」账号可以在 右上角点击用户名 -> 设置 -> 技术支持设置 -> 个人设置 页面进行设置。

可以设置企业微信号关联和 Bearychat hook URL，这样有新的工单等信息时会收到响应的提醒。

如果客服无法处于工作状态，可以「请假」，工单不会分配给请假时间段内的客服。

开发环境

安装依赖

npm install

依赖安装完毕会自动编译应用，如果以后需要手动编译请执行：

npm run build

本地启动

启动服务端（确保已经和 LeanCloud 关联）：

lean up

启动客户端：

npm run dev:client

该命令依赖 命令行工具 ，因为需要 lean env 导出 appId 和 appKey。

本地访问

访问 http://localhost:3000 即可。

提示：因为应用依赖较多的 云函数 和 Hook 函数 ，而本地运行时暂不能调用到本地应用的相关代码，所以需要先将应用部署到云端。

内部贡献

注意为了避免 master 和 leancloud 分支出现不一致情况，需要所有提交需要先提交到 master，然后再同步到 leancloud 分支，除非提交的功能是 leancloud 分支独有。