Bots

Esta referencia reúne comandos del bot y métodos Bot API. Consulta parámetros de autenticación, mensajes, eventos y métodos para tu bot.

Conexión del bot, mensajes, eventos y Bot API completa.

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.

`max bot`

a MAX bot, through the official Bot API and a bot token — not your personal account

`max bot auth`

the bot token this profile uses

`max bot auth set`

check a bot token with MAX, then keep it — typed at a hidden prompt or piped on stdin

Cambia algo solo en este ordenador.

max bot auth set

`max bot auth show`

where this profile's bot token comes from, and which bot it is

max bot auth show

`max bot auth remove`

forget this profile's bot token

Cambia algo solo en este ordenador.

max bot auth remove

`max bot list`

every name on this machine that has a bot token; --check asks MAX which bot each is

max bot list [options]

Opción	Para qué sirve
`--check`	ask the messenger who each bot is, with its token.

`max bot chats`

the chats this bot is in — MAX gives a bot no list of them, so list shows the ones it has seen

`max bot chats list`

chats this bot has seen on this machine — not a complete list from MAX

max bot chats list

`max bot chats show`

one chat from MAX, and remember it

max bot chats show <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.

`max bot chats leave`

take the bot out of a chat; only an admin of the chat can bring it back

Cambia algo en MAX.

max bot chats leave <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.

`max bot chats action`

show what the bot is doing in a chat — typing, sending a photo — for a few seconds

Cambia algo en MAX.

max bot chats action <chat> <action>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`action`	obligatorio	what the chat sees. Uno de: `typing`, `photo`, `video`, `voice`, `file`.

`max bot chats admins`

the admins of a chat the bot is an admin in

`max bot chats admins list`

the chat's admins and what each may do

max bot chats admins list <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.

`max bot chats admins add`

make a member an admin with these rights

Cambia algo en MAX.

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

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.
`person`	obligatorio	el ID de usuario de la persona.

Opción	Para qué sirve
`--can <rights>`	what they may do, comma-separated: read, members, admins, info, pin, link, edit, delete.
`--title <title>`	the title shown beside their name.

`max bot chats admins remove`

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

Cambia algo en MAX.

max bot chats admins remove <chat> <person>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.
`person`	obligatorio	el ID de usuario de la persona.

`max bot chats members`

the people in a chat the bot is an admin in

`max bot chats members remove`

take a person out of a chat; their messages stay

Cambia algo en MAX.

max bot chats members remove <chat> <person> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.
`person`	obligatorio	el ID de usuario de la persona.

Opción	Para qué sirve
`--block`	also keep them from coming back by the chat's link.

`max bot chats members list`

members of a chat, a page at a time — --marker takes the marker the last page gave

max bot chats members list <chat> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio

Opción	Para qué sirve
`--limit <n>`	cuántos, hasta 100.
`--marker <marker>`	continue from here.

`max bot chats members add`

add people to a chat by user id; the bot must be an admin that may add members

Cambia algo en MAX.

max bot chats members add <chat> <users>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio
`users`	obligatorio

`max bot chats rules`

a chat's moderation rules for this bot, kept on this machine

`max bot chats rules show`

the chat's rules; the defaults, marked not saved, if it has none yet

max bot chats rules show <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID del grupo o el título de un grupo que este bot ha visto.

change one rule — trusted, blocked, blockedNames, links, invites, forwards, blockedPeople, flood.messages, flood.minutes, flood.action, newAccount.days, newAccount.action, consent.delete, consent.remove

Cambia algo solo en este ordenador.

max bot chats rules set <chat> <key> <value>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID del grupo o el título de un grupo que este bot ha visto.
`key`	obligatorio	la regla.
`value`	obligatorio	its new value.

`max bot chats rules unset`

put one rule back to its default

Cambia algo solo en este ordenador.

max bot chats rules unset <chat> <key>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID del grupo o el título de un grupo que este bot ha visto.
`key`	obligatorio	la regla.

`max bot chats moderate`

judge a group's new messages and joins by its rules, and act as they allow — as the bot

Cambia algo en MAX.

max bot chats moderate <chat> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID del grupo o el título de un grupo que este bot ha visto.

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.
`--no-ban`	remove without banning; by default a removed person cannot come back by the link.
`--max-actions <n>`	como máximo este número de acciones por ejecución; 10 si no se indica.

`max bot messages`

the messages in the chats this bot is in

`max bot messages send`

send a message as the bot; without [text], the text is read from stdin

Cambia algo en MAX.

max bot messages send <chat> [text] [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`text`	opcional	el mensaje.

Opción	Para qué sirve
`--reply-to <message>`	answer this message, by its id in the same chat.
`--silent`	entregar sin notificación.
`--md`	interpretar el Markdown de este servicio de mensajería; la sintaxis admitida está en su guía de formato.
`--html`	the text is HTML: , , , .
`--file <file>`	attach a file; the text becomes its caption.
`--photo <file>`	attach a .jpg, .png or .webp as a photo; the text becomes its caption.
`--as-file`	send the --file as a file to download, a video included.
`--voice <file>`	send an Ogg Opus file as a voice message, alone, with no text.
`--allow-any-file`	send a file even from a hidden folder, ~/.ssh or this CLI's own folders.

`max bot messages list`

the latest messages in a chat; where MAX gives a bot no history, and with --offline, the ones this bot has seen on this machine

max bot messages list <chat> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.

Opción	Para qué sirve
`--limit <n>`	how many, the newest.

`max bot messages show`

one message by its id in a chat

max bot messages show <chat> <message>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`message`	obligatorio	ID del mensaje.

`max bot messages edit`

replace the text of a message the bot sent

Cambia algo en MAX.

max bot messages edit <chat> <message> <text> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`message`	obligatorio	ID del mensaje.
`text`	obligatorio	the new text.

Opción	Para qué sirve
`--md`	interpretar el Markdown de este servicio de mensajería; la sintaxis admitida está en su guía de formato.
`--html`	the text is HTML: , , , .

`max bot messages delete`

delete messages in a chat the bot can delete in; it cannot be undone

Cambia algo en MAX.

max bot messages delete <chat> <messages> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`messages`	obligatorio	message ids.

Opción	Para qué sirve
`--allow-dangerous`	delete without asking.

`max bot messages pin`

pin a message in a chat; quietly unless --notify

Cambia algo en MAX.

max bot messages pin <chat> <message> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`message`	obligatorio	ID del mensaje.

Opción	Para qué sirve
`--notify`	tell the chat's members.

`max bot messages unpin`

unpin a message in a chat

Cambia algo en MAX.

max bot messages unpin <chat> <message>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat, user: para una persona o el título de un chat que este bot ha visto.
`message`	obligatorio	ID del mensaje.

`max bot messages between`

what two or more people wrote in the chats they have all written in — from the local copy, grouped by chat, oldest first; --limit counts per chat. Common chats are the ones this copy saw each of them write in, not a member list from MAX

max bot messages between <people> [options]

Argumento	Obligatoriedad	Qué es
`people`	obligatorio	two or more people — an id, @username or part of a name each.

Opción	Para qué sirve
`--all-bots`	leer también la copia de cualquier otro bot en este equipo que permita readOtherBots.
`--bots <profiles>`	leer también las copias de estos bots, separados por comas — cada uno permitido por readOtherBots.
`--limit <n>`	how many of the latest messages from each chat.

`max bot search`

encontrar por texto lo que guarda la copia local de este bot

`max bot search messages`

search the messages this bot has read, sent or received on this machine — the local copy only, best match first; every word must appear; "a phrase", -word, a OR b, from: chat: after: before: has:; by text, by --from, or both

max bot search messages [query] [options]

Argumento	Obligatoriedad	Qué es
`query`	opcional	the words to find.

Opción	Para qué sirve
`--all-bots`	leer también la copia de cualquier otro bot en este equipo que permita readOtherBots.
`--bots <profiles>`	leer también las copias de estos bots, separados por comas — cada uno permitido por readOtherBots.
`--limit <n>`	cuántos resultados.
`--newest`	primero los más recientes en lugar de los mejores.
`--from <who>`	only what this person wrote — an id, @username or part of a name; repeat it for any of several.

`max bot recipients`

the chats this bot may write to; with no list, every chat — clear removes the list

`max bot recipients list`

the chats on the list, or nothing when there is no list

max bot recipients list

`max bot recipients add`

allow a chat: its id, user:<id>, or the title of a chat this bot has seen

Cambia algo solo en este ordenador.

max bot recipients add <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio

`max bot recipients remove`

take a chat off the list

Cambia algo solo en este ordenador.

max bot recipients remove <chat>

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio

`max bot recipients clear`

remove the list: the bot may write to any chat again

Cambia algo solo en este ordenador.

max bot recipients clear

`max bot sends`

what this bot sent, edited and deleted from this machine — ids and outcomes, never text

`max bot sends list`

max bot sends list

`max bot watch`

print new messages as they arrive and keep them, until Ctrl-C or --timeout (either ends it normally)

max bot watch [options]

Opción	Para qué sirve
`--events`	also edits, deletions, buttons pressed and people coming and going; every line names its event.
`--types <types>`	only these update types, comma-separated, in the messenger's words.

`max bot callbacks`

answers to the buttons people press under the bot's messages

`max bot callbacks answer`

answer a pressed button by its callback id: --notification shows the person a one-time note, --text replaces the message the button was on

Cambia algo en MAX.

max bot callbacks answer <callback> [options]

Argumento	Obligatoriedad	Qué es
`callback`	obligatorio	the callback id `bot watch` printed.

Opción	Para qué sirve
`--text <text>`	the message's new text.
`--notification <text>`	a note only the person who pressed sees.

`max bot commands`

the bot's command menu — what people see after /

`max bot commands list`

the commands in the menu now

max bot commands list

`max bot commands set`

replace the whole menu: each command as name=description, e.g. start=Begin

Cambia algo en MAX.

max bot commands set <commands>

Argumento	Obligatoriedad	Qué es
`commands`	obligatorio	name=description, one per command.

`max bot commands clear`

empty the menu

Cambia algo en MAX.

max bot commands clear

`max bot webhooks`

where the messenger pushes this bot's updates — while one is set, bot watch gets nothing

`max bot webhooks list`

the webhooks this bot has

max bot webhooks list

`max bot webhooks set`

send this bot's updates to an HTTPS address; refused while another is set

Cambia algo en MAX.

max bot webhooks set <url> [options]

Argumento	Obligatoriedad	Qué es
`url`	obligatorio	the HTTPS address.

Opción	Para qué sirve
`--types <types>`	only these update types, comma-separated, in the messenger's words.
`--secret-stdin`	a secret the messenger sends back with each update — asked for, or read from a pipe.
`--add`	keep the webhooks already set and add this one beside them.

`max bot webhooks delete`

stop sending updates to this address; with none left, bot watch works again

Cambia algo en MAX.

max bot webhooks delete <url>

Argumento	Obligatoriedad	Qué es
`url`	obligatorio	the address.

`max bot contacts`

people this bot has seen write — from the local copy on this machine, never asking MAX unless told to

`max bot contacts show`

one person: the chats they wrote in (with their last message there) and the latest messages of their private chat with the bot

max bot contacts show <who> [options]

Argumento	Obligatoriedad	Qué es
`who`	obligatorio	an id, @username or part of a name.

Opción	Para qué sirve
`--all-bots`	leer también la copia de cualquier otro bot en este equipo que permita readOtherBots.
`--bots <profiles>`	leer también las copias de estos bots, separados por comas — cada uno permitido por readOtherBots.
`--limit <n>`	how many messages from the private chat.
`--refresh`	read the private chat with them again from the messenger first — one request.

`max bot store`

the bot's local copy on this machine

`max bot store fetch`

fetch a chat's history into the bot's local copy, newest first; run it again to continue

max bot store fetch <chat> [options]

Argumento	Obligatoriedad	Qué es
`chat`	obligatorio	ID de chat o el título de un chat que este bot ha visto.

Opción	Para qué sirve
`--limit <n>`	at most this many messages in this run; 1000 if not given.
`--page-size <n>`	how many messages one request asks for; 100 if not given.
`--pause <duration>`	pause between pages, to stay under the messenger's limits. Por defecto: `1s`.
`--since-time <time>`	stop once it reaches messages older than this: ISO 8601, or 2h / 1d ago.
`--last <n>`	stop once the newest n messages are held.

`max bot mcp`

serve this bot to an agent over MCP, on stdin and stdout — claude mcp add sales-bot -- max sales bot mcp

max bot mcp [options]

Opción	Para qué sirve
`--confirm-send`	ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil.
`--allow-dangerous`	ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil.
`--allow-send`	ya no se usa — deciden los permisos del perfil; se mantiene para que una configuración antigua siga arrancando.
`--allow-delete`	ya no se usa — deciden los permisos del perfil.
`--allow-moderate`	ya no se usa — deciden los permisos del perfil.

`max bot mcp config`

print the mcpServers entry for Claude Desktop, Cursor and others, with full paths; writes nothing

max bot mcp config [options]

Opción	Para qué sirve
`--confirm-send`	ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil.
`--allow-dangerous`	ya no se usa — las operaciones de escritura no muestran un formulario; deciden los permisos del perfil.
`--allow-send`	ya no se usa — deciden los permisos del perfil; se mantiene para que una configuración antigua siga arrancando.
`--allow-delete`	ya no se usa — deciden los permisos del perfil.
`--allow-moderate`	ya no se usa — deciden los permisos del perfil.

`max bot me`

the bot this profile's token belongs to: name, id, description, commands

max bot me

`max bot comments`

comments under a channel post — each command takes the post's message id (mid.…) first

`max bot comments list`

the comments under a post, newest last

max bot comments list <message> [options]

Argumento	Obligatoriedad	Qué es
`message`	obligatorio

Opción	Para qué sirve
`--limit <n>`	cuántos, hasta 100.

`max bot comments get`

one comment under a post

max bot comments get <message> <comment>

Argumento	Obligatoriedad	Qué es
`message`	obligatorio
`comment`	obligatorio

`max bot comments send`

comment under a post as the bot; - reads stdin

Cambia algo en MAX.

max bot comments send <message> <text> [options]

Argumento	Obligatoriedad	Qué es
`message`	obligatorio
`text`	obligatorio

Opción	Para qué sirve
`--format <format>`	how the text is marked up. Uno de: `markdown`, `html`.

`max bot comments edit`

replace the text of a comment the bot wrote; - reads stdin

Cambia algo en MAX.

max bot comments edit <message> <comment> <text> [options]

Argumento	Obligatoriedad	Qué es
`message`	obligatorio
`comment`	obligatorio
`text`	obligatorio

Opción	Para qué sirve
`--format <format>`	how the text is marked up. Uno de: `markdown`, `html`.

`max bot comments delete`

delete a comment under a post

Cambia algo en MAX.

max bot comments delete <message> <comment> [options]

Argumento	Obligatoriedad	Qué es
`message`	obligatorio
`comment`	obligatorio

Opción	Para qué sirve
`--allow-dangerous`	omitir la confirmación de bot.messages.delete en el nivel ask.

`max bot uploads`

files uploaded to MAX, to attach to a message

`max bot uploads put`

upload a file from disk and print the attachment to put in a message's attachments — messages send --file does both steps at once

Cambia algo en MAX.

max bot uploads put <file> [options]

Argumento	Obligatoriedad	Qué es
`file`	obligatorio

Opción	Para qué sirve
`--type <type>`	upload as this kind instead of guessing by extension. Uno de: `image`, `video`, `audio`, `file`.

`max bot api`

every operation of the official Bot API, generated from its schema — docs/dev/bot-api-coverage.md

max bot api [options]

Opción	Para qué sirve
`--store-token <profile>`	keep a returned authentication token only in this bot profile's OS keyring; never print it.

`max bot api get-my-info`

Get current bot info — read (GET /me)

max bot api get-my-info

`max bot api edit-my-commands`

Edit current bot commands — write (PATCH /me/commands)

Cambia algo en MAX.

max bot api edit-my-commands [options]

Opción	Para qué sirve
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api get-chat`

Get chat — read (GET /chats/{chatId})

max bot api get-chat [options]

Opción	Para qué sirve
`--chat-id <value>`	Requested chat or channel identifier.

`max bot api edit-chat`

Edit chat or channel info — write (PATCH /chats/{chatId})

Cambia algo en MAX.

max bot api edit-chat [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api send-action`

Send action — write (POST /chats/{chatId}/actions)

Cambia algo en MAX.

max bot api send-action [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api get-pinned-message`

Get pinned message — read (GET /chats/{chatId}/pin)

max bot api get-pinned-message [options]

Opción	Para qué sirve
`--chat-id <value>`	Chat identifier to get its pinned message.

`max bot api pin-message`

Pin message — write (PUT /chats/{chatId}/pin)

Cambia algo en MAX.

max bot api pin-message [options]

Opción	Para qué sirve
`--chat-id <value>`	Chat identifier where message should be pinned.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api unpin-message`

Unpin message — write (DELETE /chats/{chatId}/pin)

Cambia algo en MAX.

max bot api unpin-message [options]

Opción	Para qué sirve
`--chat-id <value>`	Chat identifier to remove pinned message.

`max bot api get-membership`

Get chat or channel membership — read (GET /chats/{chatId}/members/me)

max bot api get-membership [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.

`max bot api leave-chat`

Leave chat — destructive (DELETE /chats/{chatId}/members/me)

Cambia algo en MAX.

max bot api leave-chat [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.

`max bot api get-admins`

Get chat or channel admins — read (GET /chats/{chatId}/members/admins)

max bot api get-admins [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.

`max bot api post-admins`

Set chat or channel admins — write (POST /chats/{chatId}/members/admins)

Cambia algo en MAX.

max bot api post-admins [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api delete-admins`

Revoke admin rights — write (DELETE /chats/{chatId}/members/admins/{userId})

Cambia algo en MAX.

max bot api delete-admins [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.
`--user-id <value>`	User identifier.

`max bot api get-members`

Get members — read (GET /chats/{chatId}/members)

max bot api get-members [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.
`--user-ids <value>`	Comma-separated list of users identifiers to get their membership. When this parameter is passed, both `count` and `marker` are ignored.
`--marker <value>`	Marker.
`--count <value>`	Count.

`max bot api add-members`

Add members — write (POST /chats/{chatId}/members)

Cambia algo en MAX.

max bot api add-members [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api remove-member`

Remove member — write (DELETE /chats/{chatId}/members)

Cambia algo en MAX.

max bot api remove-member [options]

Opción	Para qué sirve
`--chat-id <value>`	ID del chat o canal.
`--user-id <value>`	User id to remove from chat or channel.
`--block <value>`	Set to `true` if user should be blocked in chat.

`max bot api get-subscriptions`

Get subscriptions — read (GET /subscriptions)

max bot api get-subscriptions

Subscribe — write (POST /subscriptions)

Cambia algo en MAX.

max bot api subscribe [options]

Opción	Para qué sirve
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api unsubscribe`

Unsubscribe — write (DELETE /subscriptions)

Cambia algo en MAX.

max bot api unsubscribe [options]

Opción	Para qué sirve
`--url <value>`	URL to remove from WebHook subscriptions.

`max bot api get-upload-url`

Get upload URL — write (POST /uploads)

Cambia algo en MAX.

max bot api get-upload-url [options]

Opción	Para qué sirve
`--type <value>`	Uploaded file type: image, audio, video, file.

`max bot api get-messages`

Get messages — read (GET /messages)

max bot api get-messages [options]

Opción	Para qué sirve
`--chat-id <value>`	Chat or channel identifier to get messages in chat or channel.
`--message-ids <value>`	Comma-separated list of message ids to get.
`--from <value>`	Start time for requested messages - use after instead.
`--to <value>`	End time for requested messages - use before instead.
`--before <value>`	Messages before timestamp.
`--after <value>`	Messages after timestamp.
`--count <value>`	Maximum amount of messages in response.

`max bot api send-message`

Send message — write (POST /messages)

Cambia algo en MAX.

max bot api send-message [options]

Opción	Para qué sirve
`--user-id <value>`	Fill this parameter if you want to send message to user.
`--chat-id <value>`	Fill this if you send message to chat or channel.
`--disable-link-preview <value>`	If `false`, server will not generate media preview for links in text.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api edit-message`

Edit message — write (PUT /messages)

Cambia algo en MAX.

max bot api edit-message [options]

Opción	Para qué sirve
`--message-id <value>`	Editing message identifier.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api delete-message`

Delete message — destructive (DELETE /messages)

Cambia algo en MAX.

max bot api delete-message [options]

Opción	Para qué sirve
`--message-id <value>`	Deleting message identifier.
`--allow-dangerous`	omitir la confirmación de bot.messages.delete en el nivel ask.

`max bot api get-message-by-id`

Get message — read (GET /messages/{messageId})

max bot api get-message-by-id [options]

Opción	Para qué sirve
`--message-id <value>`	Message identifier (`mid`) to get single message in chat or channel.

`max bot api get-comments`

Get comments — read (GET /messages/{messageId}/comments)

max bot api get-comments [options]

Opción	Para qué sirve
`--message-id <value>`	ID (`mid`) del mensaje comentado.
`--comment-ids <value>`	Comma-separated list of comment ids to get.
`--before <value>`	Comments before timestamp.
`--after <value>`	Comments after timestamp.
`--count <value>`	Maximum amount of comments in response.

`max bot api send-comment`

Send comment — write (POST /messages/{messageId}/comments)

Cambia algo en MAX.

max bot api send-comment [options]

Opción	Para qué sirve
`--message-id <value>`	ID (`mid`) del mensaje comentado.
`--disable-link-preview <value>`	If `false`, server will not generate media preview for links in text.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api edit-comment`

Edit comment — write (PUT /messages/{messageId}/comments)

Cambia algo en MAX.

max bot api edit-comment [options]

Opción	Para qué sirve
`--message-id <value>`	ID (`mid`) del mensaje comentado.
`--comment-id <value>`	Editing comment identifier.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api delete-comment`

Delete comment — destructive (DELETE /messages/{messageId}/comments)

Cambia algo en MAX.

max bot api delete-comment [options]

Opción	Para qué sirve
`--message-id <value>`	ID (`mid`) del mensaje comentado.
`--comment-id <value>`	Deleting comment identifier.
`--allow-dangerous`	omitir la confirmación de bot.messages.delete en el nivel ask.

`max bot api get-comment-by-id`

Get comment — read (GET /messages/{messageId}/comments/{commentId})

max bot api get-comment-by-id [options]

Opción	Para qué sirve
`--message-id <value>`	ID (`mid`) del mensaje comentado.
`--comment-id <value>`	Comment identifier (`mid`) to get single comment in channel.

`max bot api get-video-attachment-details`

Get video details — read (GET /videos/{videoToken})

max bot api get-video-attachment-details [options]

Opción	Para qué sirve
`--video-token <value>`	Video attachment token.

`max bot api answer-on-callback`

Answer on callback — write (POST /answers)

Cambia algo en MAX.

max bot api answer-on-callback [options]

Opción	Para qué sirve
`--callback-id <value>`	Identifies a button clicked by user. Bot receives this identifier after user pressed button as part of `MessageCallbackUpdate`.
`--disable-link-preview <value>`	If `true`, server will not generate media preview for links in updated message text.
`--body <json>`	el cuerpo de la solicitud en JSON; - lo lee de stdin.
`--body-file <path>`	el cuerpo de la solicitud desde un archivo JSON; - es stdin.

`max bot api get-updates`

Get updates — write (GET /updates)

Cambia algo en MAX.

max bot api get-updates [options]

Opción	Para qué sirve
`--limit <value>`	Maximum number of updates to be retrieved.
`--poll-timeout <value>`	Timeout in seconds for long polling.
`--marker <value>`	Pass `null` to get updates you didn't get yet.
`--types <value>`	Comma separated list of update types your bot want to receive.

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.

Opciones generalesCopy Anchor Link

ComandosCopy Anchor Link

max botCopy Anchor Link

max bot authCopy Anchor Link

max bot auth setCopy Anchor Link

max bot auth showCopy Anchor Link

max bot auth removeCopy Anchor Link

max bot listCopy Anchor Link

max bot chatsCopy Anchor Link

max bot chats listCopy Anchor Link

max bot chats showCopy Anchor Link

max bot chats leaveCopy Anchor Link

max bot chats actionCopy Anchor Link

max bot chats adminsCopy Anchor Link

max bot chats admins listCopy Anchor Link

max bot chats admins addCopy Anchor Link

max bot chats admins removeCopy Anchor Link

max bot chats membersCopy Anchor Link

max bot chats members removeCopy Anchor Link

max bot chats members listCopy Anchor Link

max bot chats members addCopy Anchor Link

max bot chats rulesCopy Anchor Link

max bot chats rules showCopy Anchor Link

max bot chats rules setCopy Anchor Link

max bot chats rules unsetCopy Anchor Link

max bot chats moderateCopy Anchor Link

max bot messagesCopy Anchor Link

max bot messages sendCopy Anchor Link

max bot messages listCopy Anchor Link

max bot messages showCopy Anchor Link

max bot messages editCopy Anchor Link

max bot messages deleteCopy Anchor Link

max bot messages pinCopy Anchor Link

max bot messages unpinCopy Anchor Link

max bot messages betweenCopy Anchor Link

max bot searchCopy Anchor Link

max bot search messagesCopy Anchor Link

max bot recipientsCopy Anchor Link

max bot recipients listCopy Anchor Link

max bot recipients addCopy Anchor Link

max bot recipients removeCopy Anchor Link

max bot recipients clearCopy Anchor Link

max bot sendsCopy Anchor Link

max bot sends listCopy Anchor Link

max bot watchCopy Anchor Link

max bot callbacksCopy Anchor Link

max bot callbacks answerCopy Anchor Link

max bot commandsCopy Anchor Link

max bot commands listCopy Anchor Link

max bot commands setCopy Anchor Link

max bot commands clearCopy Anchor Link

max bot webhooksCopy Anchor Link

max bot webhooks listCopy Anchor Link

max bot webhooks setCopy Anchor Link

max bot webhooks deleteCopy Anchor Link

max bot contactsCopy Anchor Link

max bot contacts showCopy Anchor Link

max bot storeCopy Anchor Link

max bot store fetchCopy Anchor Link

max bot mcpCopy Anchor Link

max bot mcp configCopy Anchor Link

max bot meCopy Anchor Link

max bot commentsCopy Anchor Link

max bot comments listCopy Anchor Link

max bot comments getCopy Anchor Link

max bot comments sendCopy Anchor Link

max bot comments editCopy Anchor Link

max bot comments deleteCopy Anchor Link

max bot uploadsCopy Anchor Link

max bot uploads putCopy Anchor Link

max bot apiCopy Anchor Link

max bot api get-my-infoCopy Anchor Link

max bot api edit-my-commandsCopy Anchor Link

max bot api get-chatCopy Anchor Link

max bot api edit-chatCopy Anchor Link

max bot api send-actionCopy Anchor Link

max bot api get-pinned-messageCopy Anchor Link

max bot api pin-messageCopy Anchor Link

max bot api unpin-messageCopy Anchor Link

Opciones generales

Comandos

`max bot`

`max bot auth`

`max bot auth set`

`max bot auth show`

`max bot auth remove`

`max bot list`

`max bot chats`

`max bot chats list`

`max bot chats show`

`max bot chats leave`

`max bot chats action`

`max bot chats admins`

`max bot chats admins list`

`max bot chats admins add`

`max bot chats admins remove`

`max bot chats members`

`max bot chats members remove`

`max bot chats members list`

`max bot chats members add`

`max bot chats rules`

`max bot chats rules show`

`max bot chats rules set`

`max bot chats rules unset`

`max bot chats moderate`

`max bot messages`

`max bot messages send`

`max bot messages list`

`max bot messages show`

`max bot messages edit`

`max bot messages delete`

`max bot messages pin`

`max bot messages unpin`

`max bot messages between`

`max bot search`

`max bot search messages`

`max bot recipients`

`max bot recipients list`

`max bot recipients add`

`max bot recipients remove`

`max bot recipients clear`

`max bot sends`

`max bot sends list`

`max bot watch`

`max bot callbacks`

`max bot callbacks answer`

`max bot commands`

`max bot commands list`

`max bot commands set`

`max bot commands clear`

`max bot webhooks`

`max bot webhooks list`

`max bot webhooks set`

`max bot webhooks delete`

`max bot contacts`

`max bot contacts show`

`max bot store`

`max bot store fetch`

`max bot mcp`

`max bot mcp config`

`max bot me`

`max bot comments`

`max bot comments list`

`max bot comments get`

`max bot comments send`

`max bot comments edit`

`max bot comments delete`

`max bot uploads`

`max bot uploads put`

`max bot api`

`max bot api get-my-info`

`max bot api edit-my-commands`

`max bot api get-chat`

`max bot api edit-chat`

`max bot api send-action`

`max bot api get-pinned-message`

`max bot api pin-message`

`max bot api unpin-message`

`max bot api get-membership`