Управление группами и каналами
Участники, приглашения, права и модерация групп и каналов. Нужные действия требуют соответствующих прав.
Здесь собраны команды администрирования групп. Вы сможете найти параметры участников, приглашений, прав и модерации перед изменением.
Участники, приглашения, права и модерация групп и каналов. Нужные действия требуют соответствующих прав.
Общие параметры
| Параметр | Назначение |
|---|---|
-V, --version | показать номер версии. |
-v, --verbose | подробности: -v — идентификаторы, -vv — все известные данные. По умолчанию: 0. |
--json | машиночитаемый вывод: единственное значение JSON в stdout. |
--jsonl | машиночитаемый вывод: объект JSON на строку для потоковой обработки и jq. |
--quiet | отключить диагностику; ошибки остаются. |
--trace | журнал соединения в stderr, без содержимого сообщений. |
--timeout <duration> | ограничить время всей команды: 30s, 2m, 500ms. |
--offline | читать сохранённое без подключения; ошибка, если данных нет. |
--no-input | не запрашивать ввод и не открывать интерактивный вход; ввод через канал остаётся доступным. |
--max-input-bytes <bytes> | максимальный размер буферизованного ввода в байтах (по умолчанию: 16777216). |
--max-output-bytes <bytes> | максимальный размер машинного вывода в байтах (по умолчанию: 4194304; 0 отключает ограничение). |
--fields <paths> | поля элементов или объекта через запятую: id,text; сохранять пагинацию и идентификаторы операций. |
--dry-run | предварительно показать разобранные аргументы и разрешения перед выполнением действия. |
--yes | выполнить изменение без подтверждения уровня ask. |
--record | сохранить запуск: идентификаторы и время, без текста сообщений. |
--no-record | не сохранять независимо от настроек. |
Команды
tg chats members
участники группы
tg chats members list
все участники постранично с ролями и временем последнего появления
tg chats members list <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--limit <n> | количество результатов. |
--page <n> | номер страницы, начиная с 1. |
--all | все строки без страниц. |
tg chats members audit
участники, похожие на ботов, с причинами для каждого, по списку участников и локальному хранилищу; --deep проверяет выбранных людей отдельно; никого не удаляет
tg chats members audit <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--budget <pages> | не больше этого числа страниц по 200 участников, с паузой между ними (по умолчанию 10). |
--min-score <n> | только участники с оценкой не ниже этой; 1 выводит всех, у кого есть причина (по умолчанию 2). |
--deep <n> | также проверить первые n профилей, самые старые фотографии, до 1,000 сохранённых сообщений каждого и публичные списки блокировок, в которые отправляются их идентификаторы — один человек в секунду. |
tg chats members history
кто вступил, кто вышел и чей профиль изменился, начиная с самых старых записей — данные, записанные chats members fetch в локальное хранилище; к мессенджеру не обращается
tg chats members history <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--since-time <time> | ISO 8601 или 2h / 1d назад; без параметра — всё записанное. |
tg chats members fetch
прочитать полный список участников группы в историю участников локального хранилища: кто вступил, кто вышел, ежедневные числа участников и изменения профилей; выход участника фиксируется только после чтения полного списка
tg chats members fetch <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--track | также загружать его ежедневно, пока работает serve; chats tracking показывает и изменяет список таких чатов. |
--budget <pages> | не больше этого числа страниц по 200 участников, с паузой между ними (по умолчанию 10). |
tg chats members add
добавить участников; они получат уведомление
Changes something in Telegram.
tg chats members add <chat> <person>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | обязателен | идентификатор или часть имени. |
tg chats members remove
удалить участников; сообщения сохраняются
Changes something in Telegram.
tg chats members remove <chat> <person>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | обязателен | идентификатор или часть имени. |
tg chats create
создать группу или канал; добавленные люди получают уведомление
Changes something in Telegram.
tg chats create <title> [person] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
title | обязателен | название группы. |
person | необязателен | участники для добавления: идентификатор или часть имени. |
| Параметр | Назначение |
|---|---|
--channel | приватный канал вместо группы; вступление по ссылке. |
tg chats update
изменить название, описание или настройки группы либо канала
Changes something in Telegram.
tg chats update <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--title <title> | новое название. |
--description <text> | новое описание. |
--all-can-pin <on|off> | все участники могут закреплять сообщения. |
--only-admins-add <on|off> | только администраторы могут добавлять участников. |
--join-approval <on|off> | Люди просят присоединиться, и администратор впускает их. |
tg chats link
приглашение в группу
tg chats link show
ссылка-приглашение, если у вас есть право её видеть
tg chats link show <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats link create
создать ещё одну ссылку приглашения; никто не узнает о ней, пока вы ею не поделитесь
Changes something in Telegram.
tg chats link create <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--approval | желающие вступить по ссылке сначала отправляют запрос, а администратор их впускает; тогда у ссылки нет лимита использований. |
--expire-time <time> | время прекращения действия: 2026-09-25T09:00 (местное время) или через 30m, 2h, 7d. |
--max-uses <n> | не более указанного числа людей смогут вступить по ссылке, от 1 до 99999. |
tg chats link list
ваши ссылки приглашения, сначала новые, с числом вступивших и ожидающих
tg chats link list <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--revoked | вместо этого — ссылки, действие которых вы прекратили. |
--limit <n> | количество. |
tg chats link revoke
прекратить действие одной ссылки; для основной ссылки группы ответ содержит новую
Changes something in Telegram.
tg chats link revoke <chat> <link>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
link | обязательный | ссылка в том виде, как её показывает chats link list. |
tg chats link update
изменить одну из своих ссылок-приглашений, в том числе основную ссылку группы
Changes something in Telegram.
tg chats link update <chat> <link> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
link | обязательный | ссылка в том виде, как её показывает chats link list. |
| Параметр | Назначение |
|---|---|
--approval | желающие вступить по ссылке сначала отправляют запрос, а администратор их впускает; тогда у ссылки нет лимита использований. |
--no-approval | любой со ссылкой сразу вступает. |
--expire-time <time> | время прекращения действия: 2026-09-25T09:00 (местное время) или через 30m, 2h, 7d; never снимает срок действия. |
--max-uses <n> | не более указанного числа людей смогут вступить по ссылке, от 1 до 99999. |
tg chats link reset
заменить приглашение; старая ссылка перестаёт работать
Changes something in Telegram.
tg chats link reset <chat>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
tg chats requests
запросы на вступление в группу с одобрением администратора
tg chats requests list
кто запросил вступление, сначала новые; видны только администраторам, чтение никого не уведомляет
tg chats requests list <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--limit <n> | количество. |
--search <text> | только люди, у которых имя или @username содержит этот текст. |
--link <link> | только люди, запросившие вступление по этой ссылке; не сочетается с --search. |
tg chats requests accept
впустить их; группа увидит, что они вступили
Changes something in Telegram.
tg chats requests accept <chat> [person] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | необязательный | кто запросил вступление: идентификатор из chats requests list. |
| Параметр | Назначение |
|---|---|
--all | все ожидающие запросы; сначала проверяются с учётом почасового лимита. |
--link <link> | с --all: только запросы по этой ссылке приглашения. |
tg chats requests decline
отклонить запрос
Changes something in Telegram.
tg chats requests decline <chat> [person] [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | необязательный | кто запросил вступление: идентификатор из chats requests list. |
| Параметр | Назначение |
|---|---|
--all | отклонить все ожидающие заявки; отклонения не учитываются в часовом лимите отправок. |
--link <link> | с --all: только запросы по этой ссылке приглашения. |
tg chats admins
назначить или снять права администратора
tg chats admins add
назначить участника администратором с заданными правами
Changes something in Telegram.
tg chats admins add <chat> <person> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | обязателен | идентификатор или часть имени. |
| Параметр | Назначение |
|---|---|
--can <rights> | разрешённые действия через запятую: members, admins, info, pin, link, post, edit, delete. |
tg chats admins remove
снять права администратора; человек остаётся участником
Changes something in Telegram.
tg chats admins remove <chat> <person>| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
person | обязателен | идентификатор или часть имени. |
tg chats moderate
проверить новые сообщения и участников по правилам группы и выполнить разрешённые действия
Changes something in Telegram.
tg chats moderate <chat> [options]| Аргумент | Обязательность | Описание |
|---|---|---|
chat | обязателен | чат: название или его часть, идентификатор, @username или me для «Избранного». |
| Параметр | Назначение |
|---|---|
--since-time <time> | проверить после времени ISO 8601 или 2h / 1d назад; сохранённая позиция не меняется. |
--dry-run | проверить и составить план без действий. |
--allow-dangerous | подтвердить все действия с уровнем ask в правилах группы. |
--max-actions <n> | максимум действий за запуск; по умолчанию 10. |
Коды завершения
Выбирайте ветвь по коду, а не по тексту: текст может измениться, код — нет.
| Код | Когда |
|---|---|
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, по которому Telegram отбрасывает вторую копию.