Administración de grupos y canales
Miembros, invitaciones, permisos y moderación de grupos y canales. Las acciones requieren los permisos pertinentes.
Esta referencia reúne comandos administrativos. Consulta opciones de miembros, invitaciones, permisos y moderación antes de cambiar algo.
Miembros, invitaciones, permisos y moderación de grupos y canales. Las acciones requieren los permisos pertinentes.
Opciones generales
Se aplican a todos los comandos.
| Opción | Para qué sirve |
|---|---|
-V, --version | output the version number. |
-v, --verbose | more detail in what is shown: -v ids, -vv everything we know. Por defecto: 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 | no pedir entrada ni abrir un inicio de sesión interactivo; la entrada mediante una tubería sigue disponible. |
--max-input-bytes <bytes> | máximo de bytes de entrada almacenados en búfer (predeterminado: 16777216). |
--max-output-bytes <bytes> | máximo de bytes de salida para máquinas (predeterminado: 4194304; 0 desactiva el límite). |
--fields <paths> | campos de elementos o del objeto separados por comas: id,text; conservar la paginación y los identificadores de operaciones. |
--dry-run | previsualizar los argumentos analizados y los permisos antes de ejecutar la acción. |
--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. |
Comandos
max chats create
create a group or a channel; the people added are told
Cambia algo en MAX.
max chats create <title> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
title | obligatorio | the group's name. |
person | opcional | people to add: an id, or part of a name. |
| Opción | Para qué sirve |
|---|---|
--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]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--limit <n> | cuántos mostrar. |
--page <n> | qué página, empezando por 1. |
--all | todas las filas, sin paginar. |
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]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--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> | comprueba también a las primeras n personas en detalle — perfil, fotos y todo lo que escribieron — a una persona por segundo; las listas públicas de bloqueos solo cubren Telegram, por lo que no se envía nada. |
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]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--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]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--track | descargarla también a diario mientras se ejecuta serve; chats tracking enumera y modifica esos chats. |
--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
Cambia algo en MAX.
max chats members add <chat> <person> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | obligatorio | un ID o parte de un nombre. |
| Opción | Para qué sirve |
|---|---|
--history | the people added also see the messages from before they came. |
max chats members remove
remove people; their messages stay
Cambia algo en MAX.
max chats members remove <chat> <person>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | obligatorio | un ID o parte de un nombre. |
max chats admins
give or take back a member's admin rights
max chats admins add
make a member an admin with these rights
Cambia algo en MAX.
max chats admins add <chat> <person> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | obligatorio | un ID o parte de un nombre. |
| Opción | Para qué sirve |
|---|---|
--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
Cambia algo en MAX.
max chats admins remove <chat> <person>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | obligatorio | un ID o parte de un nombre. |
max chats update
rename a group or channel, change its description, or turn one of its settings on or off
Cambia algo en MAX.
max chats update <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--title <title> | the new name. |
--description <text> | the new description. |
--photo <file> | una nueva foto: un archivo de imagen. |
--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>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
max chats link reset
replace the invite link; the old one stops working
Cambia algo en MAX.
max chats link reset <chat>| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
max chats requests
solicitudes de entrada a un canal de MAX que requiere aprobación
max chats requests list
solicitudes pendientes de entrada a un canal de MAX que requiere aprobación; solo administradores; requestedAt es null
max chats requests list <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--limit <n> | cuántos resultados. |
--search <text> | solo personas cuyo nombre o @username contiene este texto. |
--link <link> | MAX no lo admite; busca por nombre en su lugar. |
max chats requests accept
aceptar; el grupo ve la entrada
Cambia algo en MAX.
max chats requests accept <chat> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | opcional | quién lo solicitó: un ID de chats requests list. |
| Opción | Para qué sirve |
|---|---|
--all | MAX no lo admite; elige una persona de chats requests list. |
--link <link> | MAX no lo admite; elige una persona de chats requests list. |
max chats requests decline
rechazar la solicitud
Cambia algo en MAX.
max chats requests decline <chat> [person] [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
person | opcional | quién lo solicitó: un ID de chats requests list. |
| Opción | Para qué sirve |
|---|---|
--all | MAX no lo admite; elige una persona de chats requests list. |
--link <link> | MAX no lo admite; elige una persona de chats requests list. |
max chats moderate
judge a group's new messages and members by its rules, and act as they allow
Cambia algo en MAX.
max chats moderate <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--since-time <time> | judge what came after this ISO 8601 time, or 2h / 1d ago; the saved point stays. |
--dry-run | evaluar y planificar; no hacer nada. |
--allow-dangerous | yes to every action whose level in the group's rules is ask. |
--max-actions <n> | como máximo este número de acciones por ejecución; 10 si no se indica. |
max chats delete
eliminar el chat para esta cuenta; los demás conservan el chat y sus mensajes
Cambia algo en MAX.
max chats delete <chat> [options]| Argumento | Obligatoriedad | Qué es |
|---|---|---|
chat | obligatorio | un chat: su ID o parte de su título. |
| Opción | Para qué sirve |
|---|---|
--allow-dangerous | borrar sin la pregunta que el nivel ask hace antes de eliminar. |
Códigos de salida
Los scripts deciden según el código de salida, no según el texto: el texto puede cambiar; el código no.
| Código | Cuándo |
|---|---|
0 | Operación completada |
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 | Cualquier otro caso |
0, y solo 0, significa que la operación se completó. 14, outcome_unknown, significa que
el mensaje podría haberse enviado: no se confirma éxito ni fallo. Solo puedes repetirlo con el mismo
--send-id.