Совместимость библиотек

Все популярные сторонние библиотеки для Bot API совместимы с нашей платформой — нужно только подменить базовый URL.

Поддерживаемые

Библиотека	Язык	Версия проверена	Метод подмены
aiogram 3.x	Python (async)	3.10+	`AiohttpSession(api=TelegramAPIServer.from_base(...))`
python-telegram-bot 20.x	Python (async)	20.7+	`.base_url('https://api.telefon.chat/bot')`
grammy	Node.js / TypeScript	1.30+	`{ client: { apiRoot: '...' } }`
Telegraf	Node.js / TypeScript	4.16+	`{ telegram: { apiRoot: '...' } }`
node-telegram-bot-api	Node.js	0.66+	`{ baseApiUrl: '...' }`
gotgbot	Go	2.0+	`BotApiURL` field
rust-telegram-bot	Rust	latest	`Api::with_url(token, url)`
Telegram.Bot	C# / .NET	19.0+	`new TelegramBotClient(token, baseUrl: "...")`
WPTelegram	PHP	5.0+	`apiUrl` configuration
TelegramBots	Java	6.7+	`telegramBotsApi.setBaseUrl(...)`

См. подробные примеры:

MTProto клиенты (pyrogram, telethon, MadelineProto, TDLib) — они работают на низкоуровневом протоколе мессенджера, не на HTTP Bot API. Не запустятся.
Очень старые версии (aiogram 1.x, python-telegram-bot 13.x) — могут иметь захардкоженный URL. Обновитесь.

✅ Все методы Bot API совместимы — sendMessage, sendPhoto, callbackQuery, inline_query и т.д.

✅ Multipart upload работает.

✅ Webhook принимается так же.

⚠️ Stars / Payments / Games — не реализованы. Соответствующие методы вернут 400 Bad Request.

⚠️ file_id у нас — это URL внутри нашего хранилища, а не короткий хеш. Большинство библиотек обрабатывают как opaque string и работают.

curl https://api.telefon.chat/bot<TOKEN>/getMe

Если возвращает JSON с инфой о боте — токен валиден, библиотека будет работать.

Напишите на dev@telefon.chat с указанием:

Мы добавим адаптацию.