Важный нюанс: Сейчас ввел лимит — 3 видео в сутки на человека. Вчера паре пользователей «сорвало голову», и они начали закидывать в бота обучалки тоннами, трафик чуть не улетел в космос. Также пришлось сделать проверку подписки на канал — тут сразу сорри, ребят, это не ради спама, а чтобы понимать нагрузку и вовремя расширять железо / играть с IPшками и контролировать трафик.

Писал всё сам на Python, строго не судите. Будет классно, если будет обратная связь и идеи, чего еще добавить.
Совет от себя: прогрузите аудио файл, пока ловит вай-фай. Дальше можно хоть в авиарежим переходить.

А ниже — фото Данилы, чтобы поностальгировать и вспомнить героя нашего времени.

Несмотря на весь позитив - словил много хейта, несмотря на то, что мой бот бесплатный, люди все равно нашли до чего докопаться, но меня это не пугает - двигаюсь дальше!

Выучим английский вместе! А пользоваться моим абсолютно бесплатным ботом для разговорного английского можно по ссылке - t.me/kmo_ai_english_bot

Этот день я запомню надолго!

• Авторизация — phone-login по SMS (+опциональный 2FA облачный пароль) или QR-код

• Сообщения — текст, реплаи, форварды, редактирование, удаление, реакции

• Медиа — фото, файлы, голосовые (.ogg/.opus, с авто-waveform через ffmpeg), видео, video-note («кружочек»), локация, опросы, стикеры

• Группы и каналы — создание, добавление участников, выдача админки, переименование, аватары, пины, политика реакций, invite-ссылки

• Поиск — глобальный, по чату, по типу

• Прочее — презенс, контакты, профиль, сессии, 2FA

• Под капотом — auto-reconnect, авто-ack серверных push’ей, raw escape hatch на любой опкод

Установка

npm install max-account-api

Нужен Node.js 18.17+.

Echo-бот в 15 строк

import { MaxClient } from 'max-account-api';
import * as readline from 'node:readline/promises';
import { stdin as input, stdout as output } from 'node:process';

const rl = readline.createInterface({ input, output });
const client = await MaxClient.loginWithPhone({ phone: await rl.question('Phone (+79...): '), getSmsCode: () => rl.question('SMS code: '), });

console.log('Вошёл как', client.getMe()?.names?.[0]?.name);
client.on('message', async (m) => { if (m.fromId === client.getMe()?.id) return; // не отвечаем самому себе
await client.reply(m, `Эхо: ${m.text}`); });

rl.close();
await new Promise(() => {}); // держим процесс живым

На первом запуске введёшь SMS (+2FA, если включён) — токен сохранится в .max-session.json, в следующий раз поднимется тихо.

В гите библиотеки, в директории examples/ лежат готовые сценарии: auto-reply, send-photo, send-voice, send-video-note, polls, groups, search, contacts и т.д. — копипаст-friendly.

Подводные камни

• SMS на phone-auth сервер иногда приходит только на RU-IP. Если ты не из РФ — нужен RU-VPN на момент первого логина. Дальше сессия живёт откуда угодно.

• Библиотека неофициальная, MAX может что-то поменять в любой момент. Автоблокировки тоже не исключены, особенно если устроить из аккаунта спам.

• WebRTC-медиа звонков вне scope — есть только signalling. Поднять полноценный видеозвонок через Node.js это отдельная история.

• Голосовые / видео / кружочки требуют именно phone-login (нужен mobile-side токен) — через QR-login их слать нельзя.

Важно

Не делайте из этого спам-рассылок — аккаунт улетит в бан, и тут уже ничем не помочь.