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

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

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

框架 · 为插件配置独立机器人

每个账号仍保留一个总机器人。您可以为任意已开通插件另外绑定一个专属机器人;专属机器人验证成功后只处理该插件,总机器人不再重复触发该插件。没有绑定、绑定失败、主动停用或插件授权失效时,总机器人自动兜底。

第一步:创建专属机器人

在 BotFather 创建一个新机器人并复制 Bot Token。一个 Token 只能归属于一个总机器人或一个插件机器人,不可重复绑定。

第二步:进入“插件机器人”

登录用户后台,点击左侧“插件机器人”。页面只显示当前已购买、已启用且未到期的插件。

第三步:绑定并验证

在目标插件卡片中粘贴 Token,点击“绑定专属机器人”。系统会自动检查机器人身份、账号冲突并配置独立 Webhook;全部成功后状态显示“专属机器人接管”。

第四步:测试路由

分别向总机器人和专属机器人发送该插件的命令或关键词。正确结果是:专属机器人响应,总机器人对该插件保持静默;其他没有专属机器人的插件仍由总机器人响应。

第五步:停用或更换

点击“停用专属机器人”后,总机器人立即恢复接管。更换 Token 时直接填写新 Token 并重新验证,旧机器人的 Webhook 会被清理。

同时开通多个插件不会冲突:每个专属机器人只获得一个插件作用域;后台定时推送、广告、抽奖、群管审计和客服超时任务也会自动选择对应插件机器人。
媒体注意:Telegram file_id 通常仅能被获取它的机器人使用。切换为专属机器人后,请重新向该机器人发送素材获取 file_id,或同时保留可访问的公网链接作为回退。

常见问题

保存失败后总机器人会不会也失效?不会。只有 Token、身份与 Webhook 全部验证成功,专属机器人才会接管;失败时配置会标记为错误并保持停用,总机器人继续兜底。

插件到期后还会响应吗?不会。插件授权到期或被停用后,总机器人和专属机器人都不会触发该插件;续费并重新启用后,原专属机器人配置可再次生效。

图文操作总览

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

用户运营后台● ● ●
首页概览机器人配置检索插件群管插件插件管理
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。机器人加入群组或频道后,需要授予管理员权限才能执行推送和群管操作。

选择并管理插件

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

公共商户支付机器人

公共商户机器人与用户后台中的“支付插件”是两套独立入口。任何 Telegram 用户都可以私聊公共商户机器人并发送 /start,无需注册平台账号,也无需购买支付插件。

启动菜单与商户钱包

点击聊天输入框旁的“菜单”按钮或发送 /start,即可进入商户钱包首页。首次使用会自动建立钱包,可使用 USDT 充值、提币、转账、收钱、发送固定或运气红包,并查看资金流水。“商户”和“余额宝”固定显示在同一行。

转账与收钱

点击“转账”后,可直接发送收款人的 @username,也可点击消息下方“选择收款人”直接打开 Telegram 对话选择器。选择对话后,输入框会自动出现 @机器人 0.10,其中金额可自由修改;正数表示转账。点击“收钱”同样可直接输入金额或点击“选择付款人”,选择对话后输入框出现 @机器人 -0.10,负号表示发起收款。发送结果卡片后,接收人点击领取转账,付款人点击立即支付。整个流程不会显示底部固定选择菜单。

金额精度:全系统 USD/USDT 的转账、收款、充值、提现、支付订单、余额和资金记录统一保留两位小数,例如 0.10;接口或表单输入超过两位小数时会被拒绝。

商户钱包充值

点击“充值”并输入整数本金,例如 100。机器人会同时发送 TRC20 收款码、地址和带两位识别尾数的精确金额,例如 100.18。请在 10 分钟内严格支付 100.18,到账钱包增加 100.18,识别尾数也计入商户余额。

Stars 与 Telegram Premium

点击“电报星星 / 会员”后,可选择给自己或其他用户充值。帮别人充值 Stars 时先输入数量,帮别人开通 Premium 时先选择周期;随后点击机器人消息下方的选择按钮直接打开 Telegram 用户选择器,选择对话并发送确认卡片,不会出现底部固定选择菜单。Stars 订单完成后机器人会通知充值成功;无法发货时订单金额会原路退回商户机器人钱包。Telegram Premium 使用 Telegram 官方能力自动发放;给自己开通时会先检查当前账号是否已经订阅,已是会员则直接拦截且不会扣款。

商户应用

每个 Telegram 用户最多创建 5 个商户应用,每次创建都会生成新的独立商户编号。商户应用用于取得 App ID、密钥并接入其他网站或商城;未创建商户应用也不影响普通钱包功能。

余额宝

余额宝资金保持可用、不冻结。设置计息额度后,从次日开始按计息额度与钱包剩余 USDT 的较小值计算,每日 04:00 结算,收益保留两位小数并计入“我的账单”。

少付、多付或超过 10 分钟付款都无法自动入账;提币提交后会冻结申请金额,审核拒绝时自动退回。红包 24 小时内未领取的剩余金额会自动退回。绑定 Google 验证器后,资金和商户敏感操作必须输入 6 位动态验证码;未绑定时不要求验证码。
权限区别:公共商户机器人始终可用;平台租户只有购买并启用支付插件后,才能在自己的后台使用支付通道、租户支付 API、收银台和 OKPAY。

平台功能插件

插件未购买、已停用或授权已到期时,对应后台菜单会隐藏;在机器人私聊、群组或频道中触发相关命令时也会保持静默,不发送未开通提示。官网插件区按每行四个排列,超过四个自动换到下一行,新上架插件会自动同步显示。

检索插件可选插件

包含推送管理、新建推送、广告管理、检索资源、公开帖文链接采集、热词管理、数据统计、检索机器人用户数据、群组与频道明细、邀请数据、邀请用户管理、素材备份、群组频道、关键字替换及机器人。

群管插件可选插件

包含群组管理、后台框架内定时消息、自动删除、违禁词处罚、进群欢迎、进群验证、自动回复、入群审批、签到积分、成员权限和后台实时群聊。

抽奖插件可选插件

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

支付插件可选插件

面向平台租户提供平台商户 API 与 Telegram OKPAY 通道;购买并启用后可使用通道选择、支付接口、收入账单及商户余额提现。平台公共商户机器人不受插件授权影响。

双向插件可选插件

支持公告菜单按钮、固定联系客服菜单、多个客服群自动分流和独立话题双向转发;客户超过十分钟未回复时自动结束会话。

TG营销可选插件

TG营销 API 与 TDLib 执行器检测由平台后台统一配置,并在插件管理中心提供直接入口

供需插件可选插件

支持供需信息投稿、多审核员审核、敏感词拦截、图片视频文件、定时发布、置顶、再次发布、同步编辑删除及按失败目标比例退款。免费发布无需支付插件;收费时可接入支付插件充值。

数字营销插件可选插件

每个系统用户独立运营的多店主、多店铺、多机器人数字营销平台

抽奖插件Plus可选插件

高级抽奖、共享频道、克隆机器人与独立金豆

消息提取插件可选插件

通过专属机器人提取 Telegram 帖文、相册和批量消息

转发插件可选插件

监听 Telegram 指定群组内指定用户消息并转发到企业协作群 Webhook。

记账插件Plus可选插件

群组入款、下发、汇率与账期归档记账插件。

榜单插件可选插件

Telegram 地区名片、入驻审核、置顶榜、讨论与举报验证

社工库查询插件可选插件

机器人查询、免费次数、积分、邀请奖励、可选充值与广告展示

供需插件plus可选插件

独立机器人供需发布、审核退款、USDT充值与群组分发。

TG网盘插件可选插件

文件归档、网盘共享、付费下载与独立余额。

TRX 能量租赁插件可选插件

用户支付 TRX 后通过 APITRX 发放真实 TRON Energy

查USDT插件可选插件

查询 TRON 地址资产、资源、权限、最近交易和 TRX/USDT 实时汇率。

检索插件 · 图文操作

新建推送步骤 1
推送管理新建推送发送日志
填写推送内容
标题与内容简介输入资源标题、正文和展示标签。
添加多媒体一个帖子可添加多个图片、视频或文件。
保存推送
图 5:创建多媒体推送;保存后可立即发送或等待定时任务。
推送管理步骤 2
推送管理未推送全部成功
筛选与发送
未推送查看素材群自动采集但尚未发送的内容。
一键推送选择内容后批量发送,也可编辑、删除或再次推送。
图 6:推送列表、状态筛选和一键推送。
检索资源步骤 3
广告管理检索资源热词管理
启用关键词检索
资源状态:启用设置标题、简介、检索词和标签,避免重复填写。
启用后,机器人私聊和群组都可以输入关键词检索。
图 7:资源编辑、检索词和启用状态。
菜单设置步骤 4
广告管理发送日志菜单设置
开启检索端能力
机器人完整菜单控制热词、热门视频、邀请好友和“我的”等菜单。
关键词与广告分别开启检索功能和结果按钮区轮播广告。
图 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 页面;没有用户名时显示普通文本。
图示:课表姓名整洁排列,点击老师名称即可跳转联系。

商户机器人 · Google 验证器与三种语言

个人中心Google Authenticator
个人中心绑定 Google 验证器输入动态码
扫描二维码完成绑定
机器人直接发送二维码图片使用 Google Authenticator 或兼容应用扫描;无法扫描时可手动输入消息中的密钥。
二维码和密钥有效期为 10 分钟。输入 6 位动态验证码成功后,资金、商户和其他敏感操作都会要求验证。
图示:二维码在平台服务器本地生成,不经过第三方二维码网站。
Language三种语言
🇺🇸 English🇭🇰 繁體中文🇨🇳 中文简体
切换整套机器人交互文案
正文、按钮、状态和错误提示选择语言后立即生效,并会记住选择,不会被 Telegram 客户端语言自动覆盖。
商户名称、用户名等用户自己填写的内容保持原文,不会被翻译。
图示:语言设置覆盖商户机器人全部功能页面。

支付插件使用方法

支付插件只面向平台租户。未购买、已停用或已到期时,租户支付菜单、API、收银台和 OKPAY 回调均不可使用;这不会影响任何 TG 用户继续使用公共商户机器人钱包。

选择支付通道

进入“支付插件 → 支付通道”,可以单独启用平台商户支付、单独启用 TG OKPAY,也可以同时启用。两个通道都启用时,付款用户打开订单页面后会看到两个支付按钮并自行选择;只启用一个时会直接进入该通道。

平台商户支付

先在公共商户机器人创建商户应用,取得 App ID,再回到用户端填写 TG 用户名和 App ID 完成绑定。商户详情中的“回调网址”是您自己网站接收支付结果的 HTTPS 地址,可在商户机器人中设置;支付插件内部的平台通道回调由系统按订单自动生成,无需手工填写。外部系统调用 create_order 时,应通过 notify_url 传入自己的业务回调地址。插件停用后租户不能继续创建支付订单,但商户机器人钱包及已有余额不会被冻结或失效。

TG OKPAY

填写 OKPAY App ID 与 token 后启用。系统会自动生成并提交回调网址,付款完成后自动验签入账;订单查询时还会主动查单,避免因回调未送达而漏单。

收入与提现

“收入账单”统一显示两个通道已确认到账的订单。已绑定商户钱包余额可提交提现;OKPAY 余额仍在 OKPAY 侧管理。平台会员余额与商户机器人钱包余额互相独立。

OKPAY token 和商户应用密钥都属于敏感凭证,请勿发送给他人。

支付插件 · 图文操作

支付插件 · 绑定平台商户步骤 1
支付通道收入账单商户余额提现
先在商户机器人创建商户
绑定商户 ID回到用户端填写 Telegram 用户名和商户机器人生成的 App ID;系统验证归属后自动同步余额和记录。
未绑定商户页面会明确显示未绑定状态,不能启用平台商户支付。
Telegram OKPAY如需使用,同时填写 App ID 与 token。
绑定商户 ID / 保存通道
图示:商户只通过商户机器人创建,用户端仅负责绑定已有商户 ID。
付款页面步骤 2
订单金额选择通道确认付款
付款用户自行选择
平台商户支付使用平台 TRC20 自动入账通道。
Telegram OKPAY跳转 OKPAY 机器人完成付款。
单通道模式不会多显示一次选择步骤。
图示:双通道模式下由付款用户选择支付方式。
收入账单步骤 3
收入账单平台商户Telegram OKPAY
统一查看到账结果
同一商户钱包用户端与商户机器人展示相同余额,平台商户订单和资金流水使用同一商户记录。
订单、通道与金额到账记录按时间排列,每页 10 条并支持翻页。
只有完成回调验签或官方查单确认的订单才会记入收入。
图示:绑定后余额、订单、收入和提现记录自动同步。
商户余额提现步骤 4
可用余额冻结余额提现记录
提交平台商户余额提现
金额与 TRC20 地址提交后申请金额进入冻结状态。
平台管理员在“商户支付 → 钱包提币审核”统一处理支付插件和商户机器人钱包的提币;拒绝会自动退回,确认打款后显示交易哈希。
图示:平台支付插件商户余额提现流程。

账户、平台商城与机器人续费

“账户管理”中可查看 UID、授权期限和平台会员余额,并修改登录密码;充值功能已独立放在其二级菜单“账户充值”。点击账户余额卡上的“在线充值”也会直接进入该页面。

账户充值

进入“账户管理 → 账户充值”,输入整数本金并点击“生成 10 分钟充值订单”。订单生成后,收款二维码、TRC20 地址、两位识别尾数和订单状态会在当前页面弹窗显示;可复制地址与精确金额,也可点击“关闭”返回充值记录。请在 10 分钟内支付精确金额,链上确认后自动增加平台会员余额。

在平台商城自助续费

进入“平台商城”,页面上方会显示两个由平台命名的分类。插件分类用于购买、续费、停用和重新启用插件;商城分类可选择机器人一个月、一季度或一年授权套餐,确认后从平台会员余额扣款并顺延授权截止时间。

账户管理账户充值
账户管理账户充值充值记录
弹窗完成在线充值
生成 10 分钟充值订单输入整数本金后,支付信息直接在当前页弹出。
关闭或继续支付关闭弹窗不会删除订单,等待支付、成功和失败记录均保留。
复制地址 / 复制金额 / 关闭
图示:用户端账户充值入口与订单弹窗。
平台商城机器人续费
插件管理商城账户管理
选择机器人授权套餐
月 / 季 / 年查看平台设置的美元价格,选择周期后确认扣款。
立即续费
授权到期后再次登录会直接进入续费页;余额充足即可恢复授权。
图示:平台商城中的机器人自助续费入口。
平台会员余额用于机器人授权和插件购买,与代理余额、插件商户余额相互独立,三者不会互相划转。

代理端 · 账户充值

代理登录后进入“账户管理 → 账户充值”,也可以从首页余额卡点击“在线充值”。输入整数本金并创建订单后,系统会留在代理端当前页面并弹出支付窗口。

代理运营中心账户充值
账户管理账户充值充值记录
弹窗完成充值
二维码、地址与精确金额订单创建后弹窗展示 TRC20 收款码、可复制地址、两位识别尾数和 10 分钟有效期。
关闭与继续支付关闭弹窗后仍可从充值记录再次打开,等待支付、支付成功和支付失败记录全部保留。
到账仅增加充值本金;代理余额与平台会员余额、插件商户余额相互独立。
图示:代理端账户充值二级菜单与订单弹窗。

退出登录与本地数据

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

TG营销插件 · 从账号接入到自动营销

TG营销使用 Telegram 用户账号执行采集、定时加群、群发、监听、营销私聊和消息克隆。它与普通机器人 Webhook 分开运行,因此不会占用或中断您原有机器人的检索、群管和双向客服功能。

① 接入用户账号独立 Session
② 采集目标API / 机器人 / 链接
③ 创建任务加群、群发、监听
④ 查看日志成功与失败可追踪
请只联系已经同意接收消息的用户,并遵守 Telegram 的使用规则。批量陌生用户私聊、短时间大量加群或高频发送可能触发 FloodWait、账号限制或封禁。

第一步:购买并启用插件

进入“平台商城 → 插件管理”

找到“TG营销”,选择一个月、一季度或一年并完成开通。

检查左侧菜单

开通成功后左侧出现“🚀 TG营销”,包含营销总览、用户账号、目标采集、定时加群、群组群发、群组监听、营销私聊、消息克隆、群内互聊、API 设置和执行日志。

确认插件状态

插件被停用或授权到期时,全部入口和执行任务会同时停止;重新启用后才可继续。

第二步:配置 Telegram 与 DeepSeek API

准备 Telegram API ID 与 API Hash

进入 Telegram 官方开发者页面创建应用,取得 API ID 和 API Hash。它们属于用户账号登录凭证,不是 Bot Token。

保存 Telegram API

进入“TG营销 → API 设置”的“Telegram 用户账号 API”卡片单独保存。API Hash 加密保存,保存后不会在页面回显。

单独配置 DeepSeek

在“DeepSeek 设置”卡片填写 Key、接口地址和模型,再点击“保存并测试”。该表单不会修改采集 API。

单独配置采集 API

在“采集 API 设置”卡片填写 RapidAPI Key 与 Host。只导入 Telegram 链接时无需填写。

TG营销 · API 设置步骤 2
Telegram APIDeepSeekRapidAPI
三类接口分别配置
Telegram API ID / Hash用于登录 Telegram 用户账号。
DeepSeek API Key用于营销文案改写和智能回复。
保存并测试
图示:API 密钥按当前平台用户隔离保存。
API 测试结果检查
连接成功鉴权失败超时
先测试再创建任务
连接成功表示 DeepSeek 地址、Key 和模型均可用。
出现 401 时检查 Key;出现超时时检查接口地址和网络。
图示:API 测试会返回明确错误原因。

第三步:添加 Telegram 用户账号

先确认执行器在线

进入“TG营销 → 营销总览”或“API 设置”,独立执行器必须显示“在线”;离线时不要重复创建账号。

进入“TG营销 → 用户账号”

填写账号备注,选择二维码或手机号登录方式;需要代理时先在右侧新增代理。

完成 Telegram 验证

二维码登录会直接显示可扫描二维码;手机号登录会出现验证码输入框。如果账号开启两步验证,继续输入两步验证密码。

确认在线并保护 Session

状态变成“在线”才算接入成功。Session 保存在独立执行服务中,不要复制给他人;停用账号会停止新任务但保留历史日志。

正确结果用户账号列表显示用户名、连接方式、代理和“online”状态,营销总览的在线账号数量同步增加。

第四步:采集目标

方式需要填写适用场景
关键词 API 采集任务名称、关键词、RapidAPI 配置通过已配置的搜索 API 获取公开群组或频道
采集机器人执行账号、采集机器人用户名、关键词向指定 Telegram 采集机器人发送关键词并解析回复链接
导入链接每行一个 t.me 链接已有公开链接或私有邀请链接时直接导入
创建采集任务

选择一种方式并提交。链接导入会立即解析,API 和采集机器人任务由独立执行器处理。

检查采集结果

结果列表展示名称、类型、成员数、链接、状态和时间。重复目标会自动去重。

转入下一环节

需要自动加入时点击“用结果创建加群任务”;只用于群发时,也可以在群发目标中直接填写用户名或 ID。

第五步:定时加群

选择执行账号和采集结果

一个任务只能使用当前平台用户自己的账号。用户目标不会加入加群任务。

设置节奏

设置每批数量、执行间隔以及随机延迟最小/最大秒数。建议从小批量、长间隔开始。

启动并观察

创建后任务进入队列。公开群会尝试加入;需要审核的群显示“已申请”;已经加入的目标不会重复处理。

暂停或恢复

任务列表可暂停、重新启用或删除。删除任务会一并删除该任务的目标明细。

第六步:群组、频道和私聊名单群发

选择发送范围

支持群组、频道、私聊名单或混合目标。每行填写一个目标,也可使用 group:@namechannel:@nameuser:@name 明确类型。

设置内容

支持文字、图片、视频、文件、GIF 和贴纸。媒体填写服务器本地路径或执行驱动可读取的远程地址。

选择内容策略

固定内容直接发送;广告池随机或顺序选取文案;DeepSeek 改写会在发送前按提示词生成新文案。

设置计划

可立即发送、定时发送、按间隔重复、限制运行次数、设置发送间延迟,并设置发送后自动删除。

查看结果

每个目标独立记录成功或失败;失败不会覆盖已经成功的目标。

群组与私聊群发步骤 6
目标范围内容策略定时与延迟
一次任务独立记录每个目标
群组 / 频道 / 私聊按类型解析目标并逐个发送。
广告池 / AI 改写避免所有批次只使用一条固定文案。
图示:群发支持多目标、媒体和多种内容策略。
发送日志结果追踪
成功失败风控等待
按时间查看执行结果
目标与错误原因可按模块、状态筛选并翻页。
发现 FloodWait 时应暂停任务并降低频率,不要立即高频重试。
图示:每一次发送都有时间、目标和状态。

第七步:群组监听与 DeepSeek 回复

选择监听范围

可监听群组、私聊或两者;留空会话列表表示监听账号可见的全部会话,填写后只监听指定会话。

添加回复规则

每行使用“关键词 => 回复内容”。回复以 [AI] 开头时,由 DeepSeek 结合收到的内容生成回复。

设置回复位置与冷却

可在原会话回复,或私聊发送者;冷却时间用于避免同一规则连续触发。

启用监听

保存后在任务列表点击“启用”。监听由常驻事件执行器处理,后台任务队列只负责状态和日志。

第八步:消息克隆并同步编辑、删除

设置来源与目标

填写一个来源群组或频道,并填写一个或多个目标。执行账号必须能读取来源并能向目标发消息。

选择克隆类型

可分别开启文字、媒体和贴纸,也可设置包含关键词与排除关键词。

启用同步

本插件使用“重新发送”,目标消息不显示转发来源。开启同步编辑/删除后,系统保存来源消息 ID 与目标消息 ID 的映射。

验证同步

先在来源发送测试消息,再编辑和删除;目标消息应依次重新发送、同步编辑和同步删除。

正确结果克隆内容没有“转发自”标记;来源编辑后目标正文同步更新,来源删除后全部已映射目标消息同步删除。

第九步:配置群内互聊

准备至少两个在线账号

先在“TG营销 → 用户账号”完成登录,并把准备参与对话的账号全部加入目标群。少于两个在线账号时系统会暂停该群并记录原因,不会由同一账号连续自问自答。

新增互聊群组

进入“TG营销 → 群内互聊”,填写群名称和 @groupname、邀请链接或数字群 ID。多个群需要分别新增,因此每个群都能使用独立时间和账号组合。

设置每日时间窗

填写开始与结束时间。开始时间早于结束时间时按当天运行;例如 09:00 至 22:00。跨午夜时间也支持,例如 20:00 至 02:00。到结束时间后不会继续创建下一条消息。

设置随机回复频率

分别填写最小和最大秒数,例如 30 与 90。每条消息成功后,系统都会在该范围内重新随机选择下一次间隔,并轮换到另一个在线账号。

设置话题方向

填写 DeepSeek 提示词,例如讨论范围、语气和单条长度。系统每天随机选择一个参与账号发起新话题,之后结合最近对话持续生成回复。

选择账号并启用

勾选至少两个已经加入该群的账号,保存后在列表点击“启用”。页面会显示最近发言、下次计划时间和错误信息;需要停止时点击“停用”。

TG营销 · 群内互聊配置
群组时间窗参与账号
每个群独立运行
09:00 - 22:00只在设置时间内持续生成对话。
30 - 90 秒每轮成功后重新抽取随机间隔。
保存并启用
图示:一个群一套时间、频率、话题和账号配置。
互聊运行状态检查
最近发言下次计划错误
发送成功后继续安排下一轮
账号自动轮换不会连续选择上一位发言账号。
不足两个在线账号、DeepSeek 未配置或账号无群发言权限时,会停止本轮并在执行日志显示原因。
图示:互聊记录可在“执行日志”按 group_chat 模块筛选。
正确结果进入开始时间后,由每日随机账号发起话题;之后在最小和最大间隔之间随机等待并持续轮换回复,直到该群的结束时间。

第十步:配置营销私聊

准备主账号与目标群

先在“TG营销 → 用户账号”确认主账号为在线状态,再把该账号加入需要监听的一个或多个群组。主账号必须能接收群消息并能主动发起私聊。

进入“TG营销 → 营销私聊”

填写任务名称并选择一个主账号。该任务只使用这一个账号监听和发送,不会调用其他租户或其他任务的账号。

填写监控群组

每行填写一个公开群用户名或数字聊天 ID,例如 @groupname-1001234567890。多个群可放在同一个任务内。

填写触发关键词

每行一个关键词。群成员消息只要包含任意一个关键词,就会产生一条命中记录;机器人账号和私聊消息不会触发。

填写多条广告词

不同广告词使用单独一行 --- 分隔,广告正文可以换行。系统按保存顺序轮播,发送一条后自动切换到下一条,最后一条之后回到第一条。

保存并启用

任务初始为暂停状态。核对群组、关键词和广告词后,在任务列表点击“启用”。需要停止时点击“暂停”,新消息将不再创建私聊任务。

检查命中记录

页面下方显示来源群、用户 ID、命中关键词、发送状态和错误原因;“执行日志”也可按“营销私聊”模块筛选。

TG营销 · 营销私聊配置
主账号群组与关键词广告池
一个账号监听多个群组
@groupname / -100 ID每行配置一个已加入群组。
咨询、价格、合作任一关键词命中后进入私聊队列。
保存并启用
图示:营销私聊任务初始暂停,确认后手动启用。
营销私聊记录追踪
命中成功失败
同一来源消息只处理一次
广告顺序轮播每次命中自动使用下一条广告。
用户隐私设置、账号风控或禁止陌生人消息时,记录会显示失败原因。
图示:每条记录都保留时间、来源、用户、关键词和状态。
正确结果目标群成员发送匹配关键词后,页面出现一条命中记录;主账号向该用户发送当前轮播广告词,成功后记录变为“成功”。

常见问题

账号一直显示等待登录

先看营销总览中的执行器是否在线,再检查 Telegram API ID/Hash。二维码失效可点击“重新登录”;验证码提交后等待数秒刷新,若出现密码输入框则继续填写两步验证密码。

执行器离线会不会影响普通机器人

不会。TG营销走独立 TDLib 服务,普通机器人、检索、群管和双向客服继续使用原 Webhook。离线期间营销任务保留在队列,恢复后继续领取。

营销私聊命中但发送失败

先查看记录中的错误原因。常见原因包括用户禁止陌生人私聊、账号未在线、主账号被限制或用户已经封禁该账号。系统不会绕过 Telegram 隐私设置。

营销私聊为什么没有命中

确认任务已启用、执行器在线、主账号已加入目标群,并检查群组用户名或数字 ID 是否与实际会话一致。关键词采用“消息包含”匹配,不支持把多个关键词写在同一行。

提示 FloodWait 或账号受限

立即暂停加群、私聊或群发任务,等待 Telegram 返回的限制时间结束,并降低批量数量、延长随机间隔。系统不会通过绕过风控的方式强行发送。

采集 API 没有结果

检查“采集 API 设置”中的 Host 是否与已购买接口一致、Key 是否有效。也可先用“导入链接”验证后续流程。

DeepSeek 回复不生效

在独立的“DeepSeek 设置”中先测试连接;然后确认规则以 [AI] 开头、监听任务运行且消息命中规则。

群发文字成功但媒体失败

检查本地路径是否真实存在且独立执行服务可读取,或远程媒体引用是否可访问;同时确认账号在目标会话有对应发送权限。

克隆没有同步编辑或删除

确认克隆任务正在运行,且来源消息是在任务启用后重新发送并建立映射;启用前的历史消息没有映射,不能同步修改。

可以同时开启检索、双向客服和 TG营销吗

可以。检索与双向客服使用机器人 Webhook,TG营销使用独立 TDLib 用户账号链路,三者按插件授权分别判断,不抢占更新。

检索插件 · 机器人与群组独立开关

进入“检索插件 → 检索资源”

页面顶部新增“检索触发范围”,机器人检索和群组检索可以分别开启或关闭。

设置机器人检索

开启后,用户在机器人私聊中发送普通关键词会返回资源;关闭后保持静默,不返回检索结果或关闭提示。

设置群组检索

开启后,用户在群组或超级群中发送关键词会返回资源;关闭后群内关键词保持静默,但不影响机器人私聊检索。

保存并测试

点击“保存检索开关”,分别在机器人私聊和测试群发送一个已有资源关键词,确认两个入口符合当前设置。

检索资源触发范围
机器人检索群组检索
两个入口互不影响
机器人检索只控制机器人私聊关键词。
群组检索只控制群组与超级群关键词。
保存检索开关
图示:关闭其中一个入口时,另一个入口仍可继续使用。

记账插件 · 群组纯记账完整教程

记账插件用于在群组中登记入款、下发、手续费和汇率换算。它只生成账目与统计,不会创建付款订单、识别链上转账、修改任何钱包余额,也不会执行真实收付款。

① 群组建账发送记账指令
② 设置参数费率与汇率
③ 登记流水入款或下发
④ 查询审计今日与历史

第一步:购买并启用插件

进入“平台商城 → 插件管理”

找到“记账插件”,选择一个月、一季度或一年开通。该插件没有支付插件依赖。

确认状态为使用中

购买后左侧出现“记账插件 → 账本管理”。如果显示已停用,请先在平台商城重新启用。

把机器人加入目标群

机器人必须能读取群消息并发送消息。需要由机器人核验记账操作人是否为管理员,因此不要限制它读取群消息。

建立群组账本

群主或管理员在群中发送 记账,机器人会自动为当前群建立独立账本并返回使用说明。每个群的数据互不混合。

正确结果群内返回“记账插件使用说明”;用户后台的“记账插件 → 账本管理”出现该群名称和 Chat ID。

第二步:设置费率与汇率

设置手续费率

管理员发送 设置费率5,表示入款按 5% 计算记账手续费。下发登记不重复计算手续费。

设置当前参考汇率

发送 设置汇率6.87。这是人工维护的记账参考值,不会调用交易所或支付接口。

需要时使用固定汇率

发送 固定汇率6.50 后优先使用固定值;发送 取消固定汇率 恢复当前参考汇率。

设置汇率调档

使用 上调汇率0.1下调汇率0.1取消调档。实际记账汇率等于基础汇率加调档值。

控制 USDT 展示

发送 u开u关,只影响账单中的换算展示,不改变原始账目。

快照规则:每笔流水都会保存当时的费率和实际汇率。以后修改设置不会改写历史流水。

第三步:登记入款与下发

按账面币值登记入款

发送 +100入款100。可在金额后追加备注,例如 +100 张三

按 USDT 换算登记

发送 +10U入款10U,系统用当前有效汇率换算账面金额。

登记下发

发送 -50下发50-5U下发5U

防止重复

同一条群消息只能形成一笔流水。Telegram 重复投递相同消息时,系统会提示已经记账,不会重复累计。

第四步:查询与后台审计

查询今日账单

群内发送 今日账单,返回今日入款、下发、手续费和应结余。

查询历史账单

发送 历史账单,返回最近 7 个有记账记录的日期汇总。

后台筛选明细

进入“记账插件 → 账本管理 → 记账明细”,可按群组、类型、记录号、操作人、备注和日期筛选,并使用分页查看全部记录。

错误流水使用冲正

后台点击“冲正”会新增一条相反记录,原始记录和冲正记录都保留,便于审计;系统不会直接删除历史账目。

常见问题

为什么输入金额后没有真实到账?

这是设计结果。记账插件只记录数字,不具备收款能力,也不连接 TRC20、支付插件、平台会员余额或插件商户余额。

为什么提示先设置汇率?

入款与下发都要保存汇率快照。请由群管理员先发送“设置汇率6.87”或设置固定汇率。

普通成员为什么不能入款?

为了防止任意成员篡改账目,只有 Telegram 返回身份为群主或管理员的用户可以改设置和记账;普通成员只能查询账单。

机器人没有响应记账指令

确认插件已购买、未停用且未过期;确认机器人仍在群内并能读取、发送消息。未开通插件时,相关指令会按系统规则保持静默。

供需插件 · 从配置到发布完整教程

供需插件用于收集用户提交的供应或需求信息,经审核后发送到租户指定的多个群组与频道。它是独立插件,购买、启用、免费发布和后台管理都不强制开通支付插件。

① 用户投稿正文或媒体
② 管理员审核敏感词与内容
③ 自动发布多群组与频道
④ 失败退款按失败目标比例

第一步:开通并启用插件

进入“平台商城 → 插件管理”

找到“供需插件”,选择一个月、一季度或一年并开通。该插件没有支付插件依赖。

确认插件为使用中

购买成功后,左侧出现“📣 供需插件”。如果状态为停用,请先重新启用。

进入“供需管理”

页面包含投稿审核、发布设置、账户与记录三个分类。

正确结果后台出现供需插件菜单;机器人重新发送 /start 后出现“供需发布”,也可以发送 /supply 打开。

第二步:设置审核员、价格和发布目标

开启供需发布

进入“供需插件 → 供需管理 → 发布设置”,打开“启用供需发布”。关闭后机器人入口保持静默。

设置发布价格

填写 0 表示免费,仅审核即可发布;大于 0 表示审核通过后才从独立供需账户扣费。

添加审核员

填写一个或多个 TG 数字 User ID。多个审核员可以同时收到待审消息,第一位成功处理后,其他按钮不会重复生效。

设置敏感词与规则

敏感词可用空格、逗号或换行分隔;用户提交命中词时会直接拦截。发布规则会显示在机器人“发布规则”页面。

选择发布目标

勾选任意数量已登记且有效的群组或频道。机器人必须在每个目标中拥有发消息权限;需要置顶时还要有置顶权限。

设置置顶分钟数

填写 0 表示不置顶;大于 0 时发布后置顶,到期由定时任务自动取消置顶。

供需管理 · 发布设置配置
价格与审核目标置顶
一次配置多个目标
价格 0.00免费发布不需要支付插件。
审核员 User ID支持多人审核,首个操作生效。
保存发布设置
图示:供需插件独立启用,收费与在线充值是两个不同概念。

第三步:用户提交供应或需求

打开供需中心

用户私聊机器人发送 /supply,或点击机器人菜单中的“供需发布”。

选择供应或需求

点击“发布供应”或“发布需求”,然后发送正文;可以同时附带一张图片、一个视频、一个 GIF 或一个文件。

选择立即或定时

立即提交会直接进入审核;定时发布需输入 2026-07-26 18:30 格式的时间。未审核通过前不会发送。

等待审核结果

机器人会通知审核通过、拒绝原因、余额不足或发布结果。

第四步:审核、扣费与发布

进入“投稿审核”

可按状态、类型、关键词、用户和日期筛选,列表记录提交、审核、计划发布及完成时间。

通过或拒绝

通过后才执行扣费;拒绝必须填写原因。定价为 0 时直接进入发布队列。

余额不足处理

收费投稿余额不足时保持“待余额”状态。管理员可在“账户与记录”手动增加余额;只有租户另行开通支付插件时,机器人中才显示在线充值按钮。

检查发送结果

每个目标最多重试 3 次。部分失败时仅退回失败目标对应费用;例如 10 个目标失败 2 个,退回已扣金额的 20%。

余额严格隔离:供需账户只用于供需广告收费与退款,不等同于平台会员余额,也不等同于插件商户余额,三者不会自动互转。

第五步:编辑、删除、置顶和再次发布

同步编辑

在已发布记录中修改正文并提交,内容重新进入审核;通过后同步编辑全部成功发布的目标消息,拒绝则保留原广告。

同步删除

点击“删除并重审”,通过后同步删除目标消息;拒绝则继续保留原广告。

再次发布

点击“再次发布”会复制原内容生成新投稿,并按当前价格重新审核、扣费和发送。

自动取消置顶

服务器定时任务执行 cron/send.php 时,会发布到期任务并取消到期置顶。

常见问题

没有开通支付插件,供需插件能否正常使用?

可以。插件购买、启用、免费投稿、审核、定时发布、编辑、删除、置顶和失败退款都不依赖支付插件。仅“收费投稿的在线充值”需要支付插件;管理员手动增加供需账户余额不需要。

审核通过后没有立即发送

检查是否设置了未来的计划时间、是否选择发布目标、目标是否仍有效,以及机器人是否拥有发消息权限;同时确认服务器每分钟执行定时任务。

为什么只退回部分费用?

系统按失败目标占全部目标的比例退款。成功发布的目标仍计费,失败目标对应部分自动退回供需账户。

编辑或删除被拒绝会怎样?

原来已经发布的广告保持不变,状态恢复为已发布或部分成功,不会被误标为普通投稿拒绝。

双向插件 · 从开通到接待完整教程

双向插件用于把机器人私聊变成客服工单:用户在机器人中发起客服会话后,系统会在指定客服群里为该用户建立一个独立话题;客服在该话题中回复,消息会自动发回用户私聊。

① 用户私聊点击联系客服
② 自动建话题一人一个话题
③ 客服群回复文字和媒体均可
④ 机器人回传发送给原用户

开始前检查

用户后台已经配置并启用机器人
平台会员余额足够购买插件
准备一个可管理的 Telegram 群组
自己拥有该群的管理员权限
插件未购买、已停用或授权到期时,机器人不会显示“联系客服”,也不会响应客服指令或转发消息。

第一步:购买并开启双向插件

进入用户后台

登录后,在左侧菜单点击“平台商城”,再选择“插件管理”分类。

找到“双向插件”

在插件卡片的周期下拉框中选择一个月、一季度或一年,确认价格与授权期限。

点击开通

点击“年度开通”。扣款成功后,插件状态变为“使用中”,左侧菜单出现“💬 双向插件”。

检查启用状态

如果插件已经购买但处于停用状态,点击“重新启用”。停用期间不会转发任何客服消息。

正确结果用户后台左侧出现“💬 双向插件”,展开后可以进入“客服会话”;用户重新发送 /start 后,机器人输入框上方固定显示“💬 联系客服”。
平台商城 · 插件管理步骤 1
平台商城插件管理账户管理
开通双向插件
年度授权查看一年价格
年度开通
购买成功后,后台菜单和机器人客服入口同时开放。
图 1:在平台商城购买并启用双向插件。
用户后台开通结果
检索插件群管插件💬 双向插件
进入客服会话管理
客服会话查看客服群状态、客户话题和会话记录。
未购买、停用或到期时,该菜单不会显示。
图 2:插件开通后的后台入口。

第二步:把群组开启为“话题群”

打开准备作为客服群的群组

建议使用专门的内部客服群,不要使用公开业务群。群内客服都能看到客户消息。

进入群组管理

手机端:点击群名称 → 点击编辑图标;电脑端:点击群名称 →“管理群组”。

开启“话题”

找到“话题”或“Topics”开关并开启。若没有该选项,先把普通群升级为超级群,再重新进入群设置。

保存群组设置

返回群聊后,群组顶部应出现话题列表或“常规”话题,表示话题功能已生效。

正确结果客服群已经是超级群,并能创建、打开和关闭独立话题。

第三步:自动选择客服群并设置权限

点击自动设置入口

进入用户后台“机器人配置”,点击“设置客服群”;也可以私聊机器人发送“ 双向客服 ”,再点击“选择群组并添加机器人”。

选择准备好的群组

Telegram 会打开群组选择器。选择已经开启话题的超级群,将自己的机器人加入该群。

把机器人设为管理员

进入“群组管理 → 管理员 → 添加管理员”,选择机器人。

打开必要权限

至少允许“管理话题”和“发送消息”。如果 Telegram 显示图片、视频、文件等独立发送权限,也一并开启。

保存权限

保存后返回群组。机器人会发送“是否把这个群设置为客服群?”的确认消息。

Telegram 群组设置步骤 2–3
开启话题管理员机器人权限
客服群必要设置
群组类型已开启话题的超级群
机器人权限管理话题、发送消息和媒体
机器人仅以普通成员身份加入时可以显示引导,但不能完成客服群绑定。
图 3:开启话题并授予机器人管理员权限。
Telegram 客服群步骤 4
机器人已加入确认客服群
是否把这个群设置为客服群?
✅ 设置为客服群由当前群管理员点击确认。
暂不设置本群不会接收客服会话。
图 4:机器人自动发送客服群确认按钮。

第四步:确认绑定客服群

点击“✅ 设置为客服群”

必须由该群管理员操作。机器人会再次检查群类型、话题状态和自身权限。

查看成功提示

成功后机器人回复“本群已加入客服群列表”。需要更多客服群时,重复“设置客服群 → 选择群组 → 授权 → 确认”即可。

后台确认

进入用户后台“💬 双向插件 → 客服会话”,客服群组表格会显示每个群的名称、Chat ID、进行中会话数量和更新时间。

如果机器人没有自动发出确认消息,请由群管理员在群内发送 双向客服/support_setup。私聊机器人发送“ 双向客服 ”会返回自动添加群组的设置按钮。

第五步:测试用户发起客服会话

使用另一个 Telegram 账号测试

测试账号先私聊机器人发送 /start,打开机器人主菜单。

点击固定的“💬 联系客服”

按钮固定显示在输入框上方;也可以直接发送 /support 或文字“联系客服”。机器人回复“已接入人工客服”。

发送一条测试消息

可以发送文字、图片、视频、语音或文件。发送后消息会被复制到客服群对应话题。

检查自动话题

客服群会出现类似“@username · Telegram User ID”的新话题。同一位用户在会话结束前继续使用同一个话题。

正确结果用户私聊消息出现在该用户专属话题中;其他客户会建立其他话题,不会混在一起。

第六步:客服在群里回复用户

进入客户对应话题

客服人员必须确认当前打开的是正确客户话题,避免把内容发给错误用户。

直接发送回复

在话题输入框直接发送文字、图片、视频、语音或文件,不要求引用某一条机器人消息。

检查用户私聊

机器人会把客服消息复制到原客户的私聊窗口。后台同时更新“最近客服回复”时间。

客户私聊机器人步骤 5
联系客服发送消息结束客服
客户进入人工客服
✅ 已接入人工客服随后发送的内容进入专属客服话题。
输入普通机器人命令时仍按原功能处理,不会作为客服正文转发。
图 5:客户通过菜单或 /support 发起会话。
客服群 · 用户专属话题步骤 6
@客户A · UID@客户B · UID@客户C · UID
客服直接在话题回复
客户消息文字、图片、视频、语音或文件
客服回复发送后自动回到该客户私聊
图 6:一位客户对应一个独立客服话题。

第七步:结束会话和后台管理

客户主动结束

用户发送 /end 或“结束客服”,系统关闭该次会话和对应客服话题。

后台结束

进入“💬 双向插件 → 客服会话”,在进行中的记录右侧点击“结束会话”。

10 分钟无回复自动结束

客户接入客服后,超过 10 分钟没有继续发言,系统会自动关闭该次会话和对应话题,并私聊通知客户。若客户接入后尚未发送任何内容,则从建立会话的时间开始计时;客服在群内回复不会重置客户的计时。

筛选会话

可按用户名、昵称或 Telegram User ID 搜索,并按“全部、进行中、已结束”筛选;记录较多时使用分页。

开启或关闭双向客服

页面顶部可以独立关闭双向客服。关闭后固定客服按钮和消息转发停止,但已登记群组与历史记录保留,重新开启即可继续使用。

解除单个客服群

在客服群组表格点击“解除”,只会结束该群中的进行中会话,其他客服群继续工作。

再次咨询时已结束会话的用户再次点击“联系客服”,系统会重新创建一个新话题,不会继续使用已经关闭的话题。

常用指令

使用位置指令或文字作用
机器人私聊/support 或 联系客服建立或进入人工客服会话
机器人私聊双向客服返回选择群组和自动设置说明
机器人私聊/end 或 结束客服结束当前会话并关闭话题
准备作为客服群的群组双向客服/support_setup显示“是否设置为客服群”的确认按钮

常见问题与处理方法

输入框上方没有固定“联系客服”

依次检查:双向插件是否已购买、授权是否到期、插件状态是否为“使用中”、双向客服页面开关是否开启、当前用户机器人是否已经配置成功。修正后重新向机器人发送 /start。

机器人加入群后没有询问是否设置客服群

确认群组已经开启话题,并把机器人设置为管理员。然后由群管理员在该群发送 /support_setup,机器人会重新显示确认按钮。

点击“设置为客服群”提示权限不足

操作人必须是群管理员;机器人也必须是管理员,并拥有“管理话题”和“发送消息”权限。修改权限后再次发送 /support_setup。

群设置里找不到“话题”开关

当前可能仍是普通群。请先在 Telegram 群设置中把它升级为超级群,再进入群管理开启“话题”。

用户发送消息但客服群没有收到

用户必须先点击“联系客服”或发送 /support 进入客服状态。然后检查用户后台“客服会话”顶部是否仍显示已配置客服群,以及机器人是否仍是客服群管理员。

客服回复后用户没有收到

确认客服是在该用户专属话题中回复,且会话状态为“进行中”。如果用户屏蔽了机器人,机器人无法主动把回复送达;请让用户解除屏蔽并重新发送 /start。

为什么一个用户没有重复建立多个话题

同一用户在一次进行中的会话里会一直复用同一个话题,避免客服内容分散。结束会话后再次联系客服,才会建立新话题。

为什么客服会话自动结束了

客户超过 10 分钟没有发言时,系统会自动结束会话。客户重新点击“💬 联系客服”即可建立新的客服话题继续咨询。

可以让多个客服人员同时回复吗

可以。把客服人员加入客服群即可;任何非机器人账号在客户话题中发送的消息都会转给该客户。请注意内部协作,避免多人重复回复。

机器人被取消管理员后会怎样

系统会自动解除该客服群绑定并结束进行中的会话。重新授权后,需要再次确认设置客服群。

可以同时设置多个客服群吗

可以。重复添加流程即可登记多个客服群。新客户会自动分配到当前进行中会话数量最少的可用客服群;已经建立的会话继续留在原客服群,不会重复发送到多个群。

隐私提醒:客服群成员可以看到客户发送的内容。只允许可信客服人员加入客服群,不要把客服群设置为公开群,也不要在话题中索要密码、验证码或私钥。

检索插件 · 推送分类与翻页

进入“检索插件 → 推送管理”,可以在“全部、未推送、全部成功、失败”四个分类间切换。失败分类同时包含部分成功和全部失败的推送,便于集中检查并再次推送。

选择分类

点击分类按钮后,只显示该分类对应的推送内容。

继续筛选

还可按关键词、状态、内容类型和创建日期缩小范围。

翻页查看

每页显示 20 条;列表底部提供上一页、页码和下一页,翻页时自动保留当前分类及全部筛选条件。

如果输入的页码超过实际总页数,系统会自动回到最后一页,不再出现错误的空白列表。

最新功能与历史更新

本区域直接读取平台管理员发布的版本迭代记录。以后发布新版本时会自动更新,无需单独修改教程。
v2.2.29 · TG 运营中心 2.2.29 全新安装基线
2026-09-07

用于空数据库的完整安装,包含当前系统结构、中央授权和全部当前插件运行基础。

  • 固定 product_id=tg-robot;全新安装前执行环境、包校验、空库和中央公开密钥检查;安装后默认由管理员完成中央授权。
v2.0.0 · 多用户 SaaS 运营平台
2026-07-20

系统从单用户升级为多用户独立运营架构。

  • 增加多用户数据隔离、限时授权、永久授权和续期
  • 每个用户配置独立机器人及专属 Webhook
  • 增加平台公告、工单、修改密码和群成员权限管理
  • 推送管理增加筛选和一键推送
v2.1.0 · 运营体验与版本中心升级
2026-07-20

优化用户运营首页的信息展示,并增加可由平台管理员维护的版本中心。

  • 最新公告显示在用户运营首页顶部
  • 增加系统版本号、当前版本说明和历史迭代记录
  • 平台管理员可新增、编辑、隐藏和删除版本记录
  • 修复 Telegram 布尔类型接口响应导致的安装中断问题
v1.0.0 · 自动推送系统正式上线
2026-07-19

完成 Telegram 多群组内容推送的基础运营能力。

  • 机器人进入群组或频道后自动登记
  • 支持多群立即推送、定时推送和再次推送
  • 增加发送成功与失败日志
  • 采用中文管理界面
v1.6.0 · 广告轮播与运营数据
2026-07-19

增强广告商业化能力及前端运营数据展示。

  • 广告按固定时间以独立帖子轮播
  • 广告支持图片、正文、按钮和跳转链接
  • 增加群组覆盖与预览用户统计
  • 完善机器人菜单和邀请入口
v1.8.0 · 智能素材与关键词检索
2026-07-19

打通素材收录、资源管理、搜索和推送流程。

  • 素材群媒体自动收录并返回 file_id
  • 一个帖子支持多个媒体文件
  • 自动整理标题、正文、标签和关键词
  • 支持私聊与群组关键词检索

常见问题

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

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

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

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

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

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

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

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