Telegram 机器人对接（强国有我）
旺财狗通过 强国有我（QPigeon） 插件对接 Telegram 机器人。QPigeon 是一个独立的 TG 服务端程序，负责与 Telegram 通信，再与旺财狗对接实现消息收发。
💬 功能简介
- 支持文本、图片、媒体组（多图多文）等消息收发
- 支持 socks5 代理（国内服务器必备）
- 支持 Docker 部署，自带 Web 管理界面
- 支持 WebSocket 与旺财狗连接
准备工作
- 创建 Telegram 机器人：在 Telegram 中联系 @BotFather，发送
/newbot创建机器人，获取 Bot Token（格式类似123456:ABC...） - 一台服务器：可访问 Telegram 的服务器（国内服务器需配置 socks5 代理）
- 旺财狗账号：用于 QPigeon 登录授权
部署 QPigeon
Docker 部署（推荐）
bash
docker run -d \
--name qpigeon \
--restart always \
-p 5000:5000 \
-v ~/qpigeon_data:/app/data \
crpi-5mft5k2asrq5fkut.cn-hangzhou.personal.cr.aliyuncs.com/zhaoyangguang/qpigeon:latest| 配置项 | 值 |
|---|---|
| 服务端口 | 5000 |
| 数据库 | SQLite（/app/data/data.db） |
| 时区 | Asia/Shanghai |
| 数据卷 | /app/data（数据库）、/app/wwwroot/images（TG 图片） |
Windows 部署
- 获取 QPigeon 发布包
- 解压到服务器目录
- 运行
QPigeon.Server.exe - 浏览器访问
http://服务器IP:5000
配置指南
第一步：登录旺财狗账号
首次访问 QPigeon 管理界面（http://服务器IP:5000），使用旺财狗账号登录，用于授权验证和在线数控制。
第二步：配置机器人
在「系统设置」→「机器人配置」页面填写：
| 配置项 | 说明 |
|---|---|
| Token | BotFather 获取的 Bot Token |
| ServerUrl | QPigeon 的公网地址（用于拼接图片 URL） |
第三步：配置代理（国内服务器必填）
在「系统设置」→「代理配置」页面填写 socks5 代理：
| 配置项 | 说明 |
|---|---|
| 代理地址 | socks5 代理地址，如 socks5://ip:port |
| 用户名/密码 | 代理认证信息（如需要） |
第四步：旺财狗安装插件
- 在旺财狗「插件管理」-「插件市场」中安装 强国有我（QPigeonBot） 插件
- 在插件列表中启用该插件
第五步：旺财狗创建 TG 机器人
在旺财狗「系统配置」-「聊天软件对接」中新增 TG 机器人：
- 机器人ID：填写 TG 机器人的 bot-id
- 选择插件：选择
强国有我（QPigeonBot） - WebSocket：开启「支持WebSocket」，关闭「使用鹊桥转发」（QPigeon 原生支持 WS）
- 框架HttpAPI：填写 QPigeon 地址，如
http://服务器IP:5000 - 调用Token：自定义一个 Token（与 QPigeon 插件调用时一致）
- 点击「生成插件回调URL」，得到类似：
ws://旺财狗IP:15999/notify/pluginreceive?plid=RebateDog.Plugin.QPigeonBot
第六步：回填回调地址
回到 QPigeon「系统设置」→「回调配置」页面：
| 配置项 | 说明 |
|---|---|
| 回调地址 | 填入旺财狗生成的 WebSocket 地址（ws:// 开头） |
| 屏蔽群消息 | 是否屏蔽 TG 群消息转发 |
| 屏蔽私聊消息 | 是否屏蔽 TG 私聊消息转发 |
保存后 QPigeon 会自动连接旺财狗。
验证对接
- 在 TG 中给机器人发一条消息，旺财狗应能收到并响应
- 在旺财狗中发送消息，TG 用户应能收到
支持的消息类型
接收消息（TG → 旺财狗）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持（自动下载保存） |
| 音频/语音 | 支持 |
| 文档 | 支持 |
| 群聊消息 | 支持 |
| 频道帖子 | 支持 |
发送消息（旺财狗 → TG）
| 类型 | 支持 |
|---|---|
| 文本 | 支持 |
| 图片 | 支持 |
| 媒体组（多图多文） | 支持（推荐） |
| 视频/文件/语音 | 支持 |
| 分享链接 | 支持 |
💡 媒体组发送
QPigeon 支持媒体组发送：多张图片合并在一条消息中发送，第一张图带说明文字，适合返利发单场景。
⚠️ 注意事项
- 国内服务器必须配置 socks5 代理才能访问 Telegram
- 旺财狗的 WebSocket 端口 15999 需要对 QPigeon 服务器开放
- QPigeon 不支持登录、好友列表、群管理等 Telegram 管理功能