GraceHub Platform

GraceHub — это SaaS платформа, которая позволяет вам развернуть свою поддержку прямо в телеграм, а так же становиться поставщиком услуги по созданию ботов обратной связи и технической поддержки.

🌐 Сайт: gracehub.ru
📢 Telegram канал: @gracehubru
👨‍💻 Разработчик: @Gribson_Micro
🗺️ Roadmap: ROADMAP.md

📱 Скриншоты

Стартовая страница	Дашборд	Добавление бота
Раздел оплаты, в котором было убито много времени	Главный бот, где можно привязать бота поддержки	Меню админа бота поддержки пользователей
Приходит месседж от клиента	Меню работы с тикетом	Ответ клиенту

Функционал

• Главный бот — центральная точка привязки всех ботов обратной связи
• Mini App личный кабинет — интерфейс для управления ботами и клиентами
• Статистика и аналитика — отслеживайте метрики по каждому боту
• Система биллинга — рассчёт и управление платежами

🌍 Поддерживаемые языки

• 🇷🇺 Русский
• 🇬🇧 English
• 🇪🇸 Español
• 🇮🇳 हिन्दी
• 🇨🇳 简体中文

📁 Структура

gracehub/
├── src/
│   └── master_bot/
│       ├── main.py                 # Точка входа мастер‑бота
│       ├── api_server.py           # REST API сервер
│       └── worker/                 # Воркеры для инстансов
├── frontend/miniapp_frontend/      # React приложение
├── config/                         # Конфигурационные файлы
├── scripts/
│   └── launch.sh                   # Скрипт запуска
├── logs/                           # Логи приложения
└── .env                            # Переменные окружения

💳 Платёжки

Под капотом следующие шлюзы/системы:

📋 Требования

⚙️ Подготовка окружения

1. В каталог проекта:

2. Создайте файл окружения и заполните его:

3. Создайте виртуальное окружение:

ВНИМАНИЕ: На 3.13 python ошибка установки pydantic-core. Лучше пользоваться версией ниже.

🚀 Запуск для разработки

Обычный режим (с логами в терминале)

Фоновый режим

Запуск включает три процесса:

• мастер‑бот
• REST API сервер
• frontend приложение

🔧 Продакшен‑деплой через systemd

Первичная настройка и деплой

Управление сервисами

После развертывания управление осуществляется через systemd:

📊 Логи и мониторинг

Для режима разработки

Логи находятся в каталоге

Для продакшена

Просмотр логов systemd:

🎯 Инструкция по использованию

После успешного деплоя следуйте этим шагам для настройки вашей поддержки:

Шаг 1: Подключение основного бота GraceHub

1. Найдите основного GraceHub Platform бота в Telegram (которого вы развернули на предыдущих шагах)
2. Нажмите Start или напишите
   /start
3. Бот предоставит вам личный кабинет и инструкции для управления

Шаг 2: Регистрация вашего бота поддержки

1. В основном боте выберите опцию добавления нового бота
2. Получите токен своего Telegram бота через @BotFather
3. Отправьте токен боту GraceHub Platform
4. Ваш бот поддержки будет активирован в системе

Шаг 3: Инициализация администратора

1. Напишите в ваш новый бот поддержки команду
   /start
2. Бот запомнит вас как администратора и даст доступ к управлению

Шаг 4: Создание суперчата с топиками

1. Создайте новую группу в Telegram
2. В параметрах группы включите режим "Обсуждения" (Topics)
3. Добавьте вашего бота поддержки в эту группу с правами администратора
4. Убедитесь, что боту даны права на управление сообщениями и топиками

Шаг 5: Привязка бота к топику General

1. Откройте топик General в вашем суперчате
2. Напишите команду привязки:

/bind @your_bot_username

Замените

3. После успешной привязки бот начнет принимать обращения клиентов в этом топике
4. Все сообщения от клиентов будут автоматически распределяться по топикам в суперчате

✅ Готово!

Ваша система поддержки в Telegram полностью настроена. Клиенты вашего бизнеса смогут писать боту, а вы будете видеть все обращения в удобном интерфейсе суперчата с разделением по топикам.

📄 Лицензия

MIT