jxTMS之开通企业微信机器人

本文的操作，需要先注册到jxTMS。

jxTMS中开通企业微信机器人非常简单。但需要先在企业微信中开通相应的机器人应用，并获取该机器人应用的五种信息：

1、企业微信号：企业微信后台登录后，点击【我的企业】，就是最下方的企业ID

2、应用ID和发送秘钥。要获取这两个信息，首先需要在企业微信的后台创建一个应用：

点击【自建】栏中的创建应用，可以随便给这个应用起个您喜欢的名字，但最好也叫tms【我因为之前已经建过tms应用了，所以这里用了tmsTest】。

点击查看这个新的应用：

[外链图片转存失败,源站可能有防盗链机制,建议将图片保存下来直接上传(img-T1sy96Ru-1658550431542)(http://115.29.52.95:10018/images/10-mt-4-2.png)]

其中的AgentId就是应用ID。然后点击Secret后的【查看】：

点击发送后就可以在企业微信中获取到该应用的发送秘钥。由于太长，手敲很大概率会出错，所以建议转发到微信中，然后从电脑端的微信里直接复制。

3、接收秘钥和接收token

在企业微信后台所创建的应用的详情页中，找到【功能】栏中的【接收消息】：
点击【设置API接收，我因为已经设置过了，所以是已启用API接收】：

请先分别点击EncodingAESKey与Token两栏后的【随机获取】，由企业微信随机生成相应的接收秘钥和接收token。

然后，保持该界面不要动，不要关闭也不要点击【保存】按钮。我们要先用上面收集到的这些信息在jxTMS配置好相应的机器人后，才能来保存，否则企业微信无法验证通过！

jxTMS开通企业微信机器人

用您的manager用户【参考注册到jxTMS中注册成功后的说明】登录到jxTMS中，点击快捷栏【企业微信->创建】，将上面收集到的企业微信号填入，活跃会话数和企业成员数相当，可以填入50即可。然后点击【确认】按钮。

点击快捷栏【企业微信->查看】，然后在显示出来的企业微信界面中，点击上方的【添加机器人】：

其中的appID就是前面的AgentId，名称一定要是tms【目前预置的机器人功能都是名叫tms，如果您自己开发了新的机器人功能，不想放到tms中的，就可以自己起一个新的名字，然后在企业微信中创建一个新的机器人应用收集其信息就好】，发送秘钥、接收秘钥、接收令牌都是上面从企业微信后台所收集到的信息。

填写完毕后，点击【确认】按钮，jxTMS即会创建并启动名为tms的企业微信机器人。

正式开通企业微信机器人

回到刚才让大家保持界面不动的企业微信后台机器人应用的接收消息的【设置API接收】，然后在刚才空着没填的【URL】栏中填入：

http://test.pythonpi.top:10018/{企业微信号}/{应用ID}
如，我创建的tmsTest的url应填入：
http://test.pythonpi.top:10018/ww4exxxxxxxxxxxfea4/1000003

点击【保存】按钮即完成了整个企业微信机器人的开通工作。

注：由于机器人刚开通，但系统已经完成加载了，所以此时机器人中的应用并未加载，所以应执行一次热机刷新【manager用户点击快捷栏：运维管理->重新加载】，将该机器人的应用进行加载。否则该机器人无法执行任何功能。

使用企业微信机器人

打开您的手机中的企业微信，点击【工作台】，在最下面会有tms【或您在企业微信后台创建机器人应用时填写的名字】的机器人应用，点击该应用，就会进入和该机器人应用的对话。

输入0：

该机器人会按上图提示您是新成员【即还没有把您的微信用户号添加到jxTMS中】，按相应的操作提示先完成新成员注册。

这时再输入0：

就会显示主菜单了。其中预置了故障管理和知识管理功能，并放置了一个【说明.txt】供下载测试，该文件是您在创建组织时，系统自动拷贝到您组织中的微信文件目录下的。该微信文件目录就是您登录后的wxFile目录，wxFile目录下的每个子目录就是相应的机器人的根目录。大家可以通过sftp向tms目录中建立子目录并拷入几个文件，然后热机刷新后，再输入0看看共享文件下面有什么变化。

注1：文件大小要遵守企业微信的规定，不能太大【企业微信目前规定不能超过2M】。而且，每个组织的总磁盘额度是20M，如果超过，会导致日志无法写入

注2：开发您的企业微信机器人应用请参考jxTMS的企业微信机器人介绍的说明

注3：企业微信机器人在开发过程中如果出错导致没有及时响应企业微信服务器的呼叫，可能导致企业微信服务器认为本服务器不可信，所以必须在企业微信后台该应用的详情页中的【企业可信IP】配置本服务器为可信服务器：

以上，您就在jxTMS中开通了tms的微信机器人。后面就可以通过【jxTMS示例之故障排查，文章还在写，明后天发出】所述来使用该机器人了，也可以根据jxTMS的企业微信机器人介绍的说明来开发自己的微信机器人功能。