【qq官方机器人对接文档】

admin

机器人功能参考：
未闻花名UI交流①群（274320516）中，有一个小秘书，大家可以先研究一个机器人的用法，然后自己再上手，这样有不会的交流起来也方便

1：注册账号

https://q.qq.com/#/app/bot

2：创建一个新的机器人

3：创建以后，点击机器人进入配置界面

流程简介预览：
①：你要创建一个新的群，称为沙箱群
②：后台设置白名单，白名单内的qq@机器人，机器人才会正常响应
③：提交审核，审核时间差不多2天内，大概意思就是官方要知道你拿机器人来干啥，机器人里大概有些什么指令（发送什么，回复什么）
这一步非常重要，官方人员是会一条一条测试的，只要一条指令没有响应，直接pass，你需要重新提交审核（很考验你的耐心）
④：发布上线，后面的感觉就都挺简单的，主要就是第3步的提交


可能有人要问，这个指令是不是只有通过了的才能用，比如指令666，发个777就没响应
这个不是，机器人会对所有文字有响应，原则上是不允许有隐藏指令的，每次修改指令需要后台重新提交，不过只要你不用机器人乱搞，合理去使用，一般也没有严格到那个地步的


总结：
只要你第一次审核通过，后面没有出太离谱的功能且不提交审核，一般没事，有人要问了，什么叫特别离谱的功能，比如你审核通过了，利用机器人在群里搞颜色，那能行吗？肯定不行....

4：配置沙箱环境

机器人只会处理在沙箱群里的指定人员的信息，这一步应该是官方防止有人直接使用沙箱群实现功能

5：配置快捷指令

①：这个/是快捷指令的调用方式，当用户输入/，就会自动拉起设置的快捷方式
②：消息列表的意思是私聊场景

6：配置ip白名单并将参数复制到软件

①：ip白名单就是你运行机器人那台服务器的公网ip
②：复制参数到phttp框架

7：新创建一个https网站

①：https证书需要去你购买域名的平台申请并下载，下载对应后缀的文件，并将里面的内容填入并保存即可，证书链文件可以不写
①：根目录填写web目录（复习： 【phttp部署环境】）

可能有人会问，web目录不是绑定过了吗
web目录可以被无数的域名同时绑定

8：https通过性测试

如何确定你搭建的https网站是可以正常访问的，这里可以借助phttp里面的调试功能


复习：
007：【开发调试的方法】

要注意不要将https写成http

9：回调配置

①：获得回调地址

这里复制的是标志码，需要拼接
复习：003：【基本类型接口使用说明】  


②填写回调地址并确定配置，环境正确会弹出二维码让你扫码，否则可以去phttp日志中查看错误原因

⑩重点补充

有可能会出现一种情况，就是请求没进来，将回调地址复制到浏览器访问，phttp可以接收到消息，但是填写到第9步中，请求却进不来（也就是根本没有请求我的服务器，更不要说验证了）

对于这个问题，我研究了很久，各种调试，就是不行，其他朋友也说没遇到过这种情况，仿佛我的这台服务器ip被屏蔽了一样

最后发现，是证书问题，证书不对，qq机器人后台请求无法到达你的服务器发送请求，更不要说校验通过了

以腾讯云为例，你要下载其他类型


机器人官方好像会检测证书类型，我下载的是apache类型的，部署后浏览器可以正常访问https，但是后台配置直接无请求

所以，大家如果也遇到这种问题，可以更换其他证书类型尝试

点击返回： 【EWEB总览】