Enums¶
- class maxo.enums.AttachmentRequestType[исходный код]¶
Базовые классы:
StrEnumЗапрос на прикрепление данных к сообщению
- AUDIO = 'audio'¶
- CONTACT = 'contact'¶
- FILE = 'file'¶
- IMAGE = 'image'¶
- INLINE_KEYBOARD = 'inline_keyboard'¶
- LOCATION = 'location'¶
- SHARE = 'share'¶
- STICKER = 'sticker'¶
- VIDEO = 'video'¶
- __new__(value)¶
- class maxo.enums.AttachmentType[исходный код]¶
Базовые классы:
StrEnumОбщая схема, представляющая вложение сообщения
- TEXT = 'text'¶
- UNKNOWN = 'unknown'¶
- AUDIO = 'audio'¶
- CONTACT = 'contact'¶
- FILE = 'file'¶
- IMAGE = 'image'¶
- INLINE_KEYBOARD = 'inline_keyboard'¶
- LOCATION = 'location'¶
- SHARE = 'share'¶
- STICKER = 'sticker'¶
- VIDEO = 'video'¶
- DOCUMENT = 'file'¶
- PHOTO = 'image'¶
- __new__(value)¶
- class maxo.enums.ButtonType[исходный код]¶
Базовые классы:
StrEnum- CALLBACK = 'callback'¶
- CLIPBOARD = 'clipboard'¶
- LINK = 'link'¶
- MESSAGE = 'message'¶
- OPEN_APP = 'open_app'¶
- REQUEST_CONTACT = 'request_contact'¶
- REQUEST_GEO_LOCATION = 'request_geo_location'¶
- __new__(value)¶
- class maxo.enums.ChatAdminPermission[исходный код]¶
Базовые классы:
StrEnumПрава администратора группового чата или канала
- ADD_ADMINS = 'add_admins'¶
- ADD_REMOVE_MEMBERS = 'add_remove_members'¶
- CAN_CALL = 'can_call'¶
- CHANGE_CHAT_INFO = 'change_chat_info'¶
- DELETE = 'delete'¶
- DELETE_MESSAGE = 'delete_message'¶
- EDIT = 'edit'¶
- EDIT_LINK = 'edit_link'¶
- EDIT_MESSAGE = 'edit_message'¶
- PIN_MESSAGE = 'pin_message'¶
- POST_EDIT_DELETE_MESSAGE = 'post_edit_delete_message'¶
- READ_ALL_MESSAGES = 'read_all_messages'¶
- WRITE = 'write'¶
- VIEW_STATS = 'view_stats'¶
- __new__(value)¶
- class maxo.enums.ChatStatus[исходный код]¶
Базовые классы:
StrEnumСтатус чата для текущего бота
- ACTIVE = 'active'¶
- CLOSED = 'closed'¶
- LEFT = 'left'¶
- REMOVED = 'removed'¶
- __new__(value)¶
- class maxo.enums.ChatType[исходный код]¶
Базовые классы:
StrEnumТип чата: диалог, чат
- CHANNEL = 'channel'¶
- CHAT = 'chat'¶
- DIALOG = 'dialog'¶
- PRIVATE = 'dialog'¶
- GROUP = 'chat'¶
- SUPERGROUP = 'chat'¶
- __new__(value)¶
- maxo.enums.ContentType¶
псевдоним для
AttachmentType
- class maxo.enums.MarkupElementType[исходный код]¶
Базовые классы:
StrEnum- EMPHASIZED = 'emphasized'¶
- HEADING = 'heading'¶
- HIGHLIGHTED = 'highlighted'¶
- LINK = 'link'¶
- MONOSPACED = 'monospaced'¶
- QUOTE = 'quote'¶
- STRIKETHROUGH = 'strikethrough'¶
- STRONG = 'strong'¶
- UNDERLINE = 'underline'¶
- USER_MENTION = 'user_mention'¶
- __new__(value)¶
- class maxo.enums.MessageLinkType[исходный код]¶
Базовые классы:
StrEnumТип связанного сообщения
- FORWARD = 'forward'¶
- REPLY = 'reply'¶
- __new__(value)¶
- maxo.enums.ParseMode¶
псевдоним для
TextFormat
- class maxo.enums.SenderAction[исходный код]¶
Базовые классы:
StrEnumДействие, отправляемое участникам чата. Возможные значения:
"typing\_on"- Бот набирает сообщение"sending\_photo"- Бот отправляет фото"sending\_video"- Бот отправляет видео"sending\_audio"- Бот отправляет аудиофайл"sending\_file"- Бот отправляет файл
- SENDING_AUDIO = 'sending_audio'¶
- SENDING_FILE = 'sending_file'¶
- SENDING_PHOTO = 'sending_photo'¶
- SENDING_VIDEO = 'sending_video'¶
- TYPING_ON = 'typing_on'¶
- MARK_SEEN = 'mark_seen'¶
- __new__(value)¶
- class maxo.enums.TextFormat[исходный код]¶
Базовые классы:
StrEnumФормат текста сообщения
- HTML = 'html'¶
- MARKDOWN = 'markdown'¶
- __new__(value)¶
- class maxo.enums.UpdateType[исходный код]¶
Базовые классы:
StrEnumОбъект
Updateописывает возможные события в чате или канале. Может возвращаться в следующих случаях:Вы подписались на обновления через Webhook - при наступлении события МАКС пришлёт [POST-запрос
/subscriptions](https://dev.max.ru/docs-api/methods/POST/subscriptions), который содержит объектUpdateВы отправили [GET-запрос /updates](https://dev.max.ru/docs-api/methods/GET/updates) для получения обновлений через Long Polling- в ответ вернётся объект
Update
>! Получение обновлений с помощью [Long Polling](/docs-api/methods/GET/updates) ограничено по скорости и сроку хранения событий - этот способ не подходит для production-окружения. Рекомендуем на всех этапах работы использовать [Webhook](https://dev.max.ru/docs-api/methods/POST/subscriptions)
Типы событий¶
bot\_added- бот добавлен в чат или каналbot\_started- пользователь впервые начал общение с ботом или возобновил после остановки - нажал соответствующую кнопку в настройках бота в МАКСbot\_stopped- пользователь остановил или удалил бота через настройки бота в МАКС. Во втором случае одновременно сbot\_stoppedвозвращается событиеdialog\_removedbot\_removed- бот удалён из чата или каналаchat\_title\_changed- пользователь изменил название чата или каналаdialog\_cleared- пользователь очистил историю диалога с ботомdialog\_muted- пользователь отключил уведомления в диалоге с ботомdialog\_unmuted- пользователь включил уведомления в диалоге с ботомdialog\_removed- пользователь удалил диалог с ботом. Вместе с этим событием одновременно возвращаетсяbot\_stopped- при удалении диалога бот останавливается автоматическиmessage\_callback- пользователь нажал на кнопку в чате или каналеmessage\_created- пользователь отправил новое сообщение или опубликовал постmessage\_edited- пользователь отредактировал сообщение в чате или каналеmessage\_removed- пользователь удалил сообщение из чата или каналаuser\_added- в чат или канал добавлен или перешёл по ссылке новый пользовательuser\_removed- пользователь удалён или покинул чат или канал
Свойства объекта Update¶
- BOT_ADDED = 'bot_added'¶
- BOT_REMOVED = 'bot_removed'¶
- BOT_STARTED = 'bot_started'¶
- BOT_STOPPED = 'bot_stopped'¶
- CHAT_TITLE_CHANGED = 'chat_title_changed'¶
- DIALOG_CLEARED = 'dialog_cleared'¶
- DIALOG_MUTED = 'dialog_muted'¶
- DIALOG_REMOVED = 'dialog_removed'¶
- DIALOG_UNMUTED = 'dialog_unmuted'¶
- MESSAGE_CALLBACK = 'message_callback'¶
- MESSAGE_CREATED = 'message_created'¶
- MESSAGE_EDITED = 'message_edited'¶
- MESSAGE_REMOVED = 'message_removed'¶
- USER_ADDED = 'user_added'¶
- USER_REMOVED = 'user_removed'¶
- __new__(value)¶
- class maxo.enums.UploadType[исходный код]¶
Базовые классы:
StrEnumТип загружаемого файла
Поддерживаемые форматы:
image: JPG, JPEG, PNG, GIF, TIFF, BMP, HEICvideo: MP4, MOV, MKV, WEBM, MATROSKAaudio: MP3, WAV, M4A и другиеfile: файл для загрузки. Поддерживаются распространённые форматы (например, .txt, .doc и другие). В случае передачи неподдерживаемого типа файла будет возвращена ошибкаFile extension is forbidden
> Значение
photoбольше не поддерживается. Если вы использовалиtype=photoв ранее созданных интеграциях - замените его наtype=image- AUDIO = 'audio'¶
- FILE = 'file'¶
- IMAGE = 'image'¶
- VIDEO = 'video'¶
- __new__(value)¶