Бот в MAX молчит: четыре грабли Bot API, о которых не пишут в документации

В сфере искусственного интеллекта произошло заметное событие. Denjam 27 минут назад Бот в MAX молчит: четыре грабли Bot API, о которых не пишут в документации Средний 7 мин 642 Мессенджеры * Python * Проектирование API * SaaS / S+S * Кейс Из песочницы Синяя галочка есть. Я сижу и смотрю в экран телефона, где мой собственный бот игнорирует моё собственное сообщение. Сервер отвечает 200 OK, в логах — ни строчки паники, база чистая, YandexGPT спокойно отдаёт ответ.

Просто человек на другом конце этого не видит. К этому моменту я уже вторую неделю живу с MAX — российским мессенджером, который в 2026-м стало трудно игнорировать. Дальше было ещё три таких же вечера: каждый раз бот молчал по новой причине, и ни одна из них не была описана в документации словами, которые я мог бы найти поиском.

Технические детали

Собственно, ради этого текст и написан — чтобы следующему человеку хватило получаса вместо недели. Зачем я вообще полез в MAXЯ делаю NAMI — бота-администратора для салонов красоты: он общается с клиентом в мессенджере и записывает его к мастеру. Соло, без команды, на российском стеке (Python/FastAPI, PostgreSQL, YandexGPT — 152-ФЗ, данные должны лежать в России).

Telegram был первым каналом и работает отлично. Но у моей аудитории — мастера маникюра, барберы, владельцы небольших студий — своя реальность: Telegram и WhatsApp в России периодически «замедляют», клиент салона в лучшем случае не понимает, почему сообщение не уходит, в худшем — просто закрывает чат и не записывается. MAX работает без всяких плясок, и туда идёт государственный пуш.

Для продукта, который живёт на конверсии «клиент написал → клиент записался», это не идеология, а арифметика. Так что вопрос был не «стоит ли», а «сколько это займёт». Я посмотрел на Bot API, увидел знакомые очертания TamTam (MAX вырос из него), прикинул полдня работы — и ошибся ровно вчетверо.

Отраслевые последствия

Приятная новость сразу: концептуально API нормальное. Webhook, POST /messages, inline-клавиатуры, вложения. Если вы писали телеграм-ботов, вы освоитесь за час.

Все четыре грабли — не про «сложно», а про «нигде не написано». Именно поэтому они и стоят вечера каждая. Грабля нулевая, разминочная: где живёт токенНачнём с мелочи, чтобы вы не потеряли на ней двадцать минут, как я.

Токен передаётся в заголовке Authorization, сырой строкой. Не Bearer — просто токен. И не в query-параметре access_token, как во многих примерах в интернете: этот способ ещё работает, но помечен как deprecated, и MAX прямым текстом отвечает «use Authorization header».

Событие, по словам экспертов, усилит конкуренцию в сфере ИИ.