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

从零开始运营您的 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。

平台功能插件

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

检索插件可选插件

包含推送管理、新建推送、广告管理、检索资源、热词管理、邀请数据及机器人、群组独立检索开关。

群管插件可选插件

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

抽奖插件可选插件

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

上课插件可选插件

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

支付插件可选插件

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

双向插件可选插件

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

TG营销可选插件

支持独立 TDLib 用户账号执行器、目标采集、定时加群、群组频道及私聊名单群发、实时监听、DeepSeek 智能回复、消息克隆、多群 AI 群内互聊和关键词营销私聊。

供需插件可选插件

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

记账插件可选插件

面向群组的独立记账工具,支持费率与汇率设置、入款与下发登记、USDT 换算、今日账单、历史账单及后台筛选审计。仅做记账,不具备真实收款能力。

发卡商城可选插件

支持租户独立 Telegram Mini App 商城、商品分类与规格、卡密库存、优惠券、订单锁库、买家钱包、在线支付、自动发卡、售后、客服、问答、评价、播报、可视化欢迎卡片、聊天菜单按钮和独立店铺结算余额。

检索插件 · 图文操作

新建推送步骤 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.1.0 · 运营体验与版本中心升级
2026-07-20

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

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

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

  • 增加多用户数据隔离、限时授权、永久授权和续期
  • 每个用户配置独立机器人及专属 Webhook
  • 增加平台公告、工单、修改密码和群成员权限管理
  • 推送管理增加筛选和一键推送
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逐个检查状态任一成员即通过
加入其中一个即可使用
➕ 多个加入按钮一个都未加入时,机器人展示全部目标的加入按钮。
加入任意一个目标后再次发送消息,机器人验证通过并继续原有功能。
图示:机器人按“或”逻辑验证成员状态,任意一个目标满足即可放行。