电报商品机器人源码支持频道群组推送与自定义按钮

源码简介

这套电报（Telegram）机器人源码是一套面向商品推广的群发推送系统，核心围绕机器人消息接收、关注自动回复和后台批量推送展开。项目基于 ThinkPHP 6 开发，后台可管理频道/群组、批量群发图文，并支持自定义底部按钮。注意：演示 SQL 中含真实 Bot Token 与默认后台密码，部署前必须更换（详见文末安全风险提示）。

适用场景

• Telegram 频道/群组商品推广与活动通知的自动化推送

• 自有机器人关注欢迎语、图文菜单与按钮的配置

• 多群组/分类分组运营与二次开发学习参考

技术栈与运行环境

• 前端：后台基于 HTML 模板（admin/view/*.html），交互依赖 Layer/jQuery；消息展示在 Telegram 客户端

• 后端：PHP + ThinkPHP 6.0 框架（多应用 app 结构）

• 数据库：MySQL（表前缀 cd_）

• 运行环境：PHP 7.4（搭建教程要求开启 SSL），运行目录 public，伪静态 ThinkPHP

• 其他依赖：cURL（请求 Telegram Bot API）、think-queue（队列，当前群发逻辑为同步调用未启用）、阿里云OSS/七牛/腾讯云COS SDK（composer 依赖，用于上传）

功能亮点

• Telegram 消息接收与解析：app/index/controller/Tg.php 的 message() 接收 Webhook 回调，区分 channel_post（频道）、group/supergroup（群组）与私聊，支持文本、图片、视频、动画消息类型

• 频道/群组/多群组推送：app/admin/controller/Qunfa.php 群发公告支持按全部群组、指定群组或群分类（cd_groupclass）推送图文+标题+链接；common.php 的 sendgg1() 调用 Telegram sendPhoto/sendMessage 发送

• 关注自动回复文字与图片：用户输入 /start 时 Tg.php 调用 sendgg()，读取 cd_robotconfig 的欢迎语(hy)与欢迎图(tp)，自动回复带按钮的图文欢迎消息

• 后台自定义底部按钮：app/admin/controller/Anniu.php 管理 cd_anniu（名称+链接），sendgg1() 读取全部按钮拼成 inline_keyboard，推送给用户的消息自带可点击底部按钮（每行两个）

• 群/频道管理与分类：Group、Groupclass 控制器管理 cd_group（TG群ID）与 cd_groupclass（分类含群），消息自动记录新群/频道，便于分组定向推送

• 机器人设置与后台管理：Robotconfig 配置 Bot Token、管理员、欢迎语、欢迎图、按钮；Baseconfig 管理站点域名/logo；含 admin_user/role 权限体系

安装与部署提示

1. 环境：PHP 7.4 并开启 SSL（curl 访问 Telegram 需 HTTPS），准备公网可访问域名

1. 上传源码至服务器，运行目录设为 public，配置 ThinkPHP 伪静态

1. 导入 tgqf_20230203_231646.sql，修改 config/database.php（或 .env）数据库连接信息

1. 后台默认账号 admin / 密码 123321.，登录后进入【配置管理-上传配置】将域名改为自己的（结尾不带/）

1. 进入【机器人设置】填写 Bot Token，保存并点击初始化、开启机器人；Webhook 指向 域名/index/tg/message。给机器人发任意图片获取图床地址回填到图片配置

截图与演示说明

根据源码结构，部署后可查看以下后台页面与模块：

• 后台登录页：app/admin/view/login/index.html

• 后台首页/控制台：app/admin/view/index/index.html、main.html

• 群列表管理：app/admin/view/group/index.html（对应 cd_group，记录 TG 群/频道 ID）

• 群分类管理：app/admin/view/groupclass/index.html（对应 cd_groupclass，按分类归集群组用于定向推送）

• 底部按钮管理：app/admin/view/anniu/index.html（对应 cd_anniu，自定义推送按钮名称与链接）

• 群发公告：app/admin/view/qunfa/index.html（编辑图文、标题、链接并选择目标群组/分类发送）

• 机器人设置：app/admin/view/robotconfig/index.html（Bot Token、欢迎语、欢迎图、按钮）

• 基本配置：app/admin/view/baseconfig/index.html（站点域名、logo、关键词）

• 上传配置：app/admin/view/uploadconfig/index.html

常见问题

运行前需要注意什么？

系统要求 PHP 7.4（开启 SSL）、MySQL 与公网域名用于 Webhook 回调。部署前需修改默认后台密码（admin/123321.）和数据库配置，并将 .env 中 APP_DEBUG 改为 false 避免报错暴露路径；演示 SQL 中的 Bot Token 需替换为自有机器人凭据。

适合二次开发吗？

源码基于 ThinkPHP 6 多应用结构，后台由代码生成器（cd_menu/cd_field/cd_application 等表与 Sys 模块）支撑，模块按控制器/模型/视图分层清晰。机器人推送逻辑集中在 app/common.php 的 sendgg、sendgg1、sendText 函数，群组与按钮逻辑分别对应 Group/Anniu 控制器，便于按业务扩展推送内容与按钮样式。

安全风险提示

特别提示：本源码未检测安全风险文件，下载后请务必进行安全审计，删除恶意代码后再部署使用！

另外在分析中发现以下凭据与配置类风险，部署前必须处理：

• 路径：tgqf_20230203_231646.sql ／ 类型：疑似硬编码账号/密钥 ／ 证据：cd_robotconfig 表中写入了真实 Telegram Bot Token（token 字段），且 config/database.php 明文配置了数据库密码 ／ 建议：部署前重置 Bot Token 并改用自有数据库账号，切勿沿用演示凭据

• 路径：机器人搭建教程.txt ／ 类型：默认账号密码 ／ 证据：后台默认账号 admin、密码 123321. ／ 建议：首次登录后立即修改默认密码，并限制后台入口访问

• 路径：qf/.env ／ 类型：调试模式开启 ／ 证据：APP_DEBUG = true ／ 建议：生产环境改为 false，避免异常信息泄露服务器路径

下载说明

源码仅供学习研究、测试部署和二次开发参考，商用前请自行确认授权、版权和安全风险。本源码为 Telegram 机器人推送系统，使用请遵守 Telegram 平台规则，不得用于垃圾群发、骚扰用户或违反平台条款的用途。