Выбор технологического стека
Для Telegram ботов в Казахстане я рекомендую Python + aiogram 3. Это самый зрелый стек с лучшей документацией на русском языке.
Python + aiogram 3 — самый популярный вариант. Асинхронный, с отличной поддержкой Telegram Bot API 7.x. Идеален для ботов с платежами и Mini Apps.
TypeScript + grammY — если проект требует высокой производительности или у вас уже есть Node.js инфраструктура. BullMQ для очередей, Prisma для ORM.
Что выбрать: Для 90% бизнес-ботов в Казахстане — aiogram 3. Для сложных SaaS-продуктов с React-дашбордами — grammY + TypeScript.
Ключевые зависимости: aiohttp для HTTP-запросов, SQLAlchemy/Tortoise для ORM, Redis для кэширования сессий.
Архитектура бота: от простого к масштабируемому
Не начинайте с микросервисов. Начните с монолита и разделяйте по мере роста.
Уровень 1 — Простой бот: Один файл, обработчики команд, SQLite. Подходит для MVP и ботов с <100 пользователей/день.
Уровень 2 — Модульный бот: Разделение на хендлеры, мидлвари, сервисы. PostgreSQL вместо SQLite. Redis для сессий. Docker для деплоя.
Уровень 3 — SaaS-бот: Multi-tenant архитектура, очереди задач (Celery/BullMQ), API для внешних интеграций, мониторинг и алертинг.
Практический совет: всегда используйте мидлвари для логирования, rate limiting и обработки ошибок. Это спасёт вас при масштабировании.
Интеграция с Kaspi: автоверификация чеков
Kaspi — главная платёжная система Казахстана. Интеграция с ней — must-have для любого коммерческого бота.
Как это работает: Пользователь оплачивает через Kaspi, отправляет номер чека или PDF в бот. Бот проверяет чек через фискальный API и автоматически выдаёт доступ.
Ключевые моменты:
- Валидация формата чека (12-значный номер)
- Проверка суммы и получателя
- Детекция дублей (один чек = одна активация)
- Обработка частичных оплат
- Таймауты и ретраи при недоступности API
Альтернативы Kaspi: Robokassa (для РФ клиентов), Prodamus, CryptoPay (крипта через Telegram). Часто в одном боте подключены 2-3 платёжные системы.
Mini App: когда кнопок бота недостаточно
Telegram Mini App — это полноэкранное веб-приложение внутри Telegram. Используйте его, когда бот-интерфейс ограничивает UX.
Когда нужен Mini App:
- Каталог товаров с фильтрами и поиском
- Многошаговые формы (> 4 шагов)
- Дашборды со статистикой
- Курсы с прогресс-баром
- QR-сканеры
Технологии: HTML/CSS/JS для простых случаев, React для сложных. Telegram WebApp SDK для доступа к данным пользователя и закрытия Mini App.
Важно: Mini App должен быть mobile-first. 85% пользователей Telegram в Казахстане — мобильные.
Деплой и инфраструктура
Для казахстанского рынка я рекомендую VPS в регионах Европа или Россия (минимальная задержка к серверам Telegram).
Стандартный стек деплоя:
- Docker + Docker Compose
- Caddy как реверс-прокси (автоматический HTTPS)
- Cloudflare для DNS и DDoS-защиты
- GitHub Actions для CI/CD
Мониторинг: Health check эндпоинт, алерты в Telegram при падении, логирование в файл + ротация.
Стоимость: VPS от $5/мес (Hetzner, Timeweb). Для большинства ботов достаточно 2 vCPU / 4 GB RAM.
Webhook vs Polling: Для продакшена — только вебхук. Polling годится только для разработки.