> ## Documentation Index
> Fetch the complete documentation index at: https://docs.botmux.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Обратный прокси

> Пересылка обновлений Telegram на устаревшие вебхук-бэкенды

BotMux может опрашивать Telegram на предмет обновлений и пересылать их как вебхук POST-запросы на устаревшие бэкенды ботов (режим push).

## Настройка

1. Добавьте или отредактируйте бота в веб-интерфейсе
2. Включите режим **Proxy**
3. Укажите **Backend URL** — эндпоинт вебхука (например, `https://legacy-bot.example.com/webhook`)
4. При необходимости укажите **Secret Token** (отправляется в заголовке `X-Telegram-Bot-Api-Secret-Token`)
5. Сохраните

BotMux будет опрашивать Telegram и пересылать каждое обновление POST-запросом на URL бэкенда.

## Автоматическая настройка через прокси API

Если ваш бэкенд использует [прокси API](/docs/ru/features/api-proxy) (`/tgapi/`), вы можете пропустить ручную настройку. Когда ваш бэкенд вызывает `setWebhook` через прокси, BotMux автоматически:

1. Регистрирует бота (если ещё не зарегистрирован) через вызов `getMe` в Telegram
2. Устанавливает URL вебхука как URL бэкенда бота
3. Включает режим прокси
4. Начинает опрашивать Telegram и пересылать обновления на ваш бэкенд

Это означает, что вы можете направить существующего бота на `http://your-botmux:8080/tgapi/bot{TOKEN}/setWebhook`, и он настроится автоматически без ручных действий.

Аналогично, вызов `deleteWebhook` через прокси отключает пересылку и очищает URL бэкенда.

## Ответы вебхуков

Бэкенд может отвечать [в формате вебхук-ответа](https://core.telegram.org/bots/api#making-requests-when-getting-updates) — JSON с полем `method` — и BotMux проксирует его обратно в Telegram API.

## Мониторинг состояния

* Автоматические проверки состояния каждые 60 секунд
* Статус виден в панели управления
* Кнопка **CHECK WEBHOOK** в детальном просмотре бота для ручной проверки

## Двойной режим

Обратный прокси и режим управления могут быть активны одновременно для одного бота. Обновления одновременно пересылаются на бэкенд и сохраняются в базе данных.