wintergram-userbot

Асинхронный MTProto-клиент для приватных Telegram-серверов, написанный с нуля на Python.

Особенности

• ✅ Полная поддержка MTProto — layers 167-232
• ✅ Асинхронный — построен на asyncio
• ✅ Приватные серверы — работает с кастомными MTProto-серверами
• ✅ События — NewMessage, MessageEdited, MessageDeleted
• ✅ Userbot режим — реагирует на свои собственные сообщения
• ✅ Редактирование сообщений — полная поддержка edit_message

Установка

pip install wintergram-userbot

Быстрый старт

import asyncio
from wintergram_userbot import WinterGramClient
from wintergram_userbot.api.updates import NewMessage

async def main():
    client = WinterGramClient()

    @client.on(NewMessage)
    async def on_message(event):
        if event.out and ".test" in (event.text or "").lower():
            # Редактируем своё сообщение
            chat = event.sender_id if event.is_private else event.chat_id
            await client.edit_message(chat, event.id, "userbot работает")

    phone = input("Номер телефона (с '+'): ")
    await client.start(phone=phone)

    print("Бот запущен!")
    try:
        while True:
            await asyncio.sleep(3600)
    except KeyboardInterrupt:
        pass
    finally:
        await client.disconnect()

if __name__ == "__main__":
    asyncio.run(main())

Документация

События

NewMessage

Новое сообщение в чате:

@client.on(NewMessage)
async def handler(event):
    print(f"Сообщение: {event.text}")
    print(f"От: {event.sender_id}")
    print(f"Чат: {event.chat_id}")
    print(f"Исходящее: {event.out}")

MessageEdited

Редактирование сообщения:

@client.on(MessageEdited)
async def handler(event):
    print(f"Отредактировано: {event.text}")

MessageDeleted

Удаление сообщения:

@client.on(MessageDeleted)
async def handler(event):
    print(f"Удалены: {event.deleted_ids}")

Методы клиента

send_message

Отправка сообщения:

await client.send_message(chat_id, "Текст сообщения")
await client.send_message("me", "В Избранное")

edit_message

Редактирование сообщения:

await client.edit_message(chat_id, message_id, "Новый текст")

get_history

Получение истории чата:

history = await client.get_history(chat_id, limit=50)

Свойства события

• event.id — ID сообщения
• event.text — текст сообщения (всегда str)
• event.date — время отправки
• event.chat_id — ID чата
• event.sender_id — ID отправителя
• event.out — True если это ваше сообщение
• event.is_private — True если личное сообщение
• event.is_channel — True если сообщение из канала
• event.from_channel — True если отправлено каналом
• event.message — внутренний dict сообщения (текст тоже str)

Требования

• Python 3.8+
• asyncio

Лицензия

MIT License

Автор

femboychik

Поддержка

Вопросы и issue: GitHub Issues