Свой Telegram-бот, который отвечает отчетом
Отчет нужен на ходу, а не после входа в очередной дашборд. Отправьте боту CSV прямо из чата — в ответ придут доля опоздавших ответов и HTML-отчет с графиками категорий и списком обращений. Команда /last вернет предыдущую сводку.
Скачать проект и пример CSV · Ключ LLM не нужен · Работает на шаблоне telegram-bot
В проекте только код самого бота: обработчик, отчет, настройки и тесты. Все остальное — прием вебхуков, повторы, порядок сообщений в чате, состояние диалога — выполняет шаблон telegram-bot, а разворачивает бота Claude Code с навыком manage-telegram-bot из плагина Just Run.
Что понадобится
- Claude Code с плагином Just Run, установленным и подключенным к аккаунту.
- Права на создание секретов, автоматизаций и одной песочницы из шаблона
telegram-bot. - Новый тестовый бот от @BotFather.
Если тариф не позволяет будить приостановленную песочницу входящим сообщением, навык предупредит об этом и оставит бота работать постоянно; тогда он считается работающей песочницей.
Токен остается на платформе
Claude не видит токен бота. Его сохраняете вы:
- Откройте Секреты → Новый секрет → Окружение и назовите секрет
tg-report-bot. - Добавьте
TELEGRAM_BOT_TOKENс токеном от BotFather. - Добавьте
TELEGRAM_WEBHOOK_SECRETи нажмите Сгенерировать рядом со значением. - Нажмите Создать секрет.
Второе значение — проверочный ключ вебхука: Just Run сверяет его в каждом апдейте от Telegram, поэтому чужие запросы до бота не доходят. Не вставляйте токен в чат; если это случилось, отзовите его в @BotFather командой /revoke и сохраните новый в секрет.
Запуск
Распакуйте telegram-report, откройте папку в Claude Code и попросите:
Разверни этот проект как Telegram-бота report-bot. Секрет бота — tg-report-bot.
Claude проверит, что в секрете есть оба ключа, создаст с ним песочницу и покажет список файлов, которые собирается отправить. После вашего подтверждения он загрузит их через tar и curl по одноразовой ссылке. В песочнице jr-bot deploy отберет файлы, запустит тесты проекта, активирует бота и проверит, что он отвечает. Затем Claude создаст автоматизацию для вебхука, подключит к ней Telegram и назовет @username бота.
Если тесты не прошли, бот не активируется, а Claude получит вывод тестов. Релиз будет отклонен, если среди файлов окажутся ключи доступа, базы данных или строка, похожая на токен бота.
Что получится
- Откройте личный чат с ботом и отправьте команду
/start. - Загрузите тестовый файл
support-tickets.csvкак документ. - Бот вернет готовый файл
support-report.html. Ожидаемая статистика внутри: 44 tickets · 40 measured responses · 11 late (27.5%). - Отправьте команду
/last, чтобы получить ту же сводку без повторной загрузки файла.
Скриншот выше собран локально тем же кодом, а не в интерфейсе реального Telegram-бота.
Как адаптировать
Отчет собирается в services/report.py, работа с Telegram — в handlers/report.py, а tests/test_report.py проверяет диалог на приложенном CSV. Тесты запускаются только в песочнице, при развертывании. Попросите Claude о конкретном изменении — категории вашей команды, колонки вашей выгрузки, — а затем:
Обнови report-bot.
Новая версия сначала проходит тесты в песочнице; если они не прошли, продолжает работать текущая. Обновление сохраняет сводки, адрес вебхука и проверочный ключ.
Обработчик читает CSV в оперативной памяти и хранит только последнюю сводку для каждого чата; Telegram и платформа хранят свою историю отдельно. Если бот упадет сразу после отправки ответа, ответ может прийти повторно — строгой гарантии доставки ровно один раз нет. Если тариф позволяет будить бота, его песочница приостанавливается после пяти минут простоя, и следующий апдейт ее будит; первый ответ после паузы приходит дольше.
Диагностика и удаление
Попросите Claude показать статус report-bot. Не будя бота, он покажет его состояние и последние запуски: в выводе каждого видно, обработан ли апдейт, пропущен или упал, с классом ошибки, но без текста сообщений. Подробный статус разбудит бота и дополнительно проверит вебхук в Telegram, а логи report-bot покажут журнал бота.
Когда закончите, попросите Claude удалить report-bot. Он назовет песочницу и автоматизации, которые удалит, и дождется вашего подтверждения. Затем уберет вебхук (если тот все еще указывает на этого бота), автоматизации и песочницу вместе с сохраненными сводками. Секрет останется: удалите tg-report-bot в разделе Секреты, если он больше не нужен. Сам бот в Telegram и уже отправленные файлы останутся в Telegram.
Дальше: запускайте задачу по расписанию, без сообщения в чат.