Repolode
bostrot

bostrot/telegram-support-bot

Самостоятельно размещаемый бот поддержки, который превращает сообщения в Telegram или Signal в тикеты для группы сотрудников и при желании отвечает на них с помощью LLM.

Open source альтернатива:ZendeskIntercom

Звёзды
615
Форки
205
Открытые issues
7
Последний коммит
20 часов назад

Что это?

Telegram Support Bot (TSB) позволяет пользователям писать боту в Telegram или Signal. Каждое сообщение становится тикетом, который публикуется в группе сотрудников: администраторы отвечают на него в ответном сообщении. Фото и файлы пересылаются в обе стороны, а бот автоматически добавляет приветствие.

Помимо базовой работы с тикетами, бот поддерживает назначение ответственных, приоритеты, теги, внутренние заметки, шаблоны ответов, категории с маршрутизацией в разные группы сотрудников, правила эскалации, автоматическое закрытие неактивных тикетов и расписание работы. Для аналитики доступны команда /stats, ежедневная сводка, опросы CSAT и вебхуки с HMAC-подписями. Также есть виджет веб-чата и экспериментальные дополнения для Slack и Discord.

Интеграция с LLM необязательна и работает с OpenAI или любой совместимой с OpenAI конечной точкой. Она отвечает на вопросы по предоставленной вами базе знаний, при отсутствии ответа создает обычный тикет, а также может сортировать тикеты и переводить ответы сотрудников. Проект работает на Node.js 24+ с MongoDB или через стек Docker Compose.

Ключевые возможности

  • 01Пересылает сообщения пользователей в группу сотрудников в виде тикетов; сотрудники отвечают на них прямо в группе.
  • 02Поддерживает назначение ответственных, приоритеты, теги, внутренние заметки и шаблоны ответов.
  • 03Направляет тикеты в разные группы сотрудников в зависимости от категории.
  • 04Работает с Telegram и Signal; также доступен встраиваемый виджет веб-чата.
  • 05При желании автоматически отвечает с помощью LLM на основе вашей базы знаний, а также поддерживает AI-сортировку тикетов и перевод.
  • 06Предоставляет вебхуки, опросы CSAT и команды аналитики.

Сценарии использования

  • Обработка запросов в службу поддержки через группу Telegram, где сотрудники отвечают пользователям напрямую.
  • Организация канала поддержки сообщества или продукта в Signal с общей очередью для команды.
  • Автоматические ответы на типовые вопросы по базе знаний в формате FAQ с передачей остальных запросов сотрудникам.
  • Передача событий тикетов в другие системы через вебхуки с цифровой подписью.

Быстрый старт

  1. 1

    Скопируйте пример файла конфигурации

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

    Укажите bot_token, staffchat_id и owner_id в config.yaml, затем запустите стек Docker Compose

    docker compose up -d

Что важно знать

  • Для запуска без Docker необходимы Node.js 24 или новее и экземпляр MongoDB.
  • В версии 5 есть несовместимые изменения, поэтому при обновлении с более ранних версий нужно обновить конфигурацию.
  • Для необязательных автоматических ответов с помощью ИИ нужен ключ API OpenAI или совместимого сервиса.

Темы

Частые вопросы

Что такое telegram-support-bot?
Самостоятельно размещаемый бот поддержки, который превращает сообщения в Telegram или Signal в тикеты для группы сотрудников и при желании отвечает на них с помощью LLM. Telegram Support Bot (TSB) позволяет пользователям писать боту в Telegram или Signal. Каждое сообщение становится тикетом, который публикуется в группе сотрудников: администраторы отвечают на него в ответном сообщении. Фото и файлы пересылаются в обе стороны, а бот автоматически добавляет приветствие.
telegram-support-bot можно использовать бесплатно? Какая у него лицензия?
telegram-support-bot распространяется с открытым исходным кодом под лицензией GPL-3.0. Перед использованием в коммерческих продуктах проверьте условия лицензии.
telegram-support-bot всё ещё поддерживается?
Активно поддерживается. Последний коммит в telegram-support-bot — 20 окт. 2026 г..
Для чего можно использовать telegram-support-bot?
Обработка запросов в службу поддержки через группу Telegram, где сотрудники отвечают пользователям напрямую. Организация канала поддержки сообщества или продукта в Signal с общей очередью для команды. Автоматические ответы на типовые вопросы по базе знаний в формате FAQ с передачей остальных запросов сотрудникам. Передача событий тикетов в другие системы через вебхуки с цифровой подписью.
Как установить telegram-support-bot?
Скопируйте пример файла конфигурации: cp config/config-sample.yaml config/config.yaml Укажите bot_token, staffchat_id и owner_id в config.yaml, затем запустите стек Docker Compose: docker compose up -d
Где скачать telegram-support-bot?
Исходный код и инструкции по установке — на GitHub: https://github.com/bostrot/telegram-support-bot

Описание создано ИИ на основе README проекта. Статистика GitHub обновляется ежедневно.

Похожие проекты

Юридическая система для самостоятельного размещения: подготовка, проверка и управление договорами с AI-ассистентом Luna для исследований и анализа документов.

33712TypeScriptAGPL-3.0Обновлён 18 дней назад