bot-management
Bot List

BOT列表

BOT列表页面用于管理所有的Telegram BOT，包括添加、查看和配置BOT。

页面说明

BOT列表页面的顶部有一段重要说明：

提供自助运维和拓展销售人，让你一键式轻松开启新用户， 充值、订阅均由BOT操作，新客户也由你自动提示至系统代理，使子代理更便捷使用

这表明BOT的主要作用是：

  • 自动化用户接入
  • 处理充值和订阅
  • 自动同步到系统
  • 简化代理管理

统计信息

页面顶部显示关键统计数据：

总BOT数

  • 显示系统中BOT的总数量
  • 实时统计

运行中BOT

  • 显示正在运行的BOT数量
  • 用于监控BOT状态

抓住BOT

  • 显示暂停的BOT数量
  • 需要检查和处理

总交互次数

  • 显示所有BOT的交互总数
  • 反映BOT使用活跃度

添加BOT

前置条件

在CloudQ系统中添加BOT之前，需要先在Telegram中创建BOT：

  1. 在Telegram中搜索并打开"@BotFather"
  2. 发送 /newbot 命令
  3. 按提示设置BOT名称和用户名
  4. 获取BOT Token（格式类似：123456789:ABCdefGHIjklMNOpqrsTUVwxyz）

添加步骤

  1. 点击页面右上角的"添加"按钮
  2. 在弹出的对话框中填写以下信息：

BOT Token *（必填）

  • 粘贴从BotFather获取的Token
  • 验证Token是否有效
  • Token格式：数字:字母数字组合

点击"验证Token"按钮可以测试Token是否正确。

抓取模式 *（必填）

  • 从下拉菜单选择BOT的工作模式
  • 通常有以下选项：
    • 消息模式 - BOT接收和回复消息
    • 订单模式 - BOT处理订单
    • 混合模式 - 同时支持消息和订单

备服号

  • 为BOT添加备注信息
  • 选填，建议填写BOT的用途或区域等信息
  1. 填写完成后点击"确认"按钮

验证结果

添加成功后：

  • BOT会出现在列表中
  • 状态显示为"运行中"
  • 可以开始使用BOT

BOT列表

列表信息

BOT列表表格显示以下信息：

总BOT数

  • 显示BOT的序号
  • 按添加顺序排列

运行中BOT

  • 显示BOT当前的运行状态
  • 包括：运行中、已暂停、错误等

抓住BOT

  • 显示BOT的Token信息
  • 通常部分隐藏以保护安全

总交互次数

  • 显示该BOT的总交互次数
  • 反映BOT的使用频率

BOT名称

  • 显示BOT在Telegram中的用户名
  • 格式：@bot_username

BOT ID

  • Telegram分配的唯一ID
  • 用于系统识别

状态

  • 显示BOT的当前状态
    • 未封禁 - 正常运行
    • 已封禁 - BOT被Telegram封禁
    • 已暂停 - 手动暂停
  • 状态用颜色区分

创建时间/到期时间

  • 显示BOT的创建日期
  • 显示BOT的有效期
  • 格式：YYYY/MM/DD HH:mm:ss

二级代理

  • 显示BOT归属的代理
  • 如果为空表示属于主账号

操作

  • 提供管理操作按钮
  • 包括编辑、暂停、删除等

搜索和筛选

搜索功能

在搜索框中可以搜索：

  • BOT名称
  • BOT ID
  • Token（部分）
  • 备注信息

状态筛选

  • 全部状态
  • 运行中
  • 已暂停
  • 已封禁

类型筛选

  • 全部类型
  • 消息模式
  • 订单模式
  • 混合模式

时间筛选

  • 全部时间
  • 今天
  • 本周
  • 本月
  • 自定义范围

BOT操作

编辑BOT

  1. 点击BOT行的"编辑"按钮
  2. 修改BOT信息
  3. 保存更新

可以修改的内容：

  • 抓取模式
  • 备注信息
  • 到期时间

注意： BOT Token创建后不可修改

暂停/启动BOT

暂停BOT

  1. 点击"暂停"按钮
  2. 确认操作
  3. BOT停止响应用户请求

使用场景：

  • 临时维护
  • 发现异常需要检查
  • 停止推广某个BOT

启动BOT

  1. 点击"启动"按钮
  2. BOT恢复运行
  3. 重新响应用户请求

删除BOT

  1. 点击"删除"按钮
  2. 系统提示确认
  3. 确认后BOT被删除

警告：

  • 删除操作不可恢复
  • 删除后客户数据保留
  • 但BOT将无法继续服务

查看详情

点击BOT记录查看详细信息：

  • BOT配置信息
  • 使用统计数据
  • 客户列表
  • 交互记录
  • 错误日志

复制信息

快速复制BOT信息：

  • 点击Token旁的复制按钮
  • 点击BOT链接旁的复制按钮
  • 方便分享给用户

BOT管理

BOT配置

进入BOT详情页可以配置：

  1. 欢迎消息

    • 用户首次添加BOT时的欢迎语
    • 可以包含使用说明

  2. 命令菜单

    • 配置BOT支持的命令
    • 设置命令描述

  3. 自动回复

    • 设置关键词自动回复
    • 配置常见问题解答

  4. 订单处理

    • 配置订单流程
    • 设置价格和支付方式

BOT监控

监控BOT的运行状况：

  1. 状态监控

    • BOT是否在线
    • 响应速度
    • 错误率

  2. 使用统计

    • 每日交互次数
    • 新增用户数
    • 订单转化率

  3. 异常告警

    • BOT掉线告警
    • Token失效告警
    • 高错误率告警

BOT优化

根据数据优化BOT：

  1. 分析数据

    • 查看用户使用习惯
    • 统计高频问题
    • 分析流失原因

  2. 优化流程

    • 简化操作步骤
    • 改进提示信息
    • 增加引导功能

  3. 提升体验

    • 加快响应速度
    • 丰富功能
    • 完善错误处理

使用技巧

多BOT策略

根据不同需求创建多个BOT：

  1. 按地区划分

    • 不同地区使用不同BOT
    • 便于统计和管理

  2. 按渠道划分

    • 不同推广渠道使用不同BOT
    • 便于跟踪效果

  3. 按功能划分

    • 订单BOT
    • 客服BOT
    • 营销BOT

BOT推广

有效推广您的BOT：

  1. 获取BOT链接

  2. 推广渠道

    • 社交媒体
    • 网站和博客
    • 邮件营销
    • 代理渠道

  3. 推广文案

    • 突出BOT的价值
    • 说明使用方法
    • 提供优惠信息

Token安全

保护BOT Token安全：

  1. 安全存储

    • 不要在代码中硬编码
    • 不要分享给他人
    • 定期更换

  2. 权限控制

    • 只授予必要权限
    • 定期审查权限
    • 及时撤销不用的BOT

  3. 异常处理

    • 发现Token泄露立即更换
    • 监控异常使用
    • 做好备份

常见问题

BOT无法添加

可能原因：

  • Token格式错误
  • Token已被使用
  • Token已失效

解决方法：

  1. 检查Token格式
  2. 确认Token未被其他系统使用
  3. 在BotFather中重新生成Token

BOT无响应

可能原因：

  • BOT被暂停
  • Token失效
  • Telegram服务问题
  • 网络连接问题

解决方法：

  1. 检查BOT状态
  2. 验证Token是否有效
  3. 检查网络连接
  4. 查看错误日志

BOT被封禁

可能原因：

  • 违反Telegram政策
  • 发送垃圾信息
  • 被大量用户举报

解决方法：

  1. 联系Telegram支持
  2. 检查BOT行为
  3. 整改后申请解封
  4. 如无法解封则创建新BOT

注意事项

  1. 遵守规则

    • 遵守Telegram使用政策
    • 不发送垃圾信息
    • 尊重用户隐私

  2. 稳定运行

    • 确保服务器稳定
    • 定期检查BOT状态
    • 及时处理异常

  3. 数据备份

    • 定期备份BOT配置
    • 保存重要数据
    • 防止数据丢失

  4. 用户体验

    • 优化响应速度
    • 完善功能设计
    • 及时回应反馈

相关页面

Bot CustomersBot Orders