Message¶

Модель сообщения MAX.

Message¶

class Message(MaxObject):
    sender: User | None = None
    recipient: Recipient
    timestamp: int = 0
    link: LinkedMessage | None = None
    body: MessageBody
    stat: MessageStat | None = None
    url: str | None = None

Поля¶

Поле	Тип	Описание
`sender`	`User \\| None`	Отправитель сообщения
`recipient`	`Recipient`	Получатель (чат или пользователь)
`timestamp`	`int`	Время отправки (Unix timestamp)
`link`	`LinkedMessage \\| None`	Ссылка на другое сообщение (ответ/пересылка)
`body`	`MessageBody`	Тело сообщения (текст + вложения)
`stat`	`MessageStat \\| None`	Статистика (просмотры для каналов)
`url`	`str \\| None`	URL сообщения

Методы¶

# Ответить в тот же чат
await message.answer(
    text: str | None = None,
    attachments: list | None = None,
    notify: bool | None = None,
    format: str | None = None,
    disable_link_preview: bool | None = None,
    keyboard: InlineKeyboardBuilder | InlineKeyboard | list | None = None,
) -> Message

# Ответить с цитированием
await message.reply(
    text: str | None = None,
    attachments: list | None = None,
    notify: bool | None = None,
    format: str | None = None,
    disable_link_preview: bool | None = None,
    keyboard: InlineKeyboardBuilder | InlineKeyboard | list | None = None,
) -> Message

# Удалить сообщение
await message.delete() -> bool

# Отредактировать текст
await message.edit_text(
    text: str | None = None,
    attachments: list | None = None,
    notify: bool | None = None,
    format: str | None = None,
    keyboard: InlineKeyboardBuilder | InlineKeyboard | list | None = None,
) -> bool

MessageBody¶

class MessageBody(MaxObject):
    mid: str                                           # ID сообщения
    seq: int = 0                                       # Порядковый номер
    text: str | None = None                            # Текст
    attachments: list[AttachmentUnion] | None = None   # Вложения (типизированные)
    markup: list[MarkupElement] | None = None          # Разметка текста

attachments — это discriminated union, поэтому каждый элемент приходит сразу как конкретный подкласс (PhotoAttachment, VideoAttachment и т.д.) без ручного разбора attachment.type. Подробнее см. Вложения.

Свойства html_text / md_text¶

MessageBody собирает готовый отформатированный текст из пары text + markup с корректным учётом UTF-16 оффсетов (важно для эмодзи и суррогатных пар — позиции в MarkupElement по спеке MAX API считаются в UTF-16 code units).

@property
def html_text(self) -> str: ...

@property
def md_text(self) -> str: ...

Тип markup	HTML	Markdown
`strong`	`<b>…</b>`	`…`
`emphasized`	`<i>…</i>`	`…`
`monospaced`	`<code>…</code>`	`…`
`strikethrough`	`<s>…</s>`	`~~…~~`
`underline`	`<u>…</u>`	`++…++`
`link`	`<a href="url">…</a>`	`[…](url)`
`user_mention`	`<a href="…">…</a>`	`[…](…)`

Текст между markup'ами в html_text автоматически экранируется (&, <, >). Пересекающиеся (overlapping) элементы разметки пропускаются — остаётся только первый по from_pos.

Пример:

@router.message()
async def handler(message: Message, bot):
    # Вместо ручной сборки <b>, <i> — сразу готовая строка
    await message.answer(text=message.body.html_text, format="html")

MarkupElement¶

Элемент разметки текста. MAX API возвращает разметку в виде массива элементов с позицией и длиной. Позиции from_pos и length измеряются в UTF-16 code units — MessageBody.html_text/md_text учитывают это автоматически.

from pydantic import Field

class MarkupElement(MaxObject):
    type: str                          # Тип разметки
    from_pos: int = Field(alias="from")  # Начало в тексте (UTF-16 code units)
    length: int                        # Длина (UTF-16 code units)
    url: str | None = None             # Только для link
    user_link: str | None = None       # Только для user_mention (@username)
    user_id: int | None = None         # Только для user_mention (ID)

Типы разметки (MarkupType):

Тип	Enum	Описание
`strong`	`MarkupType.STRONG`	Жирный
`emphasized`	`MarkupType.EMPHASIZED`	Курсив
`monospaced`	`MarkupType.MONOSPACED`	Моноширинный
`link`	`MarkupType.LINK`	Ссылка (+ поле `url`)
`strikethrough`	`MarkupType.STRIKETHROUGH`	Зачёркнутый
`underline`	`MarkupType.UNDERLINE`	Подчёркнутый
`user_mention`	`MarkupType.USER_MENTION`	Упоминание (+ `user_id`, `user_link`)

Пример:

@router.message()
async def handler(message: Message, bot):
    if message.body.markup:
        for el in message.body.markup:
            print(f"{el.type}: pos={el.from_pos}, len={el.length}")
            if el.type == "link":
                print(f"  url: {el.url}")
            if el.type == "user_mention":
                print(f"  user: {el.user_id} ({el.user_link})")

MessageStat¶

class MessageStat(MaxObject):
    views: int | None = None  # Количество просмотров

LinkedMessage¶

Ссылка на другое сообщение (ответ или пересылка).

class LinkedMessage(MaxObject):
    type: str                      # "forward" или "reply"
    sender: User | None = None     # Автор оригинала
    chat_id: int | None = None     # Чат оригинала
    message: MessageBody | None = None  # Тело оригинала

Recipient¶

class Recipient(MaxObject):
    chat_id: int | None = None     # ID чата
    chat_type: str | None = None   # Тип чата
    user_id: int | None = None     # ID пользователя (для ЛС)

NewMessageBody¶

Тело для создания/редактирования сообщений.

class NewMessageBody(MaxObject):
    text: str | None = None
    attachments: list[AttachmentRequest] | None = None
    link: NewMessageLink | None = None
    notify: bool | None = None
    format: str | None = None      # "html" или "markdown"

NewMessageLink¶

class NewMessageLink(MaxObject):
    type: str   # "reply" или "forward"
    mid: str    # ID сообщения

Исходные файлы¶

maxgram/types/message.py
maxgram/types/message_body.py
maxgram/types/markup.py
maxgram/types/message_stat.py
maxgram/types/linked_message.py
maxgram/types/recipient.py
maxgram/types/new_message_body.py
maxgram/types/new_message_link.py