# ADR-0023. Бот MAX мерчанта

- Статус: принято; реализовано на этапе 7 — 7i-1 (бот мерчанта, его события, привязка MAX к карте, кабинет покупателя
  в MAX без кода), 7i-2 (сообщения и коды через MAX, согласие «Реклама в MAX»), 7i-3 (SMS о подключении MAX), 7i-4
  (второй код от бота)
- Дата: 2026-11-04

## Контекст

Пункт 7.5 roadmap — бот и мини-приложение MAX. MAX — национальный мессенджер; бот в нём может писать только тем, кто сам
его запустил, а писать по номеру телефона нельзя. Создать бота может только организация или ИП, подтверждённые в «MAX
для партнёров» (business.max.ru): там же выдаётся токен и задаётся адрес мини-приложения бота. Мини-приложение — сайт,
который MAX открывает внутри себя и к адресу которого дописывает подписанные токеном бота данные запуска
(`#WebAppData=…`), — как у Telegram.

Решения владельца продукта (2026-11-04): покупатель подключает MAX через кабинет покупателя, открытый в MAX (один вход
по коду из SMS, дальше MAX узнаёт его сам; из кабинета в браузере — кнопкой «Подключить MAX»), а не кнопкой
«Поделиться контактом»: документация MAX не говорит, что номер в присланном контакте проверен. Всё — служебные,
реклама, уведомления о списании и коды — тем, кто подключил MAX, уходит сначала в MAX, а если MAX не принял — как
сейчас. Реклама в MAX — с отдельным согласием «Реклама в MAX».

## Решение

### Бот мерчанта

- Один бот на мерчанта — строка `communication_channels` провайдера `max` рядом с SMS-каналами и почтой. Токен
  запечатан, как пароль SMS-аккаунта (`CredentialBox`); в `settings` — id бота, его название и короткое имя (из которого
  сделаны ссылки на бота), программа, кабинет покупателя которой бот открывает, и SHA-256 секрета событий. Списки
  SMS-каналов, порядок кодов и «Почта» бота не видят.
- Подключение (`Contracts\MaxBot::connect`): сначала MAX отвечает, чей это токен (`GET /me`), — токен, который он не
  принял, не хранится; бот без короткого имени не подключается. Потом бот сохраняется с новым секретом, и MAX просят
  присылать события на `<APP_URL>/hooks/max/<канал>` (`POST /subscriptions`, события `bot_started`, `bot_stopped`,
  `message_created`, `message_callback`). Что ответил MAX, записывается, только если токен всё ещё тот, о котором
  спрашивали, и секрет — тот, что ему дали. Подключение другого бота на место прежнего просит MAX больше не присылать
  события прежнего и
  забывает привязки покупателей: прежнего бота они запускали, нового — нет; так же — переход бота к другой программе.
- Секрет меняется в два шага: новый (`webhook_pending_sha256`) становится тем, с которым принимаются события
  (`webhook_sha256`), только когда MAX его принял; до тех пор события принимаются и со старым, и с новым (MAX мог
  принять новый, а его ответ потеряться). Всё, что говорит с MAX о боте одного мерчанта, идёт по очереди (блокировка
  сессии БД вне транзакции): двойное нажатие не оставит MAX с секретом, которого платформа не знает.
- Проверка — снова `GET /me` и новая подписка с новым секретом; отказ — состояние бота, а не ошибка; проверка бота,
  которого тем временем подключили заново, MAX больше ничего не говорит. Выключенный бот не отвечает и не пускает в
  кабинет без кода; привязки остаются. Удаление просит MAX больше не присылать события (если MAX отвечает), забывает
  токен и привязки. Подключения и проверки считаются в часовом лимите мерчанта вместе с другими каналами, а токены,
  которые MAX отклонил, останавливают их на время — сначала у мерчанта, потом у всех (`RequestLimits`, сервер `max`):
  MAX заблокировал бы адрес платформы, с которого перебирают токены.
- Запросы к MAX — только через `Gateway` (`MaxApi`: JSON, токен в заголовке `Authorization`, никогда в адресе; хост
  `platform-api2.max.ru`); в песочнице — двойник, любой токен — бот.

### События бота

- MAX присылает события на `POST /hooks/max/<канал>` — вне группы web и API: ни сессии, ни ключа, только секрет в
  заголовке `X-Max-Bot-Api-Secret`. Арендатор находится до RLS функцией SECURITY DEFINER `max_channel_tenant()`;
  событие с другим секретом — 401, канал не бота — 404, остальное — 200 (и то, что платформа не разбирает, тоже — чтобы
  MAX не повторял). Лимит — по боту.
- `bot_started` — человек нажал «Начать»: бот отвечает приветствием с кнопкой «Моя карта» (`open_app`: открывает
  мини-приложение бота). Если человек пришёл по одноразовой ссылке кабинета (`link-<токен>` в `payload`), сначала его
  аккаунт привязывается к участнику ссылки, и бот называет карту по замаскированному номеру (пересланная ссылка — не
  секрет того, кто её открыл); устаревшая или использованная ссылка — текст «Ссылка устарела…». `message_created` в чате
  бота — ответ, что бот на вопросы не отвечает (с ними — в магазин), и снова кнопка «Моя карта», не чаще раза в 30
  секунд на человека (ключ ограничителя — слепой индекс id, не сам id); сообщения групп и других ботов не разбираются.
  `bot_stopped` отмечается в привязке (для сообщений 7i-2), новый `bot_started` снимает отметку.
- Пока кабинет покупателя программы закрыт (`Contracts\MiniAppAddress`, его даёт модуль кабинета), бот отвечает, что
  кабинет закрыт, и кнопки «Моя карта» не показывает; бот закрытого мерчанта не отвечает.
- Бот отвечает до ответа на событие, укладываясь в 3 секунды: MAX повторяет событие, на которое не ответили, и человек
  услышал бы ответ дважды; ответ после ответа (колбэки завершения) в одном процессе копится от запроса к запросу.

### Привязка MAX к участнику

- `max_links`: id пользователя MAX — персональные данные — запечатан ключом ПДн под контекстом привязки и ищется по
  слепому индексу арендатора. Один аккаунт MAX — одному участнику бота и один участник — одному аккаунту: привязка
  ставится заново, прежние у обоих уходят; ставится, удерживая участника (`Members::lockPresent`), чтобы обезличивание
  не оставило её, а затем участника и аккаунт у бота (блокировки транзакции), чтобы две привязки не столкнулись на
  уникальном индексе. Участник, объединённый с другим, передаёт привязку выжившему, если у того своей нет, — как
  подключённую без кода (7i-3: номер выжившего кода в том MAX не подтверждал); обезличенный — теряет её
  (`MemberAnonymized`).
- Привязка впускает без кода, поэтому её забывает всё, что защищает участника: блокировка карты (потерянный телефон;
  разблокировка её не вернёт), новый номер, «Выйти на всех устройствах», «Выйти из кабинета покупателя везде» в карточке
  участника, «Не вы?» в уведомлении о списании и «Это не я — отключить MAX» в SMS о подключении (7i-3), с кодами бота,
  которых ещё не ввели (7i-4). Забывая, держит
  привязки участника, как подключение (7i-3): подключение в ту же минуту дождётся и уйдёт тоже.
- Привязывают: вход по коду и вступление в кабинете, открытом в MAX (данные запуска приходят вместе с ними); «Подключить
  MAX» в кабинете, уже открытом в MAX, — по данным запуска; одноразовая ссылка `https://max.ru/<бот>?start=link-<токен>`
  из кабинета в браузере — 15 минут, хранится SHA-256 токена, `messages:prune` удаляет просроченные; бот, события
  которого не приходят, ссылок не даёт. Подключение по ссылке держит участника раньше токена — как обезличивание и
  объединение, которые держат участника и забывают его токены. Сеанс, который уже был у страницы, MAX не подключает:
  участник мог отключить MAX в другом месте.

### Кабинет покупателя в MAX

- Страница кабинета сама читает `WebAppData` из фрагмента адреса и сразу убирает его из адреса (ссылка, скопированная
  со страницы, никого не впустит); скрипт MAX на страницу не подключается — у неё прежняя строгая политика.
- Сервер проверяет данные запуска (`MaxLaunchData`) токеном бота программы: пары, кроме `hash`, по ключам через перевод
  строки, HMAC-SHA256 с ключом HMAC-SHA256(«WebAppData», токен), в hex; ровно один `hash`, ни одного ключа дважды,
  `auth_date` не старше часа (и не больше минуты вперёд), `user` с числовым `id`. Подпись проверена вектором, посчитанным
  отдельно (hmac Python).
- `POST /p/<slug>/max/session` впускает участника, к которому привязан аккаунт, без кода, заменяя сеанс другого
  участника в этом браузере; не привязан — `portal_max_not_linked` (страница просит войти по коду и передаёт данные
  запуска со входом), данные не того бота или старые — `portal_max_refused`, заблокированный — `member_blocked`.
  `GET /p/<slug>/max` говорит, есть ли у программы бот и подключил ли MAX вошедший участник; `POST`/`DELETE
  /p/<slug>/max/link` подключают и отключают. Экран входа в MAX говорит, что вход подключит MAX. В профиле — раздел
  «MAX»: в браузере «Подключить MAX» показывает ссылку на бота (открыть другое приложение страница может только по
  нажатию человека); «Отключить MAX» — с вопросом, а в MAX ещё и выходит из кабинета здесь.
- `auth_date` — секунды, как у Telegram; тринадцать цифр читаются как миллисекунды.

### Кабинет мерчанта

- «Сообщения» → «MAX» (после «Почты»): видят все с `settings.view` — название, ссылку, программу, состояние, приходят ли
  события; меняет `channels.manage` со свежим подтверждением (не через доступ поддержки). Страница даёт адрес
  мини-приложения — кабинет покупателя программы, его вставляют в «MAX для партнёров», — и ссылку на бота с QR-кодом
  для кассы, напоминает назвать идентификатор MAX в согласии на обработку персональных данных (шаблон в «Документах
  согласий» его уже называет) и что сообщения боту никуда не пересылаются. Переезд и закрытие кабинета покупателя
  предупреждают о кнопке «Моя карта». Журнал аудита: `max-bot.store` (с программой), `.check`, `.disable`, `.enable`,
  `.remove`; токен — никогда.
- 7i-2: в карточке участника строка «MAX» — подключён и сообщения уходят туда, или подключён, но сейчас не уходят
  (человек остановил бота или бот выключен или не работает); «Выйти из кабинета покупателя везде» предлагается и
  участнику, который нигде не вошёл, но подключил MAX (MAX впустил бы его без кода), и тогда называется «… и отключить
  MAX». В журнале сообщений — маршрут «MAX» и «бот MAX» среди каналов, которым предлагали сообщение; в «Очереди» —
  что MAX не говорит, прочитано ли сообщение. Страницы «MAX», «Почта» и «Настройки» говорят, что кому уходит сначала в
  MAX; страница «MAX» предупреждает, что без SMS-канала покупатели не подключат MAX (первый вход — по коду из SMS).

### Сообщения через MAX (7i-2)

- Тем, кто подключил MAX, служебные сообщения и реклама уходят сначала в MAX (`MessageDelivery::routesOf`: MAX первым,
  дальше как раньше): мерчанту бесплатно и сразу на телефон. Не принял MAX — следующий маршрут сейчас же, как между SMS
  и почтой. Реклама в MAX — только с согласием «Реклама в MAX» и пока MAX присылает события бота (нажатия и слова —
  это отказы от рекламы; без них отказаться было бы нельзя). Под сообщением — кнопка «Моя карта», пока работает
  кабинет покупателя, под рекламой ещё «Не присылать рекламу» (38-ФЗ, ст. 18: отказ — в одно нажатие).
- Предупреждение (уведомление о списании «Не вы?») — сначала по SMS, потом письмом и только потом в MAX: решение
  владельца «всё сначала в MAX» уступает защите. Кто подключил к чужой карте свой MAX (кабинет, оставленный открытым,
  впускает подключить MAX без кода), получал бы предупреждения о списании, а хозяин номера не узнал бы ничего.
- Куда: аккаунт участника (или объединённого с ним) у работающего бота, если человек не остановил бота
  (`MaxMemberService::recipientOf`). Остановленным привязку отмечает только событие `bot_stopped` (снимает —
  `bot_started`): отказ MAX на сообщение (403/404) закрывает маршрут только для этого сообщения — тот же ответ бывает
  и у ограниченного бота, и метка у всех, кому он писал, молча увела бы их на платные SMS. MAX не ответил — сообщение
  берёт следующий маршрут, а если никакой не взял, ждёт следующей попытки; в этом прогоне MAX больше не спрашивают;
  токен не принят — бот «не работает». Журнал пишет маршрут `max` на номер участника (как SMS), стоимость 0; о доставке
  MAX не спрашивают — принятое MAX считается отправленным.
- `MemberMessages::openRoutes` называет MAX, пока бот работает (для рекламы — пока приходят его события). «Баллы скоро
  сгорят» считает участника достижимым через MAX, если его аккаунт подключён и бот им не остановлен
  (`MaxMembers::reachable`); пока открыт только MAX (на SMS нет денег, почты нет), предупреждения один раз получают
  подключившие MAX, а день остаётся открытым для остальных: его снова проходят, только когда SMS или письма смогут уйти
  (отметка в кеше; потерялась — день пройдут ещё раз, дважды никого не предупредят).

### Коды через MAX (7i-2)

- Код списания баллов на кассе называет участника, которого касса нашла (`StartVerification::$memberId`,
  `CodeMessage::$memberId`), и уходит сначала в его MAX (за половину секунд, отведённых на отправку кода), потом SMS —
  только если MAX подключён там, где человек подтвердил кодом номер: вход или вступление в кабинет, открытый в MAX
  (`MaxMembers::link(…, proven)`, `max_links.linked_via = 'app'`; тот же аккаунт заново это сохраняет). Подключение из
  кабинета в браузере (ссылка на бота, «Подключить MAX» в сеансе) номер не доказывает: кто на минуту получил чужой
  открытый кабинет, подключил бы свой MAX и тратил бы баллы по кодам кассы. Код кассы участника другой программы мерчанта
  в MAX не уходит: его MAX не подключён к этому боту. Только по SMS: код нового номера (он должен дойти до номера),
  регистрации (номер ещё ничей), повторный, если есть SMS-канал (нет — снова в MAX), и код кабинета покупателя
  (`StartVerification::$public`, `CodeMessage::$public`): по ответу «Код отправлен в MAX» посторонний узнал бы, что номер —
  участник программы, а кабинет этого не говорит никому. В MAX кабинет и так впускает подключивших без кода.
- Канал кода `max` (`VerificationChannel::Max`: ответ Runtime API, `verification_requests`); касса пишет «Код отправлен в
  чат бота программы в MAX». Мерчант с ботом и без SMS-каналов отправляет коды кассы подключившим MAX по коду, остальным —
  `code_delivery_unavailable` до того, как что-то посчитано (`CodeSender::assertAvailable` знает цель кода, участника и
  публичный ли он).

### Согласие «Реклама в MAX» (7i-2)

- Свой вид документа `marketing_max` («Согласие на рекламу в MAX» в «Документах согласий»; в шаблоне — как отозвать его
  в чате бота); кабинет покупателя предлагает его при вступлении и в профиле, как согласия на SMS и письма.
- Бот спрашивает «Присылать сюда, в MAX, акции и предложения программы «…»?» — с текстом документа и кнопками «Да,
  присылать» и «Нет», — если документ опубликован и его текст помещается в сообщение (согласие дают тексту, который
  видят; длинный — только в профиле), кабинет покупателя работает, а участник это согласие ни давал, ни отзывал: при
  подключении по ссылке — в том же ответе; при подключении в кабинете, открытом в MAX, — задачей очереди после коммита
  (`AskAboutMaxAdvertising`: запрос входа MAX не ждёт; в задаче только id), которая ничего не спросит, если к тому
  времени кабинет закрыт, бот выключен, его события не приходят (нажатие некуда было бы прислать), привязки нет или
  мерчант закрыт. Тот же аккаунт заново — не спрашивает; вступление в MAX — тоже: анкета только что предложила это
  согласие. Тех, кто подключил MAX до публикации документа, бот не спрашивает (вопрос рассылкой сам выглядел бы
  рекламой) — им согласие предлагает профиль.
- Кнопки несут версию документа и метку участника (`MaxMemberService::mark`, слепой индекс арендатора): нажатие
  засчитывается только участнику, к которому аккаунт подключён сейчас и которого спрашивали. «Да, присылать» — согласие
  к той версии, о которой спрашивали, через `Members::changeConsent`, канал `bot`; в доказательстве — бот, слепой
  индекс аккаунта MAX и id нажатия. «Нет», «Не присылать рекламу» под рекламой и слово «стоп» в чате — отзыв, а у того,
  кто согласия не давал, — записанный отказ (`ChangeConsent::$refusal`): больше бот не спрашивает. Отказ принимает и
  выключенный бот — молча (иначе реклама вернулась бы с его включением); согласие — только работающий. Опубликована
  новая версия, вопрос задан другой карте или участник ушёл — «Этот вопрос устарел…»; аккаунт ни к кому не подключён —
  «MAX не подключён к карте…». MAX отвечают на нажатие всплывающим уведомлением (`POST /answers`), если бот может.

### SMS о подключении MAX (7i-3)

- Подключённый MAX открывает карту без кода, а её QR-код на кассе тратит баллы без SMS. Подключение без кода,
  подтверждённого в MAX, — по ссылке на бота из кабинета в браузере или «Подключить MAX» по уже открытому кабинету —
  ничего не доказывает о телефоне: кто на минуту получил чужой открытый кабинет, подключил бы свой MAX и держал карту.
  Не доказывает до конца и вход по коду в MAX: данные запуска своего MAX можно вставить в ссылку на кабинет
  (`#WebAppData=…`), и человек, вошедший по ней в браузере своим кодом, подключил бы чужой MAX как подтверждённый. Поэтому
  о каждом новом аккаунте, подключённом к карте, — и входом по коду, — хозяину номера уходит SMS «К карте подключён MAX.
  Не вы? <ссылка>»; тот же аккаунт заново — без SMS. Одно SMS — при ссылке до 40 знаков (хост кабинета до 13 знаков:
  `https://` + хост + `/m/` + 16); ссылку до 60 знаков SMS несёт двумя частями, длиннее — уведомления нет (ниже).
- Вход и вступление по коду подключают MAX только по данным запуска не старше `MaxMembers::LINKING_LAUNCH_SECONDS`
  (15 минут): MAX создаёт их при открытии мини-приложения, а человек входит за минуты; более старые подключение не
  делают, вход всё равно происходит.
- Модуль сообщений сообщает о новом подключении событием `MaxLinked` (id участника, программы, бота и привязки, `proven`)
  в транзакции привязки; слушатель модуля `triggers` — без своей точки сохранения: уведомление, которое нельзя записать,
  отменяет подключение. Он пишет уведомление (`max_link_notices`: SHA-256 токена — первичный ключ, как у уведомлений о
  списании, 30 дней) и ставит сообщение темы `MaxMembers::LINK_NOTICE_TOPIC` (`max_linked`), назначение —
  предупреждение. Его не выключает ни мерчант (это не автосообщение «Автосообщений»), ни пауза; оно уходит только по SMS
  — не в MAX (аккаунт может быть чужим) и не письмом (адрес мог поставить тот, кто подключал, тем же открытым
  кабинетом). Нет страницы для ссылки или ссылка длиннее 60 знаков — `MaxLinkUnavailable` (409 `max_link_unavailable`):
  ничего не подключено; вход по коду в MAX при этом входит без подключения.
- Подключение без кода требует работающего SMS-канала мерчанта (`ChannelStore::anyUsable` с деньгами на счёте) — иначе
  `MaxLinkUnavailable` — и отказывает (`MaxLinksThrottled`, 429 `max_links_throttled` с `retry_after`), когда за сутки о
  карте уже ушли `MaxMembers::UNPROVEN_LINKS_PER_DAY` (3) уведомления: подключать и отключать по кругу значило бы
  качать SMS за счёт мерчанта. Считаются уведомления участника в `member_messages`, под блокировкой привязок участника.
  Подключение по коду не ограничено (коды и так ограничены). Ссылка на бота в этих случаях не выдаётся, а пришедшая по
  ней в бот — отказ с ответом «Сейчас подключить MAX по ссылке нельзя…» (токен остаётся до своего срока). Кабинет
  покупателя говорит, через сколько можно снова и как подключить сразу — входом по коду в MAX.
- Ссылка ведёт на `/m/<токен>` на хосте кабинета покупателя (`Contracts\MaxLinkNoticeAddress`, связывает портал), вне
  кабинета и группы web, с той же защитой, что у «Не вы?» о списании: открытие только спрашивает, кнопка «Это не я —
  отключить MAX» держит строку уведомления, затем участника (за объединениями — оставшуюся запись), отключает MAX,
  подключённый к карте сейчас (тот или подключённый позже: войти и подключить свой — по коду), удерживая привязки
  участника, как подключение (подключение в ту же минуту дождётся и уйдёт; новое после — снова SMS), завершает сеансы
  кабинета покупателя и плоскости участника и отзывает согласие «Реклама в MAX», данное через бота после подключения
  (его дал тот, кого бот спросил, — 38-ФЗ требует согласия абонента), один раз. Вход без кода по привязке держит её до
  выдачи сеанса (`MaxMembers::memberOf(…, hold)`), так что «Не вы?» завершает и такой сеанс. Карта не замораживается и
  владельцам не пишут: баллы не тронуты, а если с карты списали без участника, страница просит обратиться в магазин
  (уведомление о списании «Не вы?» мерчант включает сам). Запросы ссылки считаются по ссылке; `redemption-notices:prune`
  удаляет и эти уведомления.

### Второй код от бота (7i-4)

- Решение владельца 2026-11-07. Данные запуска можно вставить в ссылку на кабинет, поэтому аккаунт, который они называют,
  подключается к карте только после кода, который бот присылает в чат этого аккаунта: код вводят на странице, где
  человек вошёл. Мошенник, приславший ссылку с данными своего MAX, получит код у себя, а покупатель в браузере ввести его
  не сможет. Так — при входе и вступлении по коду в кабинете, открытом в MAX (`MaxMembers::offerLink(…, proven: true)`:
  подключение получит коды кассы), и при «Подключить MAX» по уже открытому кабинету в MAX (`proven: false`). Ссылка на
  бота из браузера кода не просит: её открывает и нажимает «Начать» сам человек в своём MAX.
- Вход и вступление отвечают `max_code: true`, если код ушёл; кабинет показывает «Подключите MAX» с полем кода,
  «Прислать код ещё раз» и «Не сейчас» (карта открывается и без MAX) и предупреждает не вводить код, который прислал или
  продиктовал кто-то другой; поле не подсказывает код из SMS (`autocomplete=off`: он тоже из шести цифр). «Подключить
  MAX» в MAX отвечает 202 `{max_code: true}` (204 — аккаунт уже участника). `POST /p/<имя>/max/confirm` с кодом и
  сеансом кабинета подключает аккаунт (`MaxMembers::confirmLink`) с тем, что дало предложение: подтверждено ли
  подключение и спрашивать ли о рекламе; `POST max/code` присылает код ещё раз (`sent: false` — прошлый ушёл меньше минуты
  назад). `GET max` говорит, ждёт ли код (`code`): раздел MAX профиля снова показывает поле — после «Не сейчас»,
  перезагрузки или «Моя карта» в боте. Данные запуска страница держит на время вкладки (`sessionStorage`): вход
  перезагружает страницу, а в MAX она должна остаться страницей MAX.
- `max_link_codes`: один код на участника — новый заменяет прежний; код принадлежит сеансу кабинета, который его
  запросил (`session_id`): другой сеанс того же участника его не введёт — иначе тот, у кого есть чужой открытый кабинет,
  подтвердил бы код, ушедший в его MAX. 6 цифр (в песочнице — её код `000000`), хранится HMAC с ключом приложения, id
  MAX запечатан под контекстом кода; 10 минут (`LINK_CODE_SECONDS`), 5 попыток (`LINK_CODE_ATTEMPTS`): неверный —
  `max_code_invalid` (422, `attempts_left`), другого сеанса, не того бота, истёкший или без попыток — `max_code_expired`
  (410). Тот же сеанс и аккаунт получают новый код не раньше чем через минуту (`LINK_CODE_PAUSE_SECONDS`: иначе чат бота
  засыпали бы коды и MAX ограничил бы бота), и новый код наследует попытки прежнего — перебор новыми кодами ничего не
  даёт. Код уходит после коммита своей строки, MAX ждут до 4 секунд; не принял — строки нет, `MaxLinkUnavailable` (вход
  и вступление при этом проходят без MAX); отказ токена отмечает бота неработающим. Без кода подключение отказывает до
  отправки так же, как отказало бы потом (нет SMS-канала, три в сутки); отказ при вводе кода оставляет код для
  повторной попытки. Аккаунт, подключённый без кода, вход по коду из SMS и код бота подключают заново как подтверждённый.
  Коды уходят с привязками участника (`unlink`), с ботом (заменён или удалён) и по сроку (`messages:prune`). Строка бота
  берётся (`for key share`) раньше строк привязок, токенов и кодов: замена бота берёт её и затем стирает их. Текст бота:
  «Код для подключения MAX к карте: … Введите его в «Моя карта» — код действует 10 минут. Никому его не сообщайте.» В
  журнал сообщений этот код не пишется (бесплатное сообщение бота самому человеку).

## Последствия

- Вживую проверено не всё: API MAX не отвечает ни с машины разработки, ни из облака. Схема API взята из официального
  клиента MAX на Go (`schema.yaml`, `bot_init_data_test.go`). Проверять — на сервере в России с ботом подтверждённой
  организации; хост `platform-api2.max.ru` может требовать корневой сертификат Минцифры —
  `COMMUNICATIONS_MAX_CA_BUNDLE` указывает файл доверенных корней.
- Мерчант сам вставляет адрес мини-приложения в «MAX для партнёров»; без этого кнопка «Моя карта» ничего не откроет.
- Подписка бота на события переходит к платформе: бот, который служил другой системе, перестанет получать её события
  (сказано на странице).
- Данные запуска впускают без кода в течение часа после открытия мини-приложения; украденные из адреса — тоже, поэтому
  страница убирает их из адреса сразу. Одноразовая ссылка — ключ на 15 минут: кто откроет пересланную ссылку, тот
  подключит свой MAX (бот при этом называет карту по замаскированному номеру).
- Кабинет запрещает показывать себя во фрейме (`frame-ancestors 'none'`, cookie SameSite=Strict): в MAX на телефоне
  мини-приложение — отдельная страница, а если веб- или компьютерная версия MAX открывает его во фрейме, карта там не
  откроется — проверить вживую.
- Решение владельца «всё сначала в MAX» уступает в двух местах (7i-2): коды кабинета покупателя в браузере идут по SMS
  и тем, кто подключил MAX (кабинет не выдаёт, чей это номер), а предупреждение о списании «Не вы?» — сначала по SMS
  (до хозяина номера). Сказать владельцу.
- Прочитал ли человек сообщение в MAX, платформа не знает: «отправлено» — значит, MAX принял.
- Боты, подключённые до 7i-2, получают нажатия кнопок (`message_callback`) только после «Проверить» (новая подписка);
  до выкладки 7i-2 подключённых ботов нет.
- Остаток 7i-1 закрыт SMS о подключении (7i-3, решение владельца 2026-11-04): чужой MAX, подключённый по открытому
  кабинету или по ссылке с чужими данными запуска, держит карту, пока хозяин номера не нажмёт ссылку из SMS (до неё —
  минута-другая: очередь сообщений раз в минуту). Каждое SMS оплачивает мерчант (сказано на странице «MAX»), и
  подключение по коду в MAX теперь стоит SMS кода и SMS о подключении.
- Отключение MAX в профиле не завершает сеансы кабинета, открытые этим MAX без кода (кабинет просит нажать ещё «Выйти на
  всех устройствах»); «Не вы?» и «Выйти на всех устройствах» завершают всё.
- Проверки длины ссылки в «Состоянии системы» нет: хост кабинета длиннее 33 знаков выключит подключение MAX
  (`docs/dev/setup.md`).
- Вход по ссылке с чужими данными запуска закрыт вторым кодом от бота (7i-4): код уходит в MAX того, чьи данные. Остаётся
  уговорить покупателя ввести код, который мошенник перешлёт ему из своего чата, — страница прямо предупреждает этого не
  делать, а SMS «Не вы?» сообщает о подключении. Подключение по коду в MAX стоит одного SMS кода и одного SMS о
  подключении; код бота бесплатен.
- «Не вы?» не отменяет того, что злоумышленник успел сделать открытым кабинетом: подтверждённую им почту, согласия на
  рекламу SMS и письмами; код для кассы, выданный ему, живёт до двух минут. Подключение MAX, начатое его сеансом в ту же
  секунду, может пройти после «Не вы?» — со своим SMS; следующее уже нет: сеансы завершены.
- Порядок блокировок (7i-3): строка участника, затем его привязки MAX (одна рекомендательная блокировка участника у
  `place()`, `claim()` и `unlink()`), затем токены ссылок и сеансы. Всё, что завершает сеансы для защиты, сначала забывает
  MAX: так подключение по ссылке из бота, оба «Не вы?» и блокировка карты не ждут друг друга по кругу.
- Откат миграций 7i-2 оставляет проверки маршрутов и каналов кодов широкими: строки с MAX обновляются и после отката.
- Нужна ли метка «остановлен» по отказу MAX (а не только по `bot_stopped`), видно будет вживую по кодам ошибок MAX.
- Вопрос о рекламе после подключения в мини-приложении бот пишет сам. Если MAX не даёт боту писать тому, кто не нажимал
  «Начать» в его чате (открыл мини-приложение по прямой ссылке), вопрос не дойдёт — согласие остаётся в профиле;
  проверить вживую.
