Repolode
bostrot

bostrot/telegram-support-bot

一款自托管的支持机器人,将 Telegram 或 Signal 消息转为员工群组中的工单,并可选 LLM 自动回复。

可替代:ZendeskIntercom

Star
615
Fork
205
未关闭 Issue
7
最近提交
18小时前

这是什么?

TSB 让用户在 Telegram 或 Signal 上给机器人发消息,每条消息都会在员工群组中生成一张工单,员工直接回复即可作答。图片和文件可双向转发,机器人会自动添加问候语。

除基础工单功能外,还支持工单分配、优先级、标签、内部备注、预设回复、按分类路由到不同员工群、升级规则、过期工单自动关闭和营业时间设置。统计功能包括 /stats 命令、每日摘要、CSAT 满意度调查,以及带 HMAC 签名的 Webhook。另提供网页聊天组件,以及实验性的 Slack 和 Discord 插件。

可选的 LLM 集成支持 OpenAI 及任何兼容 OpenAI 接口的服务。机器人基于你提供的知识库自动回答问题,知识库未覆盖时转为普通工单,也可对工单分类并翻译员工回复。项目需要 Node.js 24+ 和 MongoDB,也可通过 Docker Compose 一键部署。

核心功能

  • 01将用户消息转为工单发送到员工群,员工回复即可作答。
  • 02支持工单分配、优先级、标签、内部备注和预设回复。
  • 03按分类把工单路由到不同的员工群组。
  • 04支持 Telegram 或 Signal,并提供可嵌入的网页聊天组件。
  • 05可选基于自有知识库的 LLM 自动回复,并支持 AI 分类和翻译。
  • 06提供带签名的 Webhook、CSAT 满意度调查和统计命令。

适用场景

  • 通过 Telegram 员工群处理客户支持请求,员工直接回复。
  • 在 Signal 上运行社区或产品支持渠道,并由团队统一处理消息。
  • 基于 FAQ 形式的知识库自动回答常见问题,其余问题转交人工处理。
  • 通过带签名的 Webhook 将工单事件接入其他系统。

快速上手

  1. 1

    复制示例配置文件

    cp config/config-sample.yaml config/config.yaml
  2. 2

    在 config.yaml 中设置 bot_token、staffchat_id 和 owner_id,然后启动 Docker compose 服务栈

    docker compose up -d

使用前须知

  • 不使用 Docker 运行需要 Node.js 24+ 和 MongoDB 实例。
  • v5 存在破坏性变更,从旧版本升级时需要更新配置。
  • 可选的 AI 自动回复需要 OpenAI 或兼容接口的 API 密钥。

标签

常见问题

telegram-support-bot 是什么?
一款自托管的支持机器人,将 Telegram 或 Signal 消息转为员工群组中的工单,并可选 LLM 自动回复。 TSB 让用户在 Telegram 或 Signal 上给机器人发消息,每条消息都会在员工群组中生成一张工单,员工直接回复即可作答。图片和文件可双向转发,机器人会自动添加问候语。
telegram-support-bot 可以免费使用吗?用的什么许可证?
telegram-support-bot 以 GPL-3.0 许可证开源。用于商业产品前,请先确认许可证条款。
telegram-support-bot 还在维护吗?
活跃维护中。telegram-support-bot 最近一次提交是在 2026年10月20日。
telegram-support-bot 适合用来做什么?
通过 Telegram 员工群处理客户支持请求,员工直接回复。 在 Signal 上运行社区或产品支持渠道,并由团队统一处理消息。 基于 FAQ 形式的知识库自动回答常见问题,其余问题转交人工处理。 通过带签名的 Webhook 将工单事件接入其他系统。
telegram-support-bot 怎么安装和运行?
复制示例配置文件: cp config/config-sample.yaml config/config.yaml 在 config.yaml 中设置 bot_token、staffchat_id 和 owner_id,然后启动 Docker compose 服务栈: docker compose up -d
在哪里获取 telegram-support-bot?
源代码和安装说明在 GitHub 上:https://github.com/bostrot/telegram-support-bot

概要由 AI 根据项目 README 生成;GitHub 数据每日更新。

相关项目