📦 产品简介

Telegram Support Bot 是一款功能强大的双向客服机器人系统，专为需要在 Telegram 上提供客户支持服务的企业和团队设计。通过话题模式或私聊模式，实现用户与客服团队之间的无缝沟通。

✨ 核心功能

🔄 双向消息转发

  • 话题模式：每个用户自动创建独立话题，消息井井有条
  • 私聊模式：管理员直接回复转发消息，简单高效
  • 消息类型全支持：文字、图片、视频、文件、语音、贴纸等
  • 消息撤回同步：用户或客服撤回消息，双方同步删除

📋 工单管理系统

  • 自动创建工单：用户咨询自动生成工单编号
  • 优先级识别：🔴 紧急 | 🟠 高 | 🟢 普通 | ⚪ 低
  • 智能关键词：自动识别「紧急」「重要」等关键词设置优先级
  • 工单状态追踪：待处理、处理中、已关闭

🛡️ 用户验证系统

  • 多种验证方式：按钮验证 / Emoji验证 / WebApp验证 / 强制关注
  • Cloudflare Turnstile：集成人机验证，防止恶意刷屏
  • 频道/群组强制关注：支持公开和私密频道
  • 验证失败处理：自动封禁恶意用户

📢 投稿审核系统

  • 用户投稿：支持文字、图片、视频等多媒体投稿
  • 管理员审核：一键通过或拒绝，支持拒绝理由
  • 自动发布：审核通过后自动发布到指定频道
  • 匿名投稿：可配置是否允许匿名
  • 投稿限制：每日投稿数量、冷却时间可配置

📊 数据统计与报表

  • 每日自动报表：工单数量、处理效率、用户满意度
  • SLA 指标追踪：平均响应时间、首次响应时间
  • 用户评价系统：1-5星评分，工单关闭后自动请求评价
  • 分类统计：按问题类型统计工单分布

🤖 智能自动回复

  • 关键词触发：设置关键词自动回复常见问题
  • FAQ 系统：预设常见问题快速回复
  • 欢迎消息：新用户自动发送欢迎引导
  • LLM 集成：支持接入 AI 大模型智能回复

👥 多管理员协作

  • 多管理员支持：可添加多个客服人员
  • 权限分级：超级管理员、普通管理员
  • 工单分配：可指定工单给特定客服处理

🛠️ 技术架构

  • 开发语言：Python 3.12
  • Telegram API：aiogram 3.x (异步高性能)
  • 数据库：SQLite / PostgreSQL (可切换)
  • ORM：SQLAlchemy 2.0 (异步)
  • 配置管理：Pydantic Settings
  • 部署方式：Docker & Docker Compose

📱 用户命令

  • /start – 开始使用机器人
  • /help – 查看帮助信息
  • /myprofile – 查看个人档案
  • /updateprofile – 更新个人信息

🔧 管理员命令

  • /reply ID 消息 – 回复指定工单
  • /close ID – 关闭工单
  • /add_category 名称 – 添加问题分类
  • /stats – 查看统计数据
  • /broadcast 消息 – 群发消息

🎯 适用场景

  • ✅ 电商客服系统
  • ✅ 社区/频道管理
  • ✅ 技术支持服务
  • ✅ 企业内部沟通
  • ✅ 投稿审核平台
  • ✅ 用户反馈收集

📦 交付内容

  • ✅ 完整源代码
  • ✅ Docker 部署配置
  • ✅ 详细部署文档
  • ✅ 配置说明文档
  • ✅ 数据库迁移脚本

💬 售后支持

  • ✅ 部署指导
  • ✅ 基础使用培训
  • ✅ Bug 修复支持