Интеграция: бот как мост

Сам по себе echo-бот бесполезен. Ценность - когда бот становится мостом: пользователь пишет в чат, бот зовёт ваш бэкенд или внешний сервис, получает результат и возвращает его в Telegram.

Бот зовёт API и LLM

Схема простая:

То есть бот - это тонкий слой ввода-вывода поверх вашей логики. Как именно дёргать внешние API из кода, разобрано в гайде про API. Если подключаете языковую модель - смотрите подключение LLM по API: там про ключи, запросы и форматы ответа.

Практически: в обработчике сообщения из прошлого раздела вместо message.answer(message.text) вы вызываете свою функцию (запрос к API или LLM) и отвечаете её результатом.

Webhook от внешних систем

Мост работает и в обратную сторону. Внешняя система (платёжка, мониторинг, CRM) шлёт вам webhook - HTTP-запрос о событии. Ваш сервер принимает его и через бота отправляет уведомление нужному пользователю: «пришёл платёж», «упал сервис», «новая заявка».

Не путайте с webhook самого Telegram (способ доставки сообщений боту из раздела 02) - это разные вещи с одинаковым названием. Здесь речь про входящие уведомления от ваших сервисов, которые бот пересылает в чат.

Деплой бота на сервер

Чтобы бот работал круглосуточно, а не пока открыт терминал, его выносят на сервер. Бот - это обычный фоновый процесс: его запускают, например, в Docker и держат всегда включённым. Как поднять сервер и развернуть процесс - в гайде Серверы и деплой.

На сервере с доменом и HTTPS уже имеет смысл переключить бота с polling на webhook (см. раздел 02) - так Telegram сам шлёт сообщения на ваш URL.

Зарубежные AI из РФ

Если бот ходит в зарубежную модель (например, недоступную из России напрямую), запросы к ней нужно проксировать. Два пути:

• Прокси для AI API - сервер ходит во внешний AI через прокси. Это правильный способ для продакшена.
• VPN через Happ - вариант для локальной разработки и тестов.