文档首页 / 用户中心设置 / Qmsg酱 QQ推送教程

Qmsg酱 QQ推送教程

2026-10-07 …

Qmsg酱是通过 QQ 机器人给你发 QQ 私聊或 QQ 群消息的推送服务:只需一个 Qmsg Key。适合 QQ 在线时间长的用户。需要一个 QQ 号登录 qmsg.zendee.cn,并完成接收对象(私聊)或群绑定(群聊)。线报酷侧注册会员即可(1 条规则 / 1 个渠道,云端 10 条/天);VIP 为 15 条规则 / 20 个渠道、云端 100 条/天。

第一步:获取 Qmsg Key

  1. 打开 qmsg.zendee.cn,用 QQ 登录;
  2. 要发私聊:按页面引导添加你的 QQ 为接收对象(会给你的 QQ 临时会话发一条确认消息,点确认);
  3. 要发群:在后台「群聊」里添加机器人所在的群并完成群绑定(机器人不在群里、或群未绑定,接口不会报错但群里收不到消息);
  4. 在后台「Key」页复制你的 Qmsg Key。

第二步:本站填写

  1. 推送渠道 → 「新增推送渠道」→ 类型选「Qmsg酱」;
  2. 按表填写:
Qmsg酱渠道配置弹窗
字段必填说明
Qmsg Key✅qmsg.zendee.cn 后台获取;粘贴完整推送地址也可以,系统会自动取出 Key
接收对象(可选)—群聊填群号(需先在 Qmsg 后台完成群绑定);私聊留空即可,3.0 固定发到绑定机器人的那个 QQ
推送类型—私聊 或 群聊,与「接收对象」配套选

推送走 Qmsg 3.0 接口(/v3/send/{Key}):私聊带 qq、群聊带 group=群号。同一 Key 限每 3 秒 1 条。

第三步:发送测试

保存 → 「发送测试」→ 私聊选私聊时 QQ 收到即成功;群聊选群聊时对应 QQ 群出现消息即成功 → 推送规则勾选本渠道。

常见问题

QQ 私聊收不到?

未完成"接收对象确认"(第一步第 2 点);或 QQ 临时会话被关闭——在 QQ 设置里允许临时会话。

群聊测试成功、群里却没消息?

Qmsg 3.0 起群聊共用 /v3/send/{Key},靠 group=群号 指定目标:①确认「推送类型」选了群聊;②确认群号填在「接收对象」里(不是 QQ 号);③在 Qmsg 后台「群聊」里完成群绑定:机器人必须已进群,且该群已在后台登记。只填群号不绑定,Qmsg 会返回成功但消息不会落到任何群。

后台显示「已绑定」却仍收不到?Qmsg 会先受理再投递,最终结果要查消息状态(0 未回执 / 1 成功 / 2 违规 / -1 失败)。回执 -1 通常是 QQ 侧拒收:让群主在群设置里允许机器人主动发言,并检查机器人是否被禁言或已被移出群。

提示「key不存在」?

最常见的原因是贴错了 Key:Qmsg 后台「群列表」里每条群都带一串 40 位「绑定码」,格式和 API Key 一模一样,但它不是 Key。请到「Key」页复制真正的 Key——私聊和群聊都用同一个 Key,群号只填在「接收对象」里。本站保存渠道时会自动校验 Key,贴错会直接提示。

若 Key 确认无误仍报错,说明它已被删除或复制不全,回「Key」页重新复制整串粘贴即可(粘贴完整推送地址也能识别)。

配好了收不到怎么办?

按顺序查:①渠道「发送测试」是否成功;②推送规则是否勾选本渠道并打开开关;③是否完成「接收对象确认」/群绑定;④QQ 是否屏蔽了临时会话/机器人消息;⑤选设备托管时扩展是否在线。

免费额度?

Qmsg 免费版有每日条数限制(同一 Key 每日 500 条、每 3 秒 1 条),重度使用关注其平台规则或配合聚合推送。

最近更新

  • 2026-10-30:适配 Qmsg 3.0——私聊/群聊统一走 /v3/send/{Key},群聊改为 group=群号(旧的 /group/ 地址已下线);补群绑定说明。
  • 2026-10:新增 Qmsg酱渠道支持。