🤖 源码介绍

本Webhook源码适用于QQ官方机器人

开发者:长歌(原作者) | 冷雨(爆改者)

本源码来自于长歌的1.5版本,因为好用所以我一直在用,国庆闲来无事就适配了多账号功能,优化了函数名命名,修复了遗留bug

加入官方群聊

📦 安装步骤

步骤1:上传源码

将本源码完整上传至服务器

步骤2:域名配置

绑定域名并申请SSL证书启用HTTPS

步骤3:配置信息

编辑回调配置: 域名目录/index.php?appid=&secret=(可多个机器人,通过appid区分)

$appid $secret

步骤4:设置服务器白名单

前往机器人管理后台

在开发设置处填写服务器ip作为白名单

⚠️ 注意事项

❗ 确保填写配置回调中的认证信息

❗ 必须使用域名(不支持IP地址)

❗ 必须启用SSL证书(HTTPS)

❗ 跳转链接需要提前报备

❗ 插件代码使用英式分号结尾

📌 群聊变量

$data

QQ发送的原始JSON数据

📨 群聊发送函数

sendGroup/sendFriend($id, $qun, "文本")

发送群/好友纯文本消息

sendMsg($id, $qun, "文本",1/2)

发送群/好友纯文本消息,1好友,2群

sendPic($id, $qun, "图片链接",1/2)

发送群/好友图片消息,1好友,2群

sendPtt($id, $qun, "语音链接",1/2)

发送群/好友语音消息,1好友,2群,可能会失真,仅仅支持silk。不过不是silk的可以自动转成silk发送

sendVideo($id, $qun, "视频链接",1/2)

发送群/好友视频消息,1好友,2群,仅仅支持mp4

更多请看bot.php里面的function

有许多发送协议和函数

🎞️ 媒体消息函数

sendVideoInGroup($id, $group, "视频链接")

群聊发送视频消息(自动上传视频文件到群媒体存储)

sendPttInGroup($id, $group, "语音链接")

群聊发送语音消息(自动将语音转为silk格式)

uploadFileInGroup("视频", $group, "视频链接")

单独上传媒体文件到群存储(返回文件信息,用于后续发送)

💾 缓存与配置函数(bot.php专属)

write("文件名.json", "键名", "值")

将数据写入database目录下的JSON配置文件(自动创建目录和文件)

read("文件名.json", "键名", "默认值")

从JSON配置文件中读取指定键的数据,无数据时返回默认值

🔧 工具函数(bot.php专属)

log("日志内容")

写入运行日志到Log目录(按日期分文件,格式:[时间] 内容)

时间格式化(time(), "yyyy年mm月dd日 HH时ii分ss秒")

时间戳转为自定义格式的中文时间(支持yyyy/mm/dd等占位符)

字符串转十六进制("文本内容")

将普通字符串转为十六进制格式(大写输出,用于特定加密场景)

base64转图("Base64编码字符串")

将Base64编码的图片转为可直接访问的图片链接

🔧 其他功能

使用建议

1. 请遵循PHP写法

2. 参考plugin目录中的示例代码

3. 务必注意代码结尾有英式分号";"