QQ 频道
新建一个 QQ 频道
需要在手机 QQ 中新建一个频道,这个频道将作为你的机器人工作的频道。如果你已有一个小于 20 人的频道也可以直接使用。
操作步骤:
- 点击手机 QQ 右上角加号按钮
- 点击【创建频道】字样,按照指引完成频道创建
- 创建完成后就可以在底部的 频道 Tab 看到这个频道
新建频道时的模板、头像、名字等均可以随你的喜好任意填写。
没有频道 Tab?
频道目前处于内测阶段,如果你之前没有加入过任何频道,则有可能没有这个 Tab。你可以点击加入我们的官方频道,就会自动长出频道 Tab。
如果仍然无法加入,可能你是 QQ 内测的受害者,可以让朋友帮忙申请下。频道功能预计在今年(2023)下半年全量开放。
还有一种可能是你之前把频道 Tab 关了。可以打开手机 QQ 的 设置 -> 辅助功能 -> 主页底部导航栏设置,检查频道开关是否打开。
注意
建立完频道后不要立刻拉一堆人(或机器人)进来,因为后续添加机器人时需要频道人数小于 20 人。待创建流程结束,你自己的跑团机器人加入后就不受影响了。
建立完频道之后,你需要确认下频道中是否存在文字子频道(现版本又称聊天区、讨论组等)。目前也可以在手机 QQ 中新建文字子频道:
(由于频道经常改版,如实际情况与图片所展示的不符,请自行探索看看。另外也可以在登录机器人的步骤中创建文字子频道,详见后续步骤)
注册 QQ 开放平台帐号
注册开放平台帐号是为了后面申请机器人使用。
打开 QQ 开放平台,点击【立即注册】,帐号类型选择【个人】,随后按表单提示一步步进行即可。
创建机器人
使用上一步注册的帐号登录 QQ 开放平台,点击【创建机器人】按钮。随后跟随步骤操作即可。名称、头像和介绍可以按自己的喜好填写。
创建按钮不可点?
如果遇到 bug 创建按钮不可点,也可以登录后直接通过这个链接进入创建页面
机器人创建成功后,会跳转到机器人后台的配置页面。
如果前面步骤中你的 QQ 号和实名认证信息正确对应,【频道 ID】中会自动出现你之前创建的频道,选择该频道即可。
【机器人类型】请选择【私域机器人】,不要变动。
加入机器人
机器人创建成功后,就可以把它加入到我们先前创建的频道中。我们在手机 QQ 中先选中先前创建的频道,点击右上方【三横线】图标,调出频道设置。然后点击【机器人】打开机器人列表。
请用你的火眼金睛在下面的机器人列表中找到你刚刚创建的机器人,点击添加到频道中。机器人权限维持默认就可以。
找不到机器人?
如果在机器人列表中找不到你的机器人,可能有以下几种原因:
- 看错了频道。请确认你正在添加机器人的频道和机器人的沙箱频道(即创建机器人时选择的频道)是同一个频道。
- 频道人数超过限制。请确认你的频道人数小于 20 人。(机器人也算人头数)
- 机器人还在审核中。理论上这一步审核是很快的,可以等一段时间再看看。
如果确实设置正确,且经过长时间仍然无法找到机器人,则可能是 QQ bug,可以去 QQ 机器人的官方社区,找小助理反馈问题。
QQ 频道的能力限制
由于 QQ 官方的安全管控较为严格,机器人会存在不少限制支持,在此提前列出,可配合后续登录机器人步骤时配合查阅。
IP 白名单限制
目前新注册的机器人在使用正式环境登录时,必须在 QQ 开放平台配置 IP 白名单,否则无法连接到机器人。
IP 白名单配置方法:
程序启动后会在命令行中打印出当前公网 IP 地址。可将该地址配置到 QQ 开放平台【开发设置】→【IP白名单】 中,再进行连接操作。
有关 IP 白名单的说明
如果你使用个人电脑(非服务器)运行机器人,电脑的 IP 地址可能会因为重启、重新联网等情况发生变更。如果遇到”接口访问源IP不在白名单“的错误,你可能需要重新设置 IP 白名单。
如果你在这方面遇到问题,或不想频繁设置 IP 白名单,可选择使用【沙箱环境】。
沙箱环境
沙箱环境无需配置 IP 白名单,不受 IP 的限制,但在 QQ 频道中机器人消息会强制带有 [sandbox]
前缀。
另外沙箱环境机器人默认收不到频道的私聊消息。需要在 QQ 开放平台【沙箱配置】→ 【在频道私信配置】中,把对应的用户添加进去,才可以和机器人进行私聊。
私信主动消息条数限制
主动消息是指机器人主动给你发消息。通常的一问一答模式不受限制。但在暗骰时,你在频道里发送指令,而机器人需要主动私聊发送结果,就属于主动消息。
在频道私信时,主动消息存在条数限制:
- 每个机器人每天可以对一个用户发 2 条主动消息
- 每个机器人每天累计可以发 200 条主动消息
其中第一条限制是很容易达到的。如果你发现突然接收不到私信,且命令行中打印出 push dm message reach limit
字样的错误信息,就代表触发了限制。
此时,需要你在私聊中主动给机器人发送一条任意消息。这样可以在接下来的 5 分钟内,让机器人以被动消息形式发送,绕过这个限制。
下一步
恭喜你已经完成了最麻烦的部分!下一步,根据你的操作系统,选择对应的运行方式: