Перейти к основному содержанию
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 (/tgapi/), вы можете пропустить ручную настройку. Когда ваш бэкенд вызывает setWebhook через прокси, BotMux автоматически:
  1. Регистрирует бота (если ещё не зарегистрирован) через вызов getMe в Telegram
  2. Устанавливает URL вебхука как URL бэкенда бота
  3. Включает режим прокси
  4. Начинает опрашивать Telegram и пересылать обновления на ваш бэкенд
Это означает, что вы можете направить существующего бота на http://your-botmux:8080/tgapi/bot{TOKEN}/setWebhook, и он настроится автоматически без ручных действий. Аналогично, вызов deleteWebhook через прокси отключает пересылку и очищает URL бэкенда.

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

Бэкенд может отвечать в формате вебхук-ответа — JSON с полем method — и BotMux проксирует его обратно в Telegram API.

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

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

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

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