服务端接口
在消息处理函数中，可用 Context 直接回复当前会话。后台任务和独立服务可以使用 api.Client，无需建立事件连接。下表按 QQ 官方模块列出使用入口。
| 官方模块 | 从这里开始 | 当前 SDK 范围 |
|---|---|---|
| 消息收发 | 消息收发概述 | 单聊、群聊、频道收发及消息构造 |
| 消息类型 | 消息类型 | 文本、Markdown、卡片、媒体及旧版 ARK |
| 消息交互 | 交互概述 | 按钮、文本交互、回调路由和 ACK |
| 富媒体消息 | 上传概述 | URL 上传、本地分片上传及底层分片步骤 |
| 图片素材管理 | Markdown 图片素材 | 准备、传输、确认、查询、复用和删除 |
| 机器人 | 机器人接口 | 资料、分享链接、全局菜单与指令面板管理 |
| 群聊管理 | 群聊管理 | 资料、成员、禁言、黑名单、申请和审批策略 |
| 频道管理 | 频道管理 | 频道、子频道、成员、身份组、权限和内容管理 |
按调用方式选择入口
按处理函数或后台服务的需求选择方法。
| 需求 | 入口 |
|---|---|
| 回复当前消息 | ctx.ReplyText、ctx.Reply、ctx.SendReply |
| 后台向明确来源回复 | client.SendReply 与 message.ReplyTarget |
| 显式主动发送 | client.SendMessage，平台检查主动消息资格 |
| 上传后交给业务保存 | client.UploadFile、client.UploadMarkdownImage |
| 调用尚未封装的接口 | 原始 API 扩展 |
注意事项
- “已封装”表示存在可调用的 SDK 方法。机器人权限和客户端显示仍需分别验证。
Client.Request可调用原始路径。各模块提供哪些请求结构、响应结构和参数校验，请查阅对应页面。