机器人运营平台 · 使用教程
版本记录登录管理后台
USER DOCUMENTATION · V2.2.5

从零开始运营您的 Telegram 机器人

教程严格分为“框架使用”和“插件使用”。框架部分介绍账号与机器人基础能力,插件部分按插件名称独立说明;平台发布新版本后,新功能记录会自动同步到教程。

图文操作总览

下面使用与后台一致的界面示意,标出最常用的操作位置。实际页面中的文字和数据会根据您购买的插件与机器人状态变化。

用户运营后台● ● ●
首页概览机器人配置检索插件群管插件插件管理
1先配置机器人
Bot Token从 BotFather 复制 Token,粘贴后点击验证并启用。
验证并启用机器人
成功后系统自动设置专属 Webhook,无需手动填写 Chat ID。
图 1:机器人首次配置位置
插件管理● ● ●
机器人配置插件管理账户管理数据统计
2购买或停用插件
选择开通周期在下拉框选择一个月、一季度或一年,再点击开通/续费。
停用插件已开通插件可暂停使用,授权到期时间仍会正常计算。
停用插件 / 重新启用
图 2:插件购买、续费、停用及重新启用入口
检索插件 · 新建推送● ● ●
推送管理新建推送广告管理检索资源发送日志
3创建推送内容
标题和正文可添加多个图片、视频或文件,并选择立即或定时发送。
保存并推送
图 3:推送与多媒体内容操作
群管插件 · 群组管理● ● ●
群组管理入群审批群监控签到积分
4管理群组
自动登记将机器人加入群组并设为管理员后,群组自动出现在这里。
可进入群聊、审批申请、配置管理员权限、禁言或移除成员。
图 4:群组管理与审批入口

推荐操作顺序

① 登录并配置机器人

确认 Token 正确、Webhook 设置成功,机器人能够正常回复。

② 充值并购买插件

按业务需要开通检索、群管或抽奖插件,功能菜单才会出现。

③ 加群并开始运营

机器人取得管理员权限后自动登记群组,再配置推送、检索和群管规则。

快速开始

登录独立管理后台

使用平台管理员分配的用户名和密码登录。左侧会显示您的 UID、机器人账号和授权期限。

配置 Telegram 机器人

进入“机器人配置”,填写从 BotFather 获取的 Bot Token。保存后系统会验证机器人并设置专属 Webhook。

请勿公开 Bot Token。机器人加入群组或频道后,需要授予管理员权限才能执行推送和群管操作。

选择并管理插件

进入“插件管理”,在下拉框选择月、季度或年度并购买需要的功能。购买成功后,对应侧栏分类才会显示;点击“停用插件”会立即停止该插件功能并隐藏菜单,但不会暂停授权倒计时,之后可以重新启用。

平台功能插件

检索插件可选插件

包含推送管理、新建推送、广告管理、检索资源、热词管理、邀请数据及机器人用户端检索设置。

群管插件可选插件

包含群组管理、入群审批、群监控、签到积分、积分排行、积分等级、多目标私聊入群验证、群成员权限和后台实时群聊。

抽奖插件可选插件

依赖群管插件和签到积分,支持定时开奖、多人中奖、积分奖品、实物兑奖和卡密自动私聊发放。

上课插件可选插件

支持独立课表、老师和商家菜单,按用户名读取老师与商家、自动绑定 User ID、可点击老师名称、私聊与群组打卡、分页活跃度排行及课表链接菜单。

检索插件 · 图文操作

新建推送步骤 1
推送管理新建推送发送日志
填写推送内容
标题与内容简介输入资源标题、正文和展示标签。
添加多媒体一个帖子可添加多个图片、视频或文件。
保存推送
图 5:创建多媒体推送;保存后可立即发送或等待定时任务。
推送管理步骤 2
推送管理未推送全部成功
筛选与发送
未推送查看素材群自动采集但尚未发送的内容。
一键推送选择内容后批量发送,也可编辑、删除或再次推送。
图 6:推送列表、状态筛选和一键推送。
检索资源步骤 3
广告管理检索资源热词管理
启用关键词检索
资源状态:启用设置标题、简介、检索词和标签,避免重复填写。
启用后,机器人私聊和群组都可以输入关键词检索。
图 7:资源编辑、检索词和启用状态。
广告管理步骤 4
广告管理热词管理发送日志
设置轮播广告
广告内容填写文字、图片 file_id、链接、按钮和展示权重。
发送日志查看成功或失败记录,支持单条删除和一键清空。
图 8:检索广告权重及发送日志入口。
首次使用请进入“插件管理 → 检索插件用户端设置”,依次开启机器人菜单、关键词检索和检索广告。

群管插件使用方法

群组与频道

机器人被加入并设置为管理员后会自动登记。群组管理支持成员读取、禁言、移除、管理员权限配置和后台群聊;频道同样支持推送和权限管理。

私聊前入群验证

进入“群管插件 → 私聊入群验证”可以开启会话限制。可同时勾选多个群组或频道,并分别填写加入链接;用户只要加入其中任意一个目标即可通过验证。一个都未加入时,机器人会拦截 /start、普通文字和私聊按钮,并显示全部可加入目标。

入群审批

开启 Telegram 入群审核后,申请会进入“入群审批”。可单独批准、拒绝或一键批准;用户取消申请或已经入群后不会继续显示为待处理。

关键词监控

可同时选择多个群组并配置监控关键词。命中后记录会进入后台,支持忽略、禁言和移除等操作。

签到积分

在“签到积分”中开启功能并设置签到指令、查询指令、排行指令、每次奖励和积分名称。群成员每天可在每个群签到一次;机器人会返回当前积分和等级。积分排行榜按群组独立统计,后台可配置多个等级门槛。

群管插件 · 图文操作

群组管理步骤 1
群组管理入群审批群监控
机器人自动登记群组
加入群组或频道邀请机器人进入并授予管理员权限,无需填写 Chat ID。
失去管理员权限的群组会在审计后自动取消显示。
图 9:群组、超级群组和频道自动登记。
群成员管理步骤 2
群组管理成员与权限群组聊天
管理成员权限
点击成员可以禁言、解除禁言、移除或设置管理员权限。
群组聊天查看引用消息、使用表情,并从后台直接回复。
图 10:成员快捷管理和后台群聊。
入群审批步骤 3
群组管理入群审批群监控
处理加入申请
待审批列表单独批准、拒绝,或者点击一键批准。
用户取消申请或已批准后,不再出现在待处理列表。
图 11:新用户申请入群审批。
群监控与积分步骤 4
群监控签到积分积分排行
配置监控和签到
关键词监控选择多个群组,设置命中词并处理违规用户。
签到积分自定义指令、积分名称、奖励数量和等级。
图 12:多群监控、签到积分和等级排行。
Telegram Bot API 无法主动读取完整历史成员列表;普通成员或其他机器人需要在群内产生消息,或通过数字 User ID 添加后才能管理。

抽奖插件使用方法

抽奖插件依赖群管插件及签到积分。必须先开通群管插件,并在“签到积分”中开启积分功能。

发布定时抽奖

进入“抽奖管理”,选择群组、开奖时间、中奖人数和奖品类型。发布后机器人会在群内发送参与按钮,到达开奖时间后系统自动随机抽取中奖者。

奖品类型

积分奖品会自动增加中奖用户在对应群组内的积分;实物奖品会向中奖者发送指定兑奖联系人;卡密奖品从后台库存中逐个分配,并由机器人私聊发送给中奖者。

参与前准备

参与者必须先私聊机器人并发送 /start,确保机器人能够在中奖后发送通知或卡密。每名用户在同一场抽奖中只能参与一次。

发布后可在活动记录中查看参与人数、开奖状态、中奖结果及奖品发送情况。

抽奖插件 · 图文操作

插件依赖检查步骤 1
群管插件签到积分抽奖插件
先开启依赖功能
群管插件:有效进入签到积分页面并打开积分功能。
依赖未满足时无法购买或发布抽奖。
图 13:抽奖插件依赖群管插件和签到积分。
发布新抽奖步骤 2
抽奖管理活动记录
填写活动规则
群组与开奖时间选择活动群组、开奖时间和中奖人数。
奖品类型选择积分、实物或卡密并填写对应内容。
图 14:创建定时抽奖活动。
群内参与步骤 3
Telegram 群组参与记录
用户点击参与按钮
🎁 参与抽奖每个 Telegram 用户同一场只能参加一次。
用户需要先私聊机器人发送 /start,才能接收中奖私信或卡密。
图 15:群内抽奖消息与参与按钮。
自动开奖步骤 4
活动记录开奖结果卡密库存
系统到时自动开奖
积分奖品自动增加群积分;实物发送联系人;卡密自动私聊。
开奖状态、中奖用户、发奖结果和失败原因都会显示在活动记录中。
图 16:自动开奖、发奖及异常记录。

上课插件 · 图文操作

上课插件 · 功能导航步骤 1
统计与排行课表与打卡设置老师管理商家管理
功能拆分为独立菜单
统计与排行集中查看老师总数、日周月打卡和群聊活跃度。
三个管理菜单课表设置、老师资料和商家资料分别管理,页面更清晰。
图 17:上课插件首页与三个独立管理菜单。
老师管理 · 搜索读取步骤 2
群内发言 / 私聊 /start搜索用户名自动绑定 UID
按 Telegram 用户名读取老师
先让机器人识别账号老师在群里发言,或私聊机器人发送 /start。
输入 @用户名搜索读取成功后显示 Telegram 用户名和 User ID,再填写名称、市、区保存。
后台不再展示全部用户下拉列表,也不需要手工输入数字 User ID。
图 18:搜索老师 Telegram 用户名并自动读取账号。
课表与打卡设置步骤 3
课表关键词老师打卡课表链接菜单
配置课表下方菜单
按钮名称|链接每行填写一个菜单按钮,可添加多个 HTTPS 链接。
每行按钮数量可选择每行显示 1、2、3 或 4 个菜单。
群成员触发课表关键词后,链接菜单显示在课表消息下方。
图 19:设置课表消息下方的多行链接按钮。
统计与排行首页步骤 4
今日打卡本周打卡本月打卡活跃度翻页
查看老师统计与活跃度
统计卡片展示老师总数和日、周、月打卡次数。
活跃度排行展示消息数与字数,并支持上一页、下一页和页码切换。
图 20:上课插件首页的打卡统计和分页活跃度排行。
机器人私聊或群组步骤 5
老师上课老师下课老师打卡
老师自主上下课与打卡
老师上课 / 老师下课立即加入或移出课表。
老师打卡私聊或群组均可触发,每天成功打卡一次。
图 21:老师在私聊或群组切换课表状态并打卡。
老师用户名必须先被当前用户的机器人识别;Telegram Bot API 不能直接搜索从未与机器人产生过消息的普通用户。

上课插件 · 商家账号自动读取图示

商家账号准备步骤 1
群内发言或私聊 /start机器人识别
先让机器人识别商家
两种识别方式商家在机器人所在群组发言,或者私聊机器人发送 /start。
Telegram Bot API 无法搜索从未与机器人产生消息的普通用户。
图示:商家先与机器人产生消息记录。
商家管理步骤 2
搜索用户名读取账号自动绑定 UID
按用户名添加商家
输入 @用户名搜索读取成功后显示 Telegram 用户名与 User ID,再填写商家资料和抽奖规则。
保存商家并自动绑定 User ID
图示:商家与老师使用相同的用户名搜索和自动绑定流程。

上课插件 · 课表老师链接图示

群组课表展示效果
📍 盐都区(3老师)姓名可点击
老师名称与 Telegram 账号合并展示
虞暖 冰冰 沐子课表只显示后台设置的老师名称,不再额外显示一行 @用户名。
老师已绑定 Telegram 用户名时,点击姓名会直接打开该老师的 Telegram 页面;没有用户名时显示普通文本。
图示:课表姓名整洁排列,点击老师名称即可跳转联系。

账户、授权与充值

“账户管理”中可查看 UID、授权期限和平台会员余额,并修改登录密码。需要充值时,按页面提示获取付款信息,完成付款后提交金额与凭证并等待审核;审核通过后平台会员余额自动增加。

平台会员余额用于账号授权和插件购买,与插件商户余额相互独立;授权到期后需要联系管理员续期。

退出登录与本地数据

点击“退出登录”时,可以选择是否清除当前浏览器保存的菜单状态等本地数据。无论选择清除还是保留,都会退出当前账号;清除浏览器本地数据不会删除服务器中的账号、推送、资源或群组数据。

最新功能与历史更新

本区域直接读取平台管理员发布的版本迭代记录。以后发布新版本时会自动更新,无需单独修改教程。
V2.2.5 · V2.2.5
2026-07-22

正式上线版本

  • 机器人菜单
  • - 第一行:热词榜单、热门视频。
  • - 第二行:数据统计、广告合作。
  • - 第三行:邀请好友、邀请机器人入群。
  • - 最后一行:我的。
  • - 移除主菜单中的“关键字检索”按钮,用户仍可直接输入文字检索。
  • ### 检索结果
  • - 随机按钮改为携带当前搜索会话编号。
  • - 随机视频及导航消息发送成功后,自动删除上一个视频、多媒体组和上一个导航消息。
  • - 如果新结果发送失败,保留原结果,避免用户页面变空。
  • - 热词榜单点击结果后,只保留“返回热词榜单”按钮,不显示收藏、分类、翻页、随机和检索广告菜单。
  • - 返回热词榜单时自动删除热词结果媒体。
  • ### 后台热词管理
  • - 新增“热词管理”页面。
  • - 自动记录每个租户机器人的正式搜索次数。
  • - 可以手工增加热词。
  • - 可以设置正数、0 或负数调整值。
  • - 最终展示次数=正式搜索次数+调整值,最低为 0。
  • - 支持修改调整值和删除热词记录。
  • ### 入群申请审批
  • - 审批列表只显示待审批记录,已批准和已拒绝记录不再展示。
  • - Telegram 成员状态确认用户已入群后,待审批记录自动标记为已批准并隐藏。
  • - 单个审批遇到申请已取消、用户已经入群或记录失效时,自动更新状态并从列表隐藏。
  • - 新增“一键批准”,按当前群组筛选一次处理最多 300 条待审批申请。
  • - 一键批准结果显示成功、清理失效和失败数量。
  • ### 一键推送
  • - 一键推送每条内容前,自动把对应检索资源设为启用。
  • - 素材群自动收录的多媒体不再因为此前处于待审核停用状态而无法被用户检索。
V2.2.4 · V2.2.4
2026-07-21

正式上线版本

  • -每个运营用户可以独立开启或关闭自己的机器人菜单,开启后固定为一行两个按钮。
  • - 新增热词榜单、热门视频、我的收藏、VIP会员、邀请好友等机器人功能。
  • - 搜索结果新增收藏、短视频、长视频、AI真人短剧、上一条、下一条和随机按钮。
  • - 搜索结果可展示当前运营用户自己设置的广告按钮与链接。
  • - 新增独立 VIP 会员状态与邀请奖励:邀请人和首次进入的被邀请人各增加 30 天,可叠加。
  • - 用户后台新增邀请总览、邀请排名和最近邀请明细。
  • - 新增浏览量、关键词次数、收藏、邀请关系和 VIP 到期时间等数据结构,全部按租户隔离。
  • ## AI真人短剧权限规则
  • - 用户输入包含 `AI真人短剧`、`AI短剧` 或 `真人短剧` 的关键词时,机器人先校验当前用户 VIP 状态。
  • - VIP 有效:正常返回匹配内容。
  • - 未开通或已到期:不创建搜索结果,只显示无法检索提示和“查看VIP开通方式”按钮。
  • - 私聊点击按钮直接进入 VIP 页面;群组点击按钮会进入当前机器人私聊,避免公开会员信息。
  • - AI真人短剧筛选按钮同样校验 VIP;翻页、随机、热门、收藏及旧消息按钮无法绕过限制。
  • - 素材收录、推送同步、后台保存以及本次数据库升级都会自动识别上述三类文字并标记为 VIP 内容。
V2.2.3 · V2.2.3
2026-07-21

正式版本

  • 1. 操作前实时获取当前机器人和目标管理员状态。
  • 2. 检查当前机器人是否拥有“添加管理员”权限。
  • 3. 检查目标是否为机器人自身、群主或不可编辑管理员。
  • 4. 无权处理时显示具体中文原因,不再直接暴露笼统接口错误。
  • 5. 独立权限页面对不可编辑管理员显示提示并隐藏保存、取消按钮。
  • 6. 取消管理员时完整关闭 Telegram 当前支持的管理员布尔权限。
  • 7. 同步保存 `can_be_edited` 等管理员状态字段。
V2.2.2 · V2.2.2
2026-07-21

正式上线版本

  • 1.新增 Telegram 入群申请事件接收与数据库记录。
  • 2. 群组管理增加“入群审批”入口及待审批数量。
  • 3. 用户后台增加独立入群审批页面,可按群组筛选。
  • 4. 支持查看申请人、User ID、用户名、个人简介、申请时间和邀请链接。
  • 5. 支持后台通过或拒绝申请,并保存处理结果及时间。
  • 6. 审批前检查机器人管理员身份和“邀请用户”权限。
  • 7. 审批记录每 5 秒局部自动刷新,并显示动态倒计时。
  • 8. 待审批记录自动排在已处理记录之前。
V2.2.1 · V2.2.1
2026-07-21

正式上线版本

  • 记录群组中的其他机器人。
  • 将其他机器人设置为管理员。
  • 可配置管理员权限:
  • 修改群信息
  • 删除消息
  • 管理成员
  • 邀请用户
  • 置顶消息
  • 管理话题
  • 管理视频聊天
  • 添加其他管理员
  • 按群组设置监控关键词。
  • 关键词命中后进入后台待处理列表。
  • 显示命中群组、用户、关键词、消息内容及时间。
  • 后台支持禁言、移除、封禁、恢复权限和忽略。
  • 已处理事件记录处理方式及状态。
  • 群组和频道增加删除按钮。
  • 删除时机器人退出群组/频道,并清理成员及监控数据。
  • 历史发送日志继续保留。
V2.2.0 · V2.2.0
2026-07-12

正式上线版本

  • 新增多用户独立管理后台,不同用户的数据完全隔离
  • 支持每个用户配置独立的 Telegram 机器人和专属 Webhook
  • 新增限时授权、永久授权、账户续期和停用功能
  • 授权到期后自动限制后台功能并显示续期提示
  • 新增平台管理员后台,统一管理用户、公告、工单和版本迭代
  • 用户端支持修改登录密码和查看授权信息
  • 新增用户工单系统,支持提交问题和查看平台回复
  • 平台公告调整到用户运营首页顶部展示
  • 首页公告采用蓝紫渐变设计,并支持查看历史公告
  • 新增系统版本号、当前版本说明和历史迭代时间轴
  • 平台管理员可以新增、编辑、隐藏和删除版本记录
  • 推送管理新增未推送和全部成功筛选
  • 新增多条内容一键推送功能
  • 支持推送内容编辑、删除和再次推送
  • 支持立即推送、指定时间推送和多群组同步推送
  • 机器人加入群组或频道并成为管理员后自动登记
  • 无需在后台手动填写群组或频道 Chat ID
  • 素材群中的图片、视频、文件和 GIF 可以自动收录
  • 机器人自动返回素材对应的 Telegram file_id
  • 支持素材群内普通成员和管理员发送素材
  • 一个帖子支持多个图片、视频或文件
  • 多媒体内容按照原帖顺序保存、推送和检索展示
  • 素材自动生成标题、内容简介、标签和检索关键词
  • 后台推送内容自动同步到检索资源库
  • 支持机器人私聊关键词检索
  • 支持 Telegram 群组内关键词检索
  • 关键词结果支持上一个和下一个翻页
  • 多媒体检索结果支持整组内容展示
  • 广告改为独立帖子发送,不再附加到普通推送内容
  • 支持广告文字、图片、按钮文字和跳转链接
  • 支持每天多个固定时间自动轮播广告
  • 新增群组覆盖数量和用户预览数量统计
  • 支持通过正数或负数调整机器人前端展示数据
  • 新增群成员移除、封禁、解封、禁言和恢复权限
  • 支持将群成员设置为管理员或取消管理员
  • 支持配置删除消息、管理成员、邀请用户和置顶消息等权限
  • 新增完整发送日志,记录成功、失败和 Telegram 消息 ID
  • 优化用户后台、平台后台和移动端界面
  • 修复 Telegram API 返回布尔值导致安装程序中断的问题

常见问题

为什么机器人加入群组后没有显示?

确认机器人已经被设置为管理员,并拥有发送消息等必要权限。系统会自动停用已经失去管理员权限的群组。

为什么定时推送没有执行?

检查推送时间、目标群组状态和发送日志中的失败原因;如果配置正确仍未执行,请联系平台管理员处理。

为什么 file_id 在另一个机器人中不能使用?

Telegram file_id 通常属于获取它的机器人。跨机器人全局广告建议同时填写公网图片链接作为失败回退。

群管插件 · 私聊入群验证图示

群管插件 · 私聊入群验证多目标验证
群组管理私聊入群验证签到积分
后台选择多个验证目标
勾选群组或频道可同时选择多个目标,并为每个目标填写独立加入链接。
机器人必须在每个目标内拥有管理员权限。
保存多目标验证
图示:配置多个可选群组或频道,用户无需全部加入。
Telegram 私聊任一目标通过
/start逐个检查状态任一成员即通过
加入其中一个即可使用
➕ 多个加入按钮一个都未加入时,机器人展示全部目标的加入按钮。
加入任意一个目标后再次发送消息,机器人验证通过并继续原有功能。
图示:机器人按“或”逻辑验证成员状态,任意一个目标满足即可放行。