Skip to content

QQ 官方机器人 v1.4.2

海豹从 v1.4.2 开始支持对接 QQ 官方的机器人服务。

本节内容

本节将包含你在 QQ 官方机器人平台接入海豹核心需要了解的特定内容。

提示:QQ 机器人

QQ 官方目前已开放了机器人功能,可进入 QQ 开放平台 进行申请。

搭建机器人官方请参考 QQ 机器人文档

目前, QQ 官方机器人已开放个体使用权限。但官方文档没有及时更新

同时,由于 QQ 官方对机器人能力的严格限制(包括获取 QQ 号、昵称,非 @ 时响应,私聊,群控、发送本地图片等大量功能目前不支持),目前对接官方接口的骰子很多功能无法支持(如跑团 Log,暗骰,对抗等)。

QQ 官方机器人的优点,就是不用担心被风控。

尝试一下

如果你想尝试一下这样的机器人,非常欢迎你使用海豹官方的骰子:

海豹机器人二维码

获取连接所需信息

要获取用于连接海豹的信息之前,你需要建立好一个 QQ 机器人应用。可前往 QQ 开放平台 进行申请,实名注册后,创建一个机器人应用。

创建完成后,进入机器人管理后台,切换到「开发设置」页面:

切换到开发设置

在页面中你可以看到这样的信息,其中「机器人 ID」「机器人令牌」「机器人密钥」这三项是海豹进行连接所需要的。

开发设置

然后在「开发设置 IP 白名单」一栏中,填写你骰子所在电脑的 公网 IP。(使用云服务器时,请填写对应云服务商在控制台提供的 IP)

连接官方 Bot

注意:家庭网络的 IP 变动

如果你使用的是家用网络,在本地电脑运行海豹,要注意家庭网络的 IP 通常是不固定的,运营商随时可能会更换你的 IP,遇到问题时请先检查。

连接海豹

登录海豹并添加账号,选择「QQ(官方机器人)」。填写对应的信息点击连接。你的海豹应该可以正常连接官方机器人运作了!

连接官方 Bot

指令配置

  1. 进入「发布配置」页面;
  2. 点击「功能配置」;
  3. 点击「指令配置」;
  4. 再点击右上角的「重新配置」开始编辑;
  5. 点开「指令」页添加指令,「指令名」里面输入对应指令(例如 rraen),/ 是 QQ 官方机器人默认的指令前缀(海豹也支持使用 /);
  6. 然后在「指令介绍」一栏填写指令的简介;
  7. 然后在「使用场景」一栏点击「QQ 频道」、「频道私信」、「QQ 群」,切记不能选中「消息列表」;
  8. 确认配置完成后,扫码确认修改,就可以完成指令配置。
进入指令配置页进行指令配置
推荐指令列表模版推荐指令列表模版1推荐指令列表模版2

机器人上线

点开「使用范围和人员页面」,进入「编辑」页,参考下面图片中编辑使用范围与人员。

连接官方 Bot

配置完成后,点击「发布配置」页面,上传「自测报告」与「隐私协议」。

「隐私协议」与「自测报告」模板

这里提供了海豹骰的机器人「隐私协议」与「自测报告」模版。

强烈建议你按自身情况进行修改,绝对不要原样上传,这涉及到你的机器人是否能被 QQ 官方的工作人员审核通过。

机器人自测报告.xlsx

第三方机器人隐私保护指引.docx

如果你对「指令列表」的指令进行了修改,或者新增了其他功能,请自行修改,需要在「预期输出」一栏填「指令简介」。

点击「提交审核」后,等待 QQ 官方人员测试并审核(时间不定)。审核通过后,在「发布设置」页面中点击「上线机器人」。

提示:关于 QQ 审核

目前 QQ 审核主要是测试机器人能否在所选支持的场景下,正常回应指令列表里的指令(在没有添加任何其他内容前提下),为人工审核。

在提交审核前,请善用沙盒群,测试你提交的自测报告中,所提到的指令是否都能正常工作,机器人需要正常发出回应。

如果你的指令包含一些需要填写的参数,请务必在「自测报告」表格「特殊说明」一栏里补充说明。(你可以参考模板中对 .ra .sc .en 指令的特殊说明。)

如果审核未通过,点击右上角的「通知」查看原因,解决后再次提交。 如果实在无法解决,可加入「QQ 机器人官方频道」,在「寻求||审核和及 bug 」一栏里,发帖询问。

使用海豹

点击「使用人员与范围」页面,查看你的机器人对应的邀请二维码,扫码添加即可。

注意

目前官方机器人只响应包含 @ 的消息,操作时请注意。

同时,官方机器人一次只能发一条消息,一次性发送消息太多,官方机器人会因为消息发送过于频繁而报错。

此外,官方机器人目前无法发送本地图片。

注意事项

大部分事项 QQ 机器人文档 都有说明,这里补充一些文档中没有说明的其他事项:

企业账号的开发者资质审核

如果你使用企业账号进行了注册,请记得在资料一栏中进行开发者资质状态审核。该审核需要将对应企业的银行卡号上传至腾讯审核,期间的等待时间可能较久。在开发者资质状态通过后,你才能将官方机器人送审。

开发者资质状态审核

机器人官方频道跳转

机器人「资料卡」页面中资料卡设置一栏中,「机器人官方频道跳转」不能是骰子的「沙盒频道」。

机器人官方频道跳转

功能审核未通过

有时候「功能配置」页面中,「功能配置与提审」旁显示审核通过,但实际并没有通过,这时点击「机器人上线」的会显示发送错误。

遇见这种情况请点击「通知」,看机器人哪方面没过审,修改后再次提交审核。