Go...

当前位置: 首页>>世界杯1998

QQ机器人渠道使用说明

QQ机器人渠道使用说明引言 pushplus对接了QQ官方机器人能力,绑定后可以把消息推送到自己的QQ,也可以推送到机器人已加入的QQ群。发送渠道(channel)参数填写 qq。

除pushplus提供的官方机器人外,也支持绑定自己在QQ开放平台创建的机器人(自有机器人),消息将以你自己的机器人身份发出。一个账号可同时绑定多个机器人,其中一个为默认机器人。

操作流程个人中心->渠道配置->选择“QQ机器人”。

使用QQ扫描页面上的二维码,添加机器人为好友即可绑定。如果扫码后没有自动绑定(例如已经是好友),请复制绑定码,私聊发给机器人。

绑定成功后即可向自己推送消息,无需额外配置。发送渠道(channel)参数选择 qq,不填 option,消息由默认机器人发出。

如需发送到QQ群:先将机器人拉进目标群,并在群内允许机器人主动消息;然后新增一条群配置,发送时把 option 填成该配置编码。

绑定自有机器人登录 QQ开放平台,创建机器人,在“开发设置”中获取机器人的 AppID 和 AppSecret。

在pushplus中:个人中心->渠道配置->QQ机器人,点击“新增QQ机器人”,填写 AppID 和 AppSecret。确认无误后添加。

在QQ开放平台完成以下配置:

接入方式:修改为Webhook回调地址:https://www.pushplus.plus/api/common/qq/webhook;事件订阅:订阅页面展示的全部事件,绑定、群认领和收发开关都依赖这些事件。

在机器人列表中选择刚添加的机器人,扫码添加好友完成绑定(已是好友时私聊发送绑定码)。拉进QQ群的方式与官方机器人相同。

如需让不填 option 的消息改由自有机器人发出,将其“设为默认”。也可以新增一条“发给自己”的配置并指定该机器人,发送时把 option 填成该配置编码。

说明:

普通用户最多可添加 1 个自有机器人,会员最多 5 个。同一个机器人只能被一个账号添加。在QQ开放平台重置了 AppSecret 后,需在 pushplus 中同步修改,否则消息将发送失败;修改了机器人头像昵称后,可点击“刷新”同步。删除自有机器人会同时解除绑定,并删除该机器人的QQ群和相关配置,使用这些配置编码的 option 将失效。自有机器人的消息内容展示规则、请求次数限制与官方机器人一致。接口请求示例请求地址:http://www.pushplus.plus/send/{token}请求方式:POST发给自己:{

"token":"{token}",

"title":"消息标题",

"content":"消息正文内容",

"channel":"qq",

"template":"txt"

}

发送到QQ群,或用指定机器人发给自己(option 填写对应配置编码):{

"token":"{token}",

"title":"消息标题",

"content":"消息正文内容",

"channel":"qq",

"option":"qqgroup",

"template":"markdown"

}

说明:均支持一对一、一对多和好友消息。发送到指定QQ群时不支持同时填写 topic 或 to。渠道值使用 qq。

其他说明配置分为“发到QQ群”和“发给自己”两种。新增群配置时,该群必须允许机器人主动推送,且同一个QQ群只能创建一条配置;“发给自己”的配置需选择已绑定的机器人,每个机器人只能创建一条。QQ机器人渠道日请求次数:实名用户 200 次,会员 1,000 次。实名用户QQ消息中仅展示消息标题部分摘要,不显示消息内容。会员用户会尽量完整的展示内容。(会员用户)单条消息正文上限约 2000 字。txt 模板会尽量完整展示;其他富文本模板仅摘要展示,详情需点击链接查看。QQ Markdown 不支持代码块和 HTML。开放接口提供了自有机器人管理、绑定、解绑、设置默认机器人、群列表和配置的管理能力,详见开放接口文档 - QQ机器人接口。