Telegram Бот
@spb_ceramics_bot
🟢 Long Polling активен
Распознавание речи
Groq Whisper v3
🟢 Голосовые сообщения
Языковая модель
Cerebras gpt-oss-120b
🟢 Время ответа ~100 мс
Контроль версий
Git & Snapshots
🟢 Авто-бэкап + Undo
1. Активация и права администратора
Как подключиться к боту
В системе зарегистрированы два доверенных администратора:
587945969— основной администратор и мастер студии.290331404— Алексей (разработчик / системный администратор).
⚠️ Важно: Telegram запрещает ботам отправлять сообщения первым! Каждому администратору обязательно нужно открыть @spb_ceramics_bot и нажать кнопку «Запустить» (/start).
2. Голосовое управление и искусственный интеллект
Groq Whisper + Cerebras gpt-oss-120b
Вы можете не печатать текст на клавиатуре — просто нажмите и удерживайте значок микрофона в Telegram и надиктуйте команду обычной живой речью!
Примеры голосовых команд:
🛍 Добавление товара:
«Добавь в магазин: Чашка "Северное сияние", цена 2600 рублей, категория чашки, объем 300 миллилитров, в наличии 4 штуки»
«Добавь в магазин: Чашка "Северное сияние", цена 2600 рублей, категория чашки, объем 300 миллилитров, в наличии 4 штуки»
💰 Изменение цены или остатка:
«Поменяй цену у чашки Утренний туман на 2500 рублей и поставь остаток 2 штуки»
«Поменяй цену у чашки Утренний туман на 2500 рублей и поставь остаток 2 штуки»
🏺 Добавление арт-объекта в галерею:
«Добавь в галерею: Чайный сервиз Северный гранит, техника дровяной обжиг ноборигама, статус в частной коллекции»
«Добавь в галерею: Чайный сервиз Северный гранит, техника дровяной обжиг ноборигама, статус в частной коллекции»
📅 Новая дата в расписании мастер-классов:
«Добавь мастер-класс на субботу 26 сентября в 14:00 Свидание за кругом, 2 места, цена 7500 рублей»
«Добавь мастер-класс на субботу 26 сентября в 14:00 Свидание за кругом, 2 места, цена 7500 рублей»
📢 Объявление на главной странице:
«Поставь плашку на сайте: В эти выходные скидка 10% на всю посуду из шамотной глины!»
«Поставь плашку на сайте: В эти выходные скидка 10% на всю посуду из шамотной глины!»
3. Публикация фотографий (Photo Rails)
Как загружать фото прямо в каталог или галерею
Бот автоматически сохраняет отправленные снимки в максимальном качестве на сервер в папку /uploads/ и сразу привязывает их к карточке изделия:
- Способ А (Фото + подпись сразу): Прикрепите фото из галереи телефона и в поле «Добавить подпись» напишите или продиктуйте описание (например: Товар: Ваза "Морской риф", цена 4200 руб, категория вазы). Товар опубликуется мгновенно!
- Способ Б (Фото, затем выбор действия): Отправьте фото без подписи. Бот сохранит его и выдаст кнопки: [🛍 В каталог], [🏺 В галерею] или [🎨 К мастер-классу]. Нажмите нужную кнопку и надиктуйте детали.
4. Безопасность, Rails и отмена изменений
Почему сайт защищен от сбоев
В системе реализована архитектура безопасных ограничений («Rails»):
- Строгая валидация: Цены автоматически приводятся к положительным числам, категории проверяются по белому списку, а любые опасные скрипты отсекаются.
- Автоматический Snapshot перед каждым действием: Перед любым изменением базы данных создается резервная копия в папку
data/backups/. - Кнопка отмены [↩️ Отменить (Undo)]: После любого изменения бот присылает кнопку отмены. Одно нажатие — и сайт возвращается к состоянию до изменения! Также можно отправить команду /undo.
- Git-версионирование: Каждое изменение контента автоматически коммитится в локальный репозиторий Git, сохраняя полную историю изменений и автора.
5. Сводная таблица команд
Быстрые команды для администратора
| Команда | Описание | Пример использования |
|---|---|---|
| /start | Главное интерактивное меню | Быстрый доступ к каталогу и админке |
| /admin | Панель управления заказами и наличием | Переключение статусов товаров в 1 клик |
| /stats | Сводная аналитика студии | Количество заказов, записей на МК и товаров |
| /banner <текст> | Мгновенно изменить плашку на главной | /banner Скидка 10% на все вазы! |
| /undo | Откатить последнее изменение контента | Восстановление из последнего бэкапа |
| /git | Проверить статус версионирования | Показывает последние 4 коммита контента |
| /help | Краткая справка | Подсказка прямо в Telegram |