Team8

MAX-бот и мини-приложение

Одно приложение Team8 можно открыть из Telegram и MAX. Каталог, оформление заказа и настройки оформления у них общие, а бот каждого мессенджера настраивается отдельно.

Подключение

  1. Создайте бота на платформе MAX для партнёров и дождитесь публикации.
  2. Откройте CMS → Приложения и карточку нужного приложения. В разделе Mini App, аналитика и подсказки укажите MAX bot token и MAX bot user name без @. Сохраните карточку.
  3. В настройках MAX-бота укажите HTTPS-ссылку на мини-приложение вида https://<домен>/<код приложения>. Код показан в карточке приложения. Для уже работающего приложения Telegram используйте тот же код и адрес витрины.
  4. Выберите кнопку открытия мини-приложения в MAX и проверьте запуск из бота.

Токен бота храните только в карточке приложения. Не добавляйте его в ссылку запуска, переписку или клиентский код. Если токен заменён, сохраните новую пару токена и никнейма.

Создать новое приложение можно через CMS → Конструктор приложений: на шаге Мессенджеры заполните пару MAX, Telegram или обе пары. Инструкция с изображениями доступна в мастере; нажмите изображение для полного размера. После настройки найдите бота в MAX по никнейму или ссылке https://max.ru/<никнейм>, нажмите Начать, затем откройте мини-приложение.

Покупатель и номер телефона

При первом запуске покупатель принимает условия создания личного кабинета. В профиле появляется кнопка Подтвердить номер телефона, пока номер не подтверждён в текущем мессенджере. В Telegram она запрашивает отправку собственного контакта боту; в MAX открывает запрос номера внутри мини-приложения. Обычный ввод номера подтверждением не считается. Смена или очистка сохранённого номера вручную снимает подтверждение в обоих каналах. Неподтверждённый номер нельзя использовать для связывания аккаунтов, заказов и корзин.

При открытии формы профиля, обратной связи или чекаута сохранённые данные профиля автоматически подставляются в пустые поля. Если номера ещё нет, появляется окно Подтвердите автозаполнение: система объяснит, что мессенджер предложит поделиться контактом. Нажмите Продолжить, чтобы получить и подставить номер, или Отмена, чтобы продолжить без передачи контакта. Если личный кабинет ещё не создан, потребуется согласие на его создание. В MAX диалог передачи номера открывается поверх мини-приложения: сворачивать его и переходить в чат не нужно. Отказ сохраняет введённые данные и корзину. В рамках открытой формы предложение не повторяется при пересчёте заказа; уже введённые данные не перезаписываются.

Если покупатель подтвердил один и тот же номер в Telegram и MAX, Team8 связывает его аккаунты и заказы. После этого уведомления о новом заказе и изменении статуса приходят в оба доступных чата. Остановленный или заблокированный бот не мешает уведомлению во втором мессенджере.

После связывания у покупателя одна корзина для одного приложения в Telegram и MAX. Товары из обеих корзин сохраняются; количества одинаковых товаров с одинаковыми вариантами складываются. Гостевые товары переносятся после создания кабинета. Актуальная корзина загружается при возвращении в приложение и открытии корзины. Для связывания нужен подтверждённый общий номер — одной авторизации в двух мессенджерах недостаточно. Если заказ сейчас оформляется, завершите оформление и повторите подтверждение номера.

MAX-бот отправляет приветствие при первом запуске мини-приложения или старте бота. Повторное открытие и команда /start не дублируют уже доставленное приветствие. Передача номера выполняется кнопками внутри мини-приложения.

MAX требует HTTPS для URL мини-приложения. Допустимые кнопки запуска и другие условия описаны в документации MAX.

После изменения гостевой корзины счётчик обновляется без входа в личный кабинет. После удаления всех товаров значок количества исчезает. При связывании профилей также сохраняется избранное обоих мессенджеров: товары показываются без повторов, а именованные списки сохраняются.