Прокси Telegram API

Прокси Telegram API по адресу /tgapi/bot{TOKEN}/{method} прозрачно перенаправляет все запросы на api.telegram.org.

Использование

Замените базовый URL Telegram API в вашем бэкенде:

# До
https://api.telegram.org/bot{TOKEN}/{method}

# После
http://localhost:8080/tgapi/bot{TOKEN}/{method}

Загрузка файлов

Отдельный эндпоинт для загрузки файлов доступен по адресу /tgapi/file/bot{TOKEN}/{file_path}. Это делает BotMux полной заменой URL загрузки файлов Telegram, позволяя настроить его как base_file_url в вашей библиотеке ботов:

# До
https://api.telegram.org/file/bot{TOKEN}/{file_path}

# После
http://localhost:8080/tgapi/file/bot{TOKEN}/{file_path}

Файлы WebP (стикеры) автоматически конвертируются в PNG. Типы контента определяются по расширению файла с fallback на определение по содержимому. Ответы включают заголовок Cache-Control: public, max-age=86400.

Аутентификация

Дополнительная аутентификация не требуется — токен бота в URL является авторизацией (аналогично Telegram API).

Перехват сообщений

Для методов отправки прокси извлекает отправленное сообщение из ответа Telegram и сохраняет его в базу данных.

Перехватываемые методы

Ряд методов Telegram Bot API перехватывается и обрабатывается BotMux вместо пересылки в Telegram:

Метод	Поведение
`setWebhook`	Настраивает URL бэкенда бота в BotMux и включает режим прокси. Автоматически регистрирует неизвестных ботов через `getMe`. Поддерживает параметры `url` и `drop_pending_updates`.
`deleteWebhook`	Очищает URL бэкенда и отключает режим прокси. Поддерживает `drop_pending_updates`.
`getWebhookInfo`	Возвращает внутреннее состояние вебхука BotMux (`url`, `pending_update_count`, `has_custom_certificate`, `max_connections`, `ip_address`).
`getUpdates`	Когда включён long polling, обслуживается из внутренней очереди BotMux вместо пересылки в Telegram. Когда бот управляется BotMux, но long polling не включён, возвращает пустой результат для предотвращения конфликтов.
`logOut`	Возвращает `{"ok": true, "result": true}` без пересылки. Предотвращает отключение токена на 10 минут.
`close`	Возвращает `{"ok": true, "result": true}` без пересылки. Предотвращает остановку экземпляра бота на стороне Telegram.

⌘I

Боты

Чаты

Сообщения

Пользователи

Администраторы

Теги

Маршруты

Аналитика и аудит

Длинный опрос и прокси

Прокси Telegram API

Использование

Загрузка файлов

Аутентификация

Перехват сообщений

Перехватываемые методы

​Использование

​Загрузка файлов

​Аутентификация

​Перехват сообщений

​Перехватываемые методы

Использование

Загрузка файлов

Аутентификация

Перехват сообщений

Перехватываемые методы