Skip to content

messages.rst

Latest commit

 

History

History
148 lines (106 loc) · 5.16 KB

messages.rst

File metadata and controls

148 lines (106 loc) · 5.16 KB

Messages

Что это

Message - объект сообщения Max. Он содержит текст, ID чата, отправителя, вложения и удобные методы: answer(), reply(), pin(), delete(), read(), react() и unreact().

Принимать сообщения

from pymax import Client, Message, MessageDeleteEvent

client = Client(phone="+79990000000", work_dir="cache")


@client.on_message()
async def on_message(message: Message, client: Client) -> None:
    print(message.text)


@client.on_message_edit()
async def on_edit(message: Message, client: Client) -> None:
    print("edited:", message.text)


@client.on_message_delete()
async def on_delete(event: MessageDeleteEvent, client: Client) -> None:
    print("deleted in chat:", event.chat.id)

Отправлять сообщения

Через клиент:

await client.send_message(chat_id=123456, text="Привет")

Через сообщение из handler-а:

@client.on_message()
async def on_message(message: Message, client: Client) -> None:
    await message.answer("Ответ в тот же чат")
    await message.reply("Ответ реплаем")

Ответ, реакции, удаление и прочтение

@client.on_message()
async def on_message(message: Message, client: Client) -> None:
    if message.text == "/pin":
        await message.pin()
    elif message.text == "/read":
        await message.read()
    elif message.text == "/like":
        await message.react("👍")
    elif message.text == "/reactions":
        reactions = await message.get_reactions()
        print(reactions)
    elif message.text == "/delete":
        await message.delete(for_me=False)

История сообщений

history = await client.fetch_history(chat_id=123456, backward=50)
for message in history or []:
    print(message.id, message.text)

fetch_history() принимает item_type. По умолчанию используются обычные сообщения; для отложенных сообщений передайте ItemType.DELAYED из pymax.api.messages.enums.

Почему поля бывают None

Max присылает разные формы событий. Некоторые payload-ы содержат полный объект сообщения, а некоторые - только часть данных. Поэтому Message.chat_id, sender, attaches, reaction_info, status и другие поля могут быть пустыми.

Практическое правило: перед действиями, которым нужен чат, проверяйте message.chat_id.

@client.on_message()
async def on_message(message: Message, client: Client) -> None:
    if message.chat_id is None:
        return

    await message.answer("ok")

Вложения

Входящие вложения лежат в message.attaches. Тип вложения определяется по полю type: фото, видео, файл, стикер, аудио, контакт, звонок, share или inline-клавиатура.

from pymax import Client, Message
from pymax.types.domain import FileAttachment, PhotoAttachment

@client.on_message()
async def on_message(message: Message, client: Client) -> None:
    if message.chat_id is None:
        return

    for attach in message.attaches:
        if isinstance(attach, PhotoAttachment):
            print("photo:", attach.photo_id, attach.base_url)
        elif isinstance(attach, FileAttachment):
            file_info = await client.get_file_by_id(
                chat_id=message.chat_id,
                message_id=message.id,
                file_id=attach.file_id,
            )
            print(file_info.url if file_info else "no url")

Частые ошибки

Message is not bound to a client
Методы message.answer() и похожие работают на сообщениях, полученных через клиент. Если вы создали Message вручную через Pydantic, он не знает, каким клиентом выполнить действие.
Message does not contain chat_id
В событии нет ID чата. Используйте client.send_message(...) только если знаете chat_id из другого источника.
Pydantic validation error на attachments
Max мог прислать новый или неполный тип вложения. Включите debug-логи, посмотрите raw payload через on_raw и обновите PyMax или добавьте обработку нового формата.