Управление группами и каналами

Участники, приглашения, права и модерация групп и каналов. Нужные действия требуют соответствующих прав.

Здесь собраны команды администрирования групп. Вы сможете найти параметры участников, приглашений, прав и модерации перед изменением.

Участники, приглашения, права и модерация групп и каналов. Нужные действия требуют соответствующих прав.

Общие опции

Действуют на любую команду.

Опция	Что делает
`-V, --version`	output the version number.
`-v, --verbose`	more detail in what is shown: -v ids, -vv everything we know. По умолчанию: `0`.
`--json`	machine-readable output: one JSON value on stdout, nothing else.
`--jsonl`	machine-readable output: one JSON object per line, for streaming and jq.
`--quiet`	diagnostics off.
`--trace`	one line per request on stderr: ids and timings, never message content.
`--timeout <duration>`	give up on the whole command after this — 30s, 2m, 500ms.
`--offline`	answer from what was recorded and never connect; fails if nothing was.
`--no-input`	не запрашивать ввод и не открывать интерактивный вход; ввод через канал остаётся доступным.
`--max-input-bytes <bytes>`	максимальный размер буферизованного ввода в байтах (по умолчанию: 16777216).
`--max-output-bytes <bytes>`	максимальный размер машинного вывода в байтах (по умолчанию: 4194304; 0 отключает ограничение).
`--fields <paths>`	поля элементов или объекта через запятую: id,text; сохранять пагинацию и идентификаторы операций.
`--dry-run`	предварительно показать разобранные аргументы и разрешения перед выполнением действия.
`--yes`	go ahead without the question an ask level puts before a write.
`--record`	keep this run under `max runs` — ids and timings, never message content.
`--no-record`	do not keep it, whatever the configuration says.
`--serve`	start `max serve` in the background if it is not running (the default).
`--no-serve`	do not start it; log in on this command's own connection unless one is running.

Команды

`max chats create`

create a group or a channel; the people added are told

Меняет что-то в MAX.

max chats create <title> [person] [options]

Аргумент	Обязательность	Что это
`title`	обязательный	the group's name.
`person`	необязательный	people to add: an id, or part of a name.

Опция	Что делает
`--channel`	a private channel instead of a group; people join it by its link.

`max chats members`

who is in a group

`max chats members list`

everyone in a group, a page at a time, with their role and when they were last seen

max chats members list <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--limit <n>`	сколько показать.
`--page <n>`	какая страница, начиная с 1.
`--all`	все строки, без страниц.

`max chats members audit`

members that look like bots, each with its reasons — read from the member list and the local store; never one request per person, and it removes nobody

max chats members audit <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--budget <pages>`	at most this many pages of 200 members, a pause between them (default: 10).
`--min-score <n>`	only members scoring at least this; 1 lists everyone with a reason (default: 2).
`--deep <n>`	также полностью проверить первых n человек — профиль, фотографии и все их сообщения — по одному человеку в секунду; публичные списки блокировок относятся только к Telegram, поэтому ничего не отправляется.

`max chats members history`

who joined, who left and whose profile changed, oldest first — what chats members fetch recorded in the local store; never asks the messenger

max chats members history <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--since-time <time>`	ISO 8601, or 2h / 1d ago; everything recorded if not given.

`max chats members fetch`

read a group's whole member list into the local store's member history: who joined, who left, daily counts and profile changes; someone is recorded as gone only when every member was read

max chats members fetch <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--track`	также загружать его ежедневно, пока работает serve; chats tracking показывает и изменяет список таких чатов.
`--budget <pages>`	at most this many pages of 200 members, a pause between them (default: 10).

`max chats members add`

add people; they are told

Меняет что-то в MAX.

max chats members add <chat> <person> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	обязательный	ID или часть имени.

Опция	Что делает
`--history`	the people added also see the messages from before they came.

`max chats members remove`

remove people; their messages stay

Меняет что-то в MAX.

max chats members remove <chat> <person>

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	обязательный	ID или часть имени.

`max chats admins`

give or take back a member's admin rights

`max chats admins add`

make a member an admin with these rights

Меняет что-то в MAX.

max chats admins add <chat> <person> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	обязательный	ID или часть имени.

Опция	Что делает
`--can <rights>`	what they may do, comma-separated: read, members, admins, info, pin, link, post, edit, delete.

`max chats admins remove`

take an admin's rights back; they stay a member

Меняет что-то в MAX.

max chats admins remove <chat> <person>

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	обязательный	ID или часть имени.

`max chats update`

rename a group or channel, change its description, or turn one of its settings on or off

Меняет что-то в MAX.

max chats update <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--title <title>`	the new name.
`--description <text>`	the new description.
`--photo <file>`	новое фото — файл изображения.
`--all-can-pin <on\|off>`	every member may pin messages.
`--only-admins-add <on\|off>`	only admins may add members.
`--only-admins-call <on\|off>`	only admins may start a call.
`--only-owner-edits-info <on\|off>`	only the owner may change the name and photo.
`--members-see-link <on\|off>`	members may see the invite link.

`max chats link`

a group's invite link

`max chats link show`

the invite link, if you may see it

max chats link show <chat>

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

`max chats link reset`

replace the invite link; the old one stops working

Меняет что-то в MAX.

max chats link reset <chat>

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

`max chats requests`

заявки на вступление в канал MAX, где нужно одобрение

`max chats requests list`

ожидающие заявки на вступление в канал MAX, где нужно одобрение; только для администраторов; requestedAt равен null

max chats requests list <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--limit <n>`	сколько результатов.
`--search <text>`	только люди, у которых имя или @username содержит этот текст.
`--link <link>`	MAX не поддерживает; вместо этого ищите по имени.

`max chats requests accept`

принять заявку; вступление видно группе

Меняет что-то в MAX.

max chats requests accept <chat> [person] [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	необязательный	кто подал заявку: ID из `chats requests list`.

Опция	Что делает
`--all`	MAX не поддерживает; выберите одного человека из chats requests list.
`--link <link>`	MAX не поддерживает; выберите одного человека из chats requests list.

`max chats requests decline`

отклонить заявку

Меняет что-то в MAX.

max chats requests decline <chat> [person] [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.
`person`	необязательный	кто подал заявку: ID из `chats requests list`.

Опция	Что делает
`--all`	MAX не поддерживает; выберите одного человека из chats requests list.
`--link <link>`	MAX не поддерживает; выберите одного человека из chats requests list.

`max chats moderate`

judge a group's new messages and members by its rules, and act as they allow

Меняет что-то в MAX.

max chats moderate <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--since-time <time>`	judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays.
`--dry-run`	оценить и составить план; ничего не делать.
`--allow-dangerous`	yes to every action whose level in the group's rules is ask.
`--max-actions <n>`	не больше стольких действий за один запуск; если не указано — 10.

`max chats delete`

удалить чат у этого аккаунта; у остальных чат и сообщения остаются

Меняет что-то в MAX.

max chats delete <chat> [options]

Аргумент	Обязательность	Что это
`chat`	обязательный	чат: его ID или часть названия.

Опция	Что делает
`--allow-dangerous`	удалить без вопроса, который задаёт уровень ask.

Коды возврата

Скрипт ветвится по коду, а не по тексту: текст меняется, код — нет.

Код	Когда
`0`	получилось
`2`	`validation_error`
`3`	`configuration_error`
`4`	`authentication_error`
`5`	`permission_error`
`6`	`not_found`
`7`	`confirmation_required`
`8`	`rate_limited`
`9`	`timeout`
`10`	`network_error`
`11`	`provider_error`
`12`	`provider_unavailable`
`13`	`invalid_response`
`14`	`outcome_unknown`
`130`	`cancelled`
`1`	всё остальное

0 и только 0 означает, что операция выполнена. 14 — outcome_unknown — означает, что сообщение могло уйти: не отправлено и не провалено, и повторять его можно только с тем же --send-id.

Управление группами и каналами

Общие опцииCopy Anchor Link

КомандыCopy Anchor Link

max chats createCopy Anchor Link

max chats membersCopy Anchor Link

max chats members listCopy Anchor Link

max chats members auditCopy Anchor Link

max chats members historyCopy Anchor Link

max chats members fetchCopy Anchor Link

max chats members addCopy Anchor Link

max chats members removeCopy Anchor Link

max chats adminsCopy Anchor Link

max chats admins addCopy Anchor Link

max chats admins removeCopy Anchor Link

max chats updateCopy Anchor Link

max chats linkCopy Anchor Link

max chats link showCopy Anchor Link

max chats link resetCopy Anchor Link

max chats requestsCopy Anchor Link

max chats requests listCopy Anchor Link

max chats requests acceptCopy Anchor Link

max chats requests declineCopy Anchor Link

max chats moderateCopy Anchor Link

max chats deleteCopy Anchor Link

Коды возвратаCopy Anchor Link

Общие опции

Команды

`max chats create`

`max chats members`

`max chats members list`

`max chats members audit`

`max chats members history`

`max chats members fetch`

`max chats members add`

`max chats members remove`

`max chats admins`

`max chats admins add`

`max chats admins remove`

`max chats update`

`max chats link`

`max chats link show`

`max chats link reset`

`max chats requests`

`max chats requests list`

`max chats requests accept`

`max chats requests decline`

`max chats moderate`

`max chats delete`

Коды возврата