> For the complete documentation index, see [llms.txt](https://docs.catfee.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.catfee.io/telegram-bot/product-features.md).

# 产品特点

了解如何通过 CatFee 电报机器人智搭设计 Telegram 机器人界面、编排会话流程，并快速接入新的业务能力。

电报机器人智搭（Telegram Bot Studio）是 CatFee 面向运营人员的**可视化机器人配置与业务编排平台**，支持设计机器人界面、组织会话流程和接入业务服务。

合作方接入自己的 BotFather Token 后，可以直接在接近 Telegram 实际会话的模拟器中编辑指令、消息和按钮，将已经具备的业务能力组织成清晰、易用的用户流程。后续增加新业务时，也不需要重新设计整套机器人界面，只需把新的业务模块或可复用组件接入现有配置流程。

> 从“修改代码才能调整机器人”，转变为“通过可视化配置持续运营机器人”。

## 所见即所得的可视化配置

配置页面将 Telegram 模拟器与编辑工作区放在同一个界面中。运营人员可以直接点击模拟器里的指令、消息或按钮，再编辑当前选中的对象。

```mermaid
flowchart LR
    A[选择指令、消息或按钮] --> B[编辑内容]
    B --> C[关联后续按钮或业务模块]
    C --> D[实时预览]
    D --> E[确认并保存]
```

整个过程不要求运营人员理解机器人代码结构。看到什么，就配置什么；修改后的内容会同步显示在模拟器中，便于在发布前检查文案、按钮布局和用户路径。

主要支持：

* 配置 `/start`、`/help` 等 Telegram 指令；
* 编辑欢迎语、指令说明和触发消息；
* 配置消息内按钮和底部快捷菜单；
* 调整按钮的分组、排列和展示顺序；
* 将按钮关联到后续消息、菜单或业务模块；
* 创建可重复使用的自定义按钮组件；
* 在查看、编辑和预览状态之间切换；
* 保存前重置或取消本次修改。

{% hint style="info" %}
可视化配置需要较宽的操作空间，建议使用电脑端浏览器完成。
{% endhint %}

## 像搭建流程一样组织机器人

传统机器人往往把菜单、回复和业务跳转写在代码里，运营人员只能提交开发需求。CatFee 将这些内容拆分成可以组合的配置对象：

* \*\*指令：\*\*用户通过 `/start`、`/help` 等命令进入会话；
* \*\*触发消息：\*\*解释当前功能、价格、规则或操作步骤；
* \*\*消息内按钮：\*\*适合套餐选择、下一步操作和结果确认；
* \*\*底部菜单按钮：\*\*适合高频入口和长期固定功能；
* \*\*系统模块：\*\*进入已经接入平台的真实业务流程；
* \*\*自定义组件：\*\*沉淀可以在多个位置重复使用的按钮和回复。

运营人员可以先配置“用户看到什么”，再配置“用户点击后去哪里”。内容与动作分开管理，使复杂的机器人流程更容易理解、调整和复用。

## 新业务可以快速接入现有机器人

可视化配置并不要求每一种业务都预先写死在机器人首页。

当一项新业务已经由平台或合作方后端提供真实的查询、交易或服务能力后，可以将它封装为系统模块或可复用按钮组件，再通过配置平台完成前台接入：

1. 在资源库中选择新的业务模块或组件；
2. 将它添加到现有指令、消息或底部菜单；
3. 配置入口名称、业务介绍和操作提示；
4. 使用变量展示用户、账户或订单信息；
5. 在模拟器中检查完整路径；
6. 保存后让用户从现有机器人进入新业务。

例如，除当前已有的能量、会员和链上工具外，未来还可以用相同方式接入：

* 积分、等级或会员权益查询；
* 邀请返佣和推广活动；
* 钱包资产或订单状态查询；
* 项目活动报名和资格验证；
* 新的链上工具或增值服务；
* 合作方自己的客服与售后流程。

这意味着新增业务时，机器人不必重新开发一套导航和交互界面。业务团队负责提供可调用的业务模块，运营团队则通过可视化配置决定入口、内容和用户路径。

{% hint style="warning" %}
可视化配置负责机器人前台的内容和流程编排。实际查询、交易或交付能力仍需由对应的后端业务模块提供。
{% endhint %}

## 实时 Telegram 会话预览

模拟器按照机器人的实际菜单、指令、消息和按钮关系生成可交互预览。

运营人员可以：

* 点击指令查看对应回复；
* 点击按钮检查后续消息和关联动作；
* 切换查看模式、编辑模式和引导模式；
* 在不同语言之间切换预览；
* 检查分页消息、模板消息和系统模块入口；
* 在保存前发现空内容、错误跳转或按钮层级问题。

对于真实交易类系统模块，模拟器只展示入口和连接关系，不会执行真实订单，避免预览操作误触业务流程。

## 面向 Telegram 的富文本编辑器

内置消息编辑器针对 Telegram HTML 规则进行了适配，支持：

* 加粗、斜体、下划线和删除线；
* 引用、剧透和代码样式；
* 可点击链接和可复制文本；
* 代码块和预格式化内容；
* 常用 Emoji；
* Telegram HTML 源码编辑；
* 可视化预览；
* 消息长度校验。

普通运营人员可以通过工具栏编辑内容；熟悉 Telegram HTML 的运营者也可以切换到源码模式，精确控制消息格式。

## 多语言内容独立管理

同一个指令可以分别维护中文和英文版本，并为未来增加更多语言保留扩展空间。

主要能力包括：

* 设置机器人的默认语言；
* 独立维护不同语言的指令说明和回复；
* 将默认语言内容复制到其他语言后继续修改；
* 指定某个语言版本为默认内容；
* 缺少对应语言内容时回退到默认语言；
* 在模拟器中切换语言并检查展示效果。

合作方可以用同一个机器人服务不同语言的用户，不必复制并维护多套机器人。

## 模板、变量和组件资源库

资源库将常用内容沉淀为可以搜索、插入和复用的配置资源。

### 消息模板

模板适合快速生成结构统一的业务说明，例如：

* 用户个人中心；
* 商品或套餐介绍；
* 购买与付款指引；
* 订单结果通知；
* 在线客服和售后说明。

模板可以作为起点继续编辑，无需每次从空白消息开始。

### 动态变量

消息可以根据当前用户或订单上下文动态展示：

* Telegram 用户 ID、用户名和昵称；
* 充值地址和账户余额；
* 累计充值与消费；
* 机器人名称和客服账号；
* 订单号、金额和套餐名称；
* 钱包地址和交易 Hash；
* Tronscan 地址与交易链接；
* 最近订单列表；
* 由业务模块提供的价格、汇率或状态。

相同模板可以服务不同用户，减少人工复制信息和填写错误。

### 可复用组件

经常使用的按钮和回复可以保存为自定义组件，再添加到不同指令或消息中。修改机器人结构时，可以优先复用已有组件，保持名称、交互和服务入口一致。

## 更安全的编辑与发布过程

配置平台区分查看和编辑状态，修改不会因为一次误点立即覆盖线上内容。

编辑时可以：

* 查看当前线上版本；
* 进入独立编辑状态；
* 实时预览草稿效果；
* 重置本次草稿；
* 取消修改；
* 确认后保存。

系统还提供分步骤的新手引导，帮助第一次使用的运营人员认识模拟器、配置区、资源库以及“编辑内容—关联按钮—预览保存”的完整流程。

## 内置业务是开箱即用的示例

CatFee 已经将部分业务能力接入机器人，合作方可以直接配置入口、展示内容、售价和用户路径，例如：

* TRON 能量与波场伴侣；
* Telegram Premium 与 Telegram Stars；
* 地址风险筛查；
* 能量转租与 USDT 兑换 TRX；
* 能量理财。

这些业务展示了同一套可视化配置体系如何承载购买、订阅、查询、链上工具和资产服务。平台的重点并不是把机器人限制在这些业务中，而是让新的业务能力也能沿用相同的菜单、消息、按钮、模板和预览机制。

## 配套的运营管理能力

可视化配置解决机器人“如何展示和交互”，后台的配套页面则帮助合作方持续运营已经接入的业务。

### 定价管理

已接入的业务可以提供独立价格配置，并结合参考成本展示零售价、预计利润和风险提示。

### 客户管理

客户档案可以记录 Telegram 用户信息、语言、专属充值地址、TRX 与 USDT 余额、累计充值和分类消费，方便定位用户与处理售后问题。

### 订单与链上记录

订单按业务分类展示，并可以关联客户、接收地址、支付金额、状态以及相关链上 Hash，便于查询和对账。

### 经营分析与收益

运营页面分别统计 TRX 和 USDT 的用户余额、累计充值、消费、成本、佣金和可提现收益，并支持收益提现及记录查询。

这些能力为内置业务提供完整经营闭环；其他业务接入时，可以根据自身需要选择是否复用对应的数据与运营模块。

## 机器人基础管理

首次接入时，合作方主要填写：

* BotFather 提供的 Bot Token；
* 默认语言；
* 在线客服账号。

系统会读取机器人的名称、用户名和机器人 ID，并支持启用、停用和重置机器人。

{% hint style="info" %}
机器人开通本身不收取开通费。为保证机器人可以正常承接和处理用户订单，CatFee 账户需要保留至少 100 TRX 作为运营启动资金。
{% endhint %}

{% hint style="danger" %}
Bot Token 相当于机器人的登录凭证，请勿发送给无关人员或发布在公开群组中。如果 Token 泄露，请及时通过 BotFather 重新生成并在 CatFee 更新配置。

重置机器人可能清除现有菜单、按钮和业务配置，且无法撤销。操作前请确认重要内容已经备份。
{% endhint %}

## 产品价值

电报机器人智搭让业务能力与机器人界面解耦：

* **运营人员**可以自主调整文案、菜单、按钮和用户路径；
* **业务团队**可以把新的服务封装为模块，再接入已有机器人；
* **合作方**可以持续扩充服务，而不必为每项业务重做机器人；
* **用户**可以在一致的 Telegram 会话体验中使用不同服务。

> 一次接入机器人，持续通过可视化配置扩展业务。

下一步，请阅读 [电报机器人智搭功能介绍](/telegram-bot/introduction.md)，了解接入条件和快速开始流程。