企业微信机器人WorkTool使用文档

WorkTool 调研报告

前言

先附一下官方介绍

WorkTool是一个依附于企业微信来运行的无人值守机器人。
这是一个开源软件，自动执行一个企业微信账号（该账号当做机器人），
可通过后台调用对应的 API 来让机器人自动执行任务，如收发消息、自动应答、自动建群、拉人踢人等。

源码友情链接

根据产品需求的落地场景
我这里最看重的是他的自动创建外部群拉入客户和销售，并能用接口查询群聊记录，连企业微信会话存档的费用都省了，把机器人拉群里，@机器人问问题可以预先设置简单的问答库。另一个我看重的功能是自动通过好友请求，然后给通过的好友发送一份问卷星小程序让用户填表，问卷星填表后会回调到后台自动生成记录，形成一个闭环。

正文

因为我这里是带着明确的需求来操作，所以讲下我这边让机器人满足需求所做的操作。

首先是使用 WorkTool 的能力有：

1. 企业微信里机器人号实时自动通过好友请求（客户）。
2. 通过好友后机器人号自动发送给客户问卷星小程序。
3. 机器人号发消息再提醒客户填写问卷（如果一段时间没填）。
4. 调用自动创建群 API，调用后可以让机器人号在企业微信创建一个外部群并拉入指定的客户和销售。
5. 机器人号创建群或被拉进群后群聊记录能实时查询。
6. 机器人号在群内被@要能自动回复消息，回复的消息要我可以自由控制。

非 WorkTool 提供的能力有：

1. 问卷星 API 回调接口对接，可以感知问卷星被填写。
2. 提供给机器人号一个定制的问答接口，做个简单的问答规则。

知道了需求和对应能力，下面开始操作：

1. 登陆企业微信账号
   根据官网文档说明，这里需要提供一个安卓手机和企业微信账号，对手机的型号和系统版本没有什么要求，企业微信账号最好是无人使用的单独账号，我这里拿了一台测试的手机用手机小号注册进企业微信。
2. 企业微信账号要实名认证一下，不然不能正常创建外部群等，各种权限受阻，然后又找企业微信管理员开通了这个号的客户群权限。
3. 根据官方文档提示申请了一个机器人链接号，然后安装 WorkTool 软件包把链接号填进去，打开无障碍服务。
4. 程序上面也有提示，就是进入企业微信然后不要熄灭屏幕也不要再动手机，放着就行了。
5. 调用创建群 API、发送消息 API，都能正常建群和发消息，查聊天记录 API 也查到了最新的聊天记录。
6. 在群里@机器人会自动回复，但这里我需要自定义回答，正好官方提供里第三方QA回调接口，我这里只要按照规范写一个问答接口，然后调用设置接口把我写的接口地址保存，后面@机器人的内容都传到我写的问答接口里了，我想回复什么机器人号就回复什么内容，实现了问答接管。

附一个 API 接口文档的链接 https://www.apifox.cn/apidoc/project-1035094/doc-850007

总结

自己写个后台简单的结合 WorkTool 可以很好的实现企业微信自动通过好友，自动推问卷星，自动回答等，基本上满足了这次需求场景，目前还在运行中，再观察一段时间看看。