> 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/introduction.md).

# 功能介绍

了解如何通过 CatFee 电报机器人智搭可视化搭建、托管并运营自己的 Telegram 机器人，为私域用户提供能量、TRX 兑换、Telegram 产品及更多服务。

电报机器人智搭（Telegram Bot Studio）是 CatFee 面向钱包服务商、能量商家和私域运营者的可视化机器人搭建与运营平台。您只需准备一个由 BotFather 创建的机器人，即可通过电报机器人智搭配置菜单、回复内容和业务价格，让用户直接在 Telegram 中查询账户、购买服务和查看订单。

机器人由 CatFee 托管，合作方无需自行开发和维护机器人后台。您负责机器人品牌、菜单、售价和客户运营，CatFee 提供业务能力、订单处理和经营数据支持。

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

## 机器人如何工作

```mermaid
flowchart LR
    A[合作方<br/>配置机器人与售价] --> B[CatFee<br/>托管机器人]
    B --> C[Telegram 用户<br/>查询与购买服务]
    C --> D[CatFee 业务服务<br/>处理订单]
    D --> E[客户、订单与经营数据]
    E --> A
```

用户打开您的 Telegram 机器人后，可以通过菜单进入不同业务。用户充值、下单后，订单由对应的 CatFee 服务处理；合作方可以在个人中心查看客户、订单、成本、佣金和可提现收益。

## 核心功能

### 可视化配置机器人

机器人配置页面提供接近 Telegram 实际聊天界面的模拟器。您可以一边编辑，一边查看用户最终看到的内容。

主要支持：

* 绑定或更新 Bot Token，设置默认语言和在线客服账号；
* 启用、停用或重置机器人；
* 配置 `/start`、`/help`、`/price` 等指令；
* 编辑欢迎语、提示消息和按钮触发后的回复；
* 配置消息内按钮和底部快捷菜单；
* 创建可重复使用的自定义按钮组件；
* 分别预览中文和英文内容；
* 使用消息模板和变量展示用户余额、充值地址、订单信息及交易链接。

可视化配置建议在电脑端完成。内置业务按钮用于进入 CatFee 已提供的业务流程，合作方主要配置入口名称、展示内容、关联按钮和业务价格。

### 承载多种业务

机器人可以作为多个 CatFee 服务的统一入口：

| 业务               | 用户可以做什么               | 合作方可以管理什么                 |
| ---------------- | --------------------- | ------------------------- |
| 能量服务             | 查询价格、充值并购买能量          | 设置能量售价、查看能量订单             |
| 转账购买能量           | 向指定地址转入 TRX，自动获得能量    | 选择已启用的能量转租配置并生成推广模板       |
| 波场伴侣             | 订阅持续补能服务              | 设置订阅费和能量售价，管理服务地址及订单      |
| TRX 兑换           | 向指定地址转入 USDT，自动兑换 TRX | 使用已配置的兑换地址并生成机器人展示模板      |
| Telegram Premium | 购买 3、6 或 12 个月会员      | 设置各档套餐售价并查看订单             |
| Telegram Stars   | 购买 Telegram Stars     | 设置单颗售价并查看订单               |
| 地址风险筛查           | 购买套餐并筛查 TRON 地址       | 设置套餐售价，查看筛查记录和套餐订单        |
| 能量理财             | 参与能量理财服务              | 设置收益接收地址和佣金比例，查看参与地址及收益账单 |

不同业务依赖各自的 CatFee 服务配置。例如，使用“转账购买能量”前，需要先创建并启用能量转租收款配置；使用“TRX 兑换”前，需要先配置兑换地址。机器人配置页会提示当前业务是否已经具备使用条件。

### 管理客户和订单

当用户开始使用机器人后，合作方可以在客户数据中查看：

* Telegram 用户信息和账户状态；
* 用户的专属充值地址；
* TRX、USDT 余额；
* 累计充值、消费及最近活跃时间。

订单页面按业务分类展示能量、波场伴侣、Telegram Premium 和 Telegram Stars 等订单。合作方可以根据客户、地址、订单号、交易 Hash、状态和时间进行查询，便于处理售后与对账。

### 查看经营数据和提取收益

运营数据页面集中展示机器人的经营情况，包括：

* 总用户数、充值用户数、活跃用户数和激活占比；
* TRX 与 USDT 的累计充值、消费、成本和佣金；
* 机器人用户余额和当前可提现收益。

可提现收益支持按 TRX 或 USDT 申请提取到指定的 TRON 地址。合作方也可以查看每笔提现的状态、金额、收款地址和链上 Hash。

## 用户资金与消费

机器人会为用户提供专属充值地址。用户可以通过充值后的余额购买机器人内的服务：

* TRX 余额主要用于能量、波场伴侣等 TRX 计价服务；
* USDT 余额主要用于 Telegram Premium、Telegram Stars 等 USDT 计价服务。

具体支持的币种和支付方式以对应业务页面展示为准。合作方设置售价时，应结合页面提供的参考成本和利润提示，避免售价低于成本。

## 快速开始

1. 在 Telegram 中通过 BotFather 创建机器人并取得 Bot Token。
2. 确认 CatFee 账户已有至少 100 TRX 运营启动资金。
3. 进入 CatFee 个人中心，打开机器人的配置页面。
4. 填写 Bot Token、默认语言和客服账号，创建机器人。
5. 进入可视化配置，设置欢迎语、菜单、按钮和业务入口。
6. 为准备经营的业务配置售价，并完成所需的收款地址或服务配置。
7. 启用机器人，在 Telegram 中发送 `/start` 进行完整测试。

## 运营建议

* 先选择准备上线的业务，再配置相应价格、地址和机器人入口；
* 上线前使用模拟器和真实 Telegram 会话检查中文、英文内容及按钮跳转；
* 定期关注 CatFee 账户余额，避免因运营资金不足影响订单处理；
* 定期查看订单、异常状态和客户反馈，并保留订单号与交易 Hash；
* 提现前认真核对币种、金额和 TRON 收款地址。

## 安全提示

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

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