GETTING STARTED
使用教程
从零开始，快速掌握 qmsg 消息推送平台
快速开始（3步）
1
接入机器人
扫码或手动输入 AppID/AppSecret
2
绑定目标用户
创建绑定码自动绑定
3
推送消息
网页发送或调用API
第一步：接入机器人
选择下方对应平台的接入教程，按步骤操作即可完成机器人接入。所有平台接入后均可在「机器人管理」中统一管理。
QQ 机器人接入
方式一：扫码接入（推荐）
- 点击「机器人管理」→「接入机器人」
- 选择 QQ，点击「扫码接入」
- 用手机QQ扫描二维码
- 自动获取 AppID/AppSecret 完成接入
方式二：手动输入
- 登录 QQ开放平台 获取 AppID/AppSecret
- 在 qmsg 填入 AppID、AppSecret 和名称
- 点击接入
以下主动/被动消息规则和频率限制仅适用于 QQ 机器人，不代表其他平台的限制；具体额度以 QQ 开放平台当前规则及机器人权限为准。
微信机器人接入
1. 接入机器人
- 点击「机器人管理」→「接入机器人」
- 选择「微信」，点击「扫码接入」
2. 扫码登录
- 用手机微信扫描二维码
- 确认登录微信龙虾（iLink）协议
3. 自动完成接入
- 扫码成功后自动获取 bot_token、ilink_bot_id、ilink_user_id
- 系统自动填入并完成接入，无需手动填写
4. 注意事项
- 微信机器人需要保持后台长连接
- 请勿在微信客户端主动退出登录
- 如掉线可点击「测试」按钮重新连接
- 首次接入后，请用接收消息的微信账号向机器人发送任意一条消息，建立推送所需的会话上下文
- 实际使用中，长时间没有互动的会话可能在约一天后失效，具体时间以微信实际状态为准；建议每天向机器人发送任意一条消息
- 若推送提示 ret=-2、prepare failed，请用接收消息的微信账号手动向该机器人发送一条消息，待机器人收到后重新推送；点击「测试」不能代替这一步
微信基于微信龙虾（iLink）协议，扫码后自动获取 bot_token、ilink_bot_id、ilink_user_id，无需手动填写。 微信会话提醒：接入后请先用接收消息的微信账号给机器人发送任意一条消息。长时间未互动时，会话可能约一天后失效，建议每天发一条消息。若出现 ret=-2 / prepare failed，请手动发消息，待机器人收到后重试推送；点击「测试」不能代替刷新会话。
企业微信机器人接入
1. 创建企业应用
- 登录企业微信管理后台
- 进入「应用管理」→「自建」→「创建应用」
- 填写应用名称和logo，获取 AgentId 和 Secret
2. 获取企业ID
- 在「我的企业」页面底部获取企业ID（CorpID）
3. 配置应用权限
- 在应用详情页开启「API 接收消息」功能
- 配置接收消息的 Token 和 EncodingAESKey（如使用回调模式）
4. 填入 qmsg
- 在 qmsg 接入机器人选择「企业微信」
- 填入企业ID、应用ID（AgentId）、应用Secret
- 点击接入完成
企业微信支持 API 推送和 Webhook 两种模式，推荐使用 API 模式（需要企业ID、应用ID、应用Secret）。
飞书机器人接入
1. 创建企业自建应用
- 打开飞书开放平台创建应用
- 复制 App ID 和 App Secret
2. 开启机器人能力
- 添加应用能力 → 机器人
3. 开通消息权限
- im:message
- im:message.p2p_msg:readonly
- im:message:send_as_bot
4. 事件订阅（长连接）
- 选择长连接接收事件
- 添加 im.message.receive_v1 事件
5. 发布应用
- 创建版本并发布
最关键：机器人能力 + 消息权限 + im.message.receive_v1 事件（长连接模式）
Telegram 机器人接入
1. 创建机器人
- 在 Telegram 中搜索 @BotFather
- 发送 /newbot 命令
- 按提示设置机器人名称和用户名
- 获取 Bot Token（格式：123456:ABC-DEF...）
2. 配置机器人（可选）
- 发送 /setprivacy 命令，选择 Disable，允许机器人接收群消息
- 发送 /setjoingroups 命令，允许机器人加入群组
3. 填入 qmsg
- 在 qmsg 接入机器人选择「Telegram」
- 填入 Bot Token 和机器人名称
- 点击接入完成
4. 绑定目标
- 用户需要先给机器人发送任意消息（如 /start）
- 然后在 qmsg 中创建绑定码，用户发送绑定码完成绑定
Telegram 机器人通过 @BotFather 创建，获取 Bot Token 后填入即可。机器人默认只能主动给已发起过对话的用户发消息。
Server酱接入
1. 注册 Server酱
- 访问 Server酱官网（sct.ftqq.com）
- 使用微信扫码登录注册账号
2. 获取 SendKey
- 登录后在「SendKey」页面获取你的 SendKey
- 免费版和付费版均可使用
3. 选择版本
- 免费版：每日有推送条数限制
- 付费版：无推送条数限制，支持更多通道
4. 填入 qmsg
- 在 qmsg 接入机器人选择「Server酱」
- 填入 SendKey 和备注名称
- 选择付费版/免费版
- 点击接入完成
Server酱不需要绑定推送目标，接入后所有消息直接推送到绑定的微信。免费版有每日条数限制，付费版无限制。
钉钉机器人接入
1. 创建群机器人
- 打开钉钉，进入目标群聊
- 点击群设置 → 智能群助手 → 添加机器人
- 选择「自定义」机器人
- 设置机器人名称和头像
2. 安全设置
- 选择「加签」安全设置（推荐）
- 复制加签密钥（Secret）
3. 获取 Webhook
- 完成创建后复制 Webhook URL
- 格式：https://oapi.dingtalk.com/robot/send?access_token=xxx
4. 填入 qmsg
- 在 qmsg 接入机器人选择「钉钉」
- 填入 Webhook URL 和加签密钥
- 设置机器人备注名称
- 点击接入完成
钉钉群机器人通过群设置中的「智能群助手」创建，获取 Webhook URL 和加签密钥后填入即可。仅支持推送到群聊。
第二步：绑定目标用户
- 在机器人管理点击「目标」按钮
- 点击「创建绑定码」
- 将 Token 发给需要接收消息的用户
- 用户在平台把 Token 发给机器人，自动绑定
绑定码24小时有效，一个码绑一个用户
第三步：推送消息
网页端
- 点击「消息推送」
- 选择机器人和目标
- 输入内容发送
API 调用
- 在「账户设置」生成 API Key
- 调用推送接口（见 API 文档页）
批量推送
三种方式
| 方式 | 接口 | 场景 |
|---|---|---|
| 单条推送 | /openapi/send | 1机器人→1目标 |
| 单机器人批量 | /batch-send | 1机器人→多目标 |
| 多机器人批量 | /v1/push/batch | 多机器人→多目标 |
Markdown 模板
文本格式
**加粗** *斜体* # 标题列表引用
- 列表 > 引用 ----链接图片
[文本](URL) 表格代码
| 列1 | 列2 | ```代码块```消息队列与并发
系统自动控制每个机器人的并发发送数，避免触发腾讯频率限制。在机器人设置中调整「最大并发数」（1-50，默认5）。
常见问题
Q: 机器人显示异常？
A: 点击「测试」按钮重新连接
Q: 用户发绑定码没回复？
A: 确认机器人在线，等待WebSocket建立
Q: 消息发送失败？
A: 检查目标是否绑定、是否频控超限
Q: API Key 忘了？
A: 删除旧Key重新生成