# 开始
- 请务必看完本页，看完本页你将对Qmsg酱的使用有一个初步了解
- 您可以查阅 API文档 来了解如何调用Qmsg酱的QQ消息推送接口
- 您可以查阅 捐赠版 来了解如何搭建属于自己的Qmsg酱机器人
- 您可以查阅 WebSocket接入 来了解如何使用WebSocket协议接入Qmsg酱
- 您可以查阅 私有云 来了解如何搭建属于自己的Qmsg酱推送服务
# 使用协议
使用Qmsg酱您需要遵守以下协议
- 禁止发送涉黄、涉政、涉恐、辱骂、威胁、广告等违规内容，后台已接入云文字识别，检测到后(可能会误伤)封禁账户。如果涉及到法律责任，相关内容将被上报至有关部门。
- 使用本站服务即默认同意本网站平台机器人账号有通过平台API功能被动向你推送消息的权利。
- 使用本站服务即默认同意本网站保留有对你在本网站账号的所有管理权利。
- 平台不会主动向你推送消息、你的一切活动均为主观操作、与平台无关。
# Qmsg酱网络架构
NGINX：推送接口负载均衡Qmsg Web：Qmsg酱Web服务器Qmsg Send：Qmsg酱推送节点Qmsg Client：Qmsg酱客户端节点，可以是QQ机器人，也可以是WebSocket应用
# 私聊消息推送使用步骤简述
- 进入Qmsg酱管理台 (opens new window)
- 选择要使用的Qmsg酱机器人
- 在管理台 (opens new window)添加需要接收消息的QQ号
- 把你添加的要接收消息的QQ号加你选择的机器人为好友（你不加机器人好友，机器人怎么给你发消息）
- 调用私聊消息推送接口，实现机器人给你的QQ发消息。
# 群消息推送使用步骤简述
- 进入Qmsg酱管理台 (opens new window)
- 选择要使用的Qmsg酱机器人
- 在管理台 (opens new window)添加需要接收消息的群号
- 把你选择的机器人拉到你添加的QQ群里（你不把机器人拉群里，机器人怎么往你群里发消息）。
- 调用群消息推送接口，实现机器人给你的群发消息。
# 公共版/捐赠版/私有云 差异
| 版本差异 | 公共版 | 捐赠版 | 私有云 |
|---|---|---|---|
| 私聊消息 | √ | √ | √ |
| 群聊消息 | √ | √ | |
| 发送表情 | √ | √ | √ |
| @群友 | √ | √ | |
| 发送图片 | √ | √ | |
| 发送JSON卡片 | √ | √ | |
| 发送XML卡片 | √ | √ | |
| API管理QQ列表 | √ | √ | |
| QQ列表数量 | 10个 | 10个 | 不限 |
| 消息数量 | 30条/天 | 不限 | 不限 |
| 推送频率限制 | 5秒 | 不限 | 不限 |
| 接口参数指定推送机器人 | √ | ||
| 触发关键词回调URL | √ | √ | |
| 多机器人负载均衡 | √ | ||
| QQ列表不校验 | √ | ||
| 自由添加/删除机器人 | 限1个 | √ | |
| 违规内容检测 | √ | ||
| 脱离Qmsg酱官网服务 | √ |
# 违规内容检测
违规内容检测包含以下
- URL
- IPv4地址
- 连续数字串
- 敏感词汇
提示
如果遇到不合理的敏感词汇，可以向群主提出建议，建议合适将移除敏感词汇。但是URL、IPv4和连续数字串是绝对禁止。