Python-библиотека для работы с TrueConf Chatbot Connector⚓︎
python-trueconf-bot — это асинхронная Python-библиотека для API чат-ботов TrueConf Server, вдохновлённая философией aiogram. Если вы когда-то писали бота для Telegram на aiogram — переход на TrueConf будет максимально простым и безболезненным.
Установка⚓︎
Требования⚓︎
- Python 3.10+
- Поддерживаются ОС: Linux, macOS, Windows
- Рекомендуется использовать virtualenv или poetry для изоляции зависимостей
Установка через pip⚓︎
Сравнение с aiogram⚓︎
| Возможность | aiogram (Telegram) | python-trueconf-bot (TrueConf) |
|---|---|---|
| Асинхронность | asyncio | asyncio |
| Декораторы для роутинга | @router.message(...) | @router.message(...) |
| Фильтрация сообщений | F.text, F.photo, F.document | F.text, F.photo, F.document |
| Magic-filter | ✅ | ✅ |
| Алиасы (шорткаты) | message.answer(), message.reply() | message.answer(), message.reply() |
| Инициализация бота | Bot(token="...") | Bot(server,token="...") или Bot.from_credentials(server, login, password) |
| JSON → Python | Pydantic models | Mashumaro dataclasses |
| Транспорт | HTTPS + long polling / webhook | Асинхронный WebSocket |
| Работа с файлами | bot.get_file(...) + bot.download_file(...) | message.photo.download(), message.document.download(), bot.download_file_by_id(...) |
- Если у вас уже есть опыт с aiogram — код переносится почти без изменений.
- TrueConf API становится «человеческим»: вместо JSON-словарей вы работаете с Python-классами.
- Вы получаете удобный инструмент для интеграции ботов в корпоративные чаты TrueConf.