💬 ИИ-ассистенты

ИИ-бот для Telegram: реализация от стека до публикации

ИИ-бота для Telegram на YandexGPT или GigaChat можно собрать за 2–4 недели на Python + aiogram. Разбираем стек, API, публикацию через @BotFather, разметку и примеры проектов в РФ.

Денис Закаев, ИИ-архитектор, IDEA
Денис Закаев
ИИ-архитектор, IDEA
📅 18 мая 202610 мин👁
✈️
Короткий ответ

ИИ-бота для Telegram собирают за 2–4 недели на Python + aiogram + YandexGPT или GigaChat. Регистрируете бота через @BotFather, пишете webhook, подключаете LLM по API, настраиваете базу знаний через RAG и публикуете на VPS в РФ. Базовый бюджет — от 150 000 ₽.

Почему Telegram для ИИ-ботов

В РФ Telegram — самый удобный канал для ИИ-ассистента:

  • Открытый API, не требует одобрения магазина приложений.
  • Низкий порог входа: @BotFather выдаёт токен за 2 минуты.
  • Поддержка кнопок, инлайн-режима, веб-апп, медиа, файлов.
  • Аудитория привыкла к ботам, не нужно обучать пользователей.
  • Нет ограничений WhatsApp Business API и очередей на верификацию.

Минусы: нет нативной очереди операторов (делают сами), ограничения по длине сообщения (4096 символов), ограничения на рассылки во избежание бана.

Стек разработки

СлойТехнологияАльтернативы
ЯзыкPython 3.11+Node.js (telegraf), Go (telebot)
Bot frameworkaiogram 3.xpyTelegramBotAPI, telegraf
БДPostgreSQLSQLite (для пилота), MongoDB
Векторное хранилищеpgvector, QdrantFAISS (локально), Chroma
LLMYandexGPT, GigaChatGPT-4 (зарубежный), локальная Llama
ОчередиCelery + RedisARQ, RQ
ХостингVPS в РФSelectel, Timeweb, RuVDS

Для несложных ботов без интеграций достаточно конструктора SaleBot, LeadConverter, Smartbot Pro — код не нужен.

Регистрация бота в @BotFather

Шаги публикации:

  1. Открываете @BotFather в Telegram, отправляете /newbot.
  2. Указываете имя (отображается) и username (заканчивается на bot).
  3. Получаете API-токен вида 123456:ABC-DEF....
  4. Настраиваете описание, аватар, команды через /setdescription, /setuserpic, /setcommands.
  5. Для публичного бота — включаете inline-режим через /setinline, если нужен.
  6. Токен храните в переменной окружения, в код не коммитите.

Для групп и каналов — отдельные настройки приватности (/setprivacy), иначе бот не видит сообщения участников.

Архитектура ИИ-бота

Минимальная схема с базой знаний:

Пользователь → Telegram → Webhook → Bot app (aiogram)
   → Контекстный менеджер (история диалога в БД)
   → RAG: векторный поиск по базе знаний
   → LLM (YandexGPT / GigaChat) с промптом и контекстом
   → Фильтр безопасности
   → Ответ → Telegram

Ключевые компоненты:

  • Контекстный менеджер — хранит историю каждого диалога в БД, подставляет последние N сообщений в промпт.
  • RAG-блок — превращает запрос пользователя в эмбеддинг, ищет топ-K релевантных кусков базы знаний, подставляет их в контекст LLM.
  • База знаний для ИИ — как её собирать и поддерживать.
  • Промпт — системный промпт задаёт роль, тон, границы, формат ответа.
  • Фильтр — проверка на запрещённые темы, персональные данные, токсичность.

Подключение YandexGPT и GigaChat

YandexGPT (Yandex Cloud)

  • Создаёте каталог в Yandex Cloud, включаете API.
  • Получаете service account + ключ.
  • Эндпоинты: chat completion, embeddings (для RAG), YandexGPT Pro и Lite.
  • Оплата по токенам, есть бесплатный лимит.

GigaChat (Сбер)

  • Регистрируйтесь в личном кабинете GigaChat API.
  • Получаете клиентский ID и секрет, авторизация по OAuth.
  • Эндпоинты: chat, embeddings.
  • Работает на русском, есть ценовая программа для бизнеса.

Оба провайдера — на русском, без VPN, отвечают требованиям по персональным данным при правильной конфигурации. Сравнение LLM — подробный разбор.

Webhook vs Polling

РежимКогдаПлюсыМинусы
PollingРазработка, низкая нагрузкаНе нужен белый IP, простотаЗадержки, нагрузка на сеть
WebhookПродакшенМгновенная реакция, масштабируемостьНужен HTTPS и стабильный сервер

Для прода — только webhook. Настраивается через setWebhook с указанием URL и сертификата (если самоподписной).

Примеры проектов в РФ

  • Бот поддержки интернет-магазина — отвечает по базе товаров, статусам заказов, условиям доставки. Стек: aiogram + YandexGPT + PostgreSQL.
  • Внутренний ассистент агентства — HR-вопросы, регламенты, поиск по Confluence. Стек: aiogram + GigaChat + pgvector.
  • Бот-консультант клиники — запись на приём, информация об услугах. На сложные вопросы — эскалация администратору.
  • Бот для курсов — расписание, материалы, ответы по программе. Интеграция с LMS.

Метрики и наблюдаемость

Минимальный набор для продакшена:

МетрикаЗачемИнструмент
Uptime ботадоступностьuptime-мониторинг (UptimeRobot, свой скрипт)
Latency ответаUXлогирование времени от запроса до ответа
Доля эскалаций на операторакачество ИИсчётчик в БД
Стоимость запросов к LLMбюджетлогирование токенов
Ошибки и исключениястабильностьSentry или аналог
Удовлетворённостьбизнес-эффекткнопка оценки после диалога

Контроль качества ответов ИИ — отдельная тема.

Безопасность и приватность

  • Не храните в логах полные переписки с ПДн без шифрования.
  • Используйте шифрование at-rest для БД.
  • Разделяйте продакшен и разработку, токены — только в секретах.
  • Соблюдайте 152-ФЗ: в публичном боте — политику обработки ПДн и согласие.
  • Регулярно обновляйте aiogram и зависимости, используйте rate-limit на свои эндпоинты.

Сроки и бюджет

ЭтапСрокОриентир, ₽
Прототип без интеграций1 неделя60–100 тыс.
Бот с базой знаний (RAG)2–3 недели150–250 тыс.
Интеграции (CRM, платежи, LMS)3–5 недель250–500 тыс.
Сопровождение в месяц30–80 тыс.

Плюс ежемесячные расходы на инфраструктуру и токены LLM: 3–15 тыс. ₽ при небольшом трафике, выше — пропорционально нагрузке.

ИИ-бот в Telegram — это зрелый, предсказуемый проект. Стек известен, API стабильны, кейсы обкатаны. Главное — не пытаться сразу заменить ботом всё: начните с одного сценария, обкатайте, расширяйте.

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

На чём писать ИИ-бота для Telegram?
Популярный стек — Python 3.11+, aiogram 3.x, база PostgreSQL, векторное хранилище pgvector или Qdrant, LLM через API (YandexGPT, GigaChat). Для несложных ботов хватает конструктора SaleBot или LeadConverter.
Нужен ли свой сервер?
Да, для кастомного бота нужен VPS с поддержкой исходящих запросов к API Telegram. Хостинги в РФ — Timeweb, RuVDS, Selectel. Webhook рекомендуется для продакшена, polling — для разработки.
Какую LLM выбрать для РФ?
YandexGPT и GigaChat работают без VPN, на русском языке, с приемлемой ценой. GPT-4/Gemini требуют зарубежного аккаунта и обхода блокировок — для корпоративных проектов в РФ не рекомендуются.
Сколько стоит содержать ИИ-бота?
Инфраструктура (VPS + БД + API LLM) при небольшом потоке — 3–15 тыс. ₽ в месяц. При росте нагрузки основная статья — токены LLM: считайте по числу запросов и средней длине диалога.
Оцените материал:
0

Остались вопросы? Поможем

Эксперты IDEA ответят по теме материала или подскажут по вашему проекту. Свяжемся в течение дня, без навязывания.

Комментарии · 0