QQ机器人渠道使用说明

引言

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

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

操作流程

  1. 个人中心->渠道配置->选择“QQ机器人”。

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

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

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

绑定自有机器人

  1. 登录 QQ开放平台，创建机器人，在“开发设置”中获取机器人的 AppID 和 AppSecret。

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

  3. 在QQ开放平台完成以下配置：

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

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

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

说明：

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

接口请求示例

  • 请求地址：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"
}
  • 说明：
  1. 均支持一对一、一对多和好友消息。发送到指定QQ群时不支持同时填写 topic 或 to。
  2. 渠道值使用 qq。

其他说明

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