Как проверить Telegram Mini App

Перед запуском проведите тестовую заявку от открытия приложения в Telegram до появления записи у сотрудника. Затем повторите тот же маршрут с плохой сетью, повторным нажатием и закрытием окна. По этим проверкам видно, сможет ли клиент продолжить работу, если что-то прервётся.

Для каждого сценария запишите исходные условия, действия и ожидаемый результат на экране и в системе. Например, при двойном нажатии «Записаться» клиент должен получить одно подтверждение, а сотрудник увидеть одну запись. Такой результат можно проверить перед запуском и повторить после обновления.

1. Проверьте способы открытия

Запускайте Mini App теми способами, которые будут доступны клиентам. Это может быть кнопка меню бота, кнопка под сообщением или прямая ссылка. Для каждого входа проверьте, открывается ли нужный экран и сохраняется ли контекст, например выбранная услуга или источник перехода.

Отдельно откройте ссылку вне Telegram, если клиент может получить её по почте или на сайте. Вместо пустого экрана или бесконечной загрузки покажите понятное объяснение и доступный способ продолжить. Для проверки используйте отдельного бота и тестовую базу, чтобы тесты не попадали в рабочую очередь.

2. Проверьте вход и права

Сервер должен проверять данные initData до создания сессии. Клиентские данные из initDataUnsafe нельзя использовать как подтверждение личности. Порядок проверки подписи и роль времени auth_date описаны в документации Telegram.

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

3. Проверьте экран и клавиатуру

Откройте приложение на реальных телефонах с Android и iOS. Проверьте светлую и тёмную темы, узкий экран и увеличенный текст. Откройте клавиатуру в конце длинной формы. Поле должно оставаться видимым, а кнопка отправки — доступной после закрытия клавиатуры.

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

4. Пройдите основной сценарий

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

Сверьте результат в административной части. Дата, контакт, статус и выбранная услуга должны совпасть с подтверждением, которое увидел клиент. Если есть интеграция с CRM, проверьте её результат отдельно. Список полей и действий сотрудника можно сверить со статьёй об админ-панели Mini App.

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

5. Прервите отправку

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

Защита кнопки от двойного нажатия помогает интерфейсу, но сама по себе не защищает сервер. Проверьте повтор одного и того же запроса. Для операций, которые создают запись, серверу нужен способ распознать уже обработанную попытку и не создавать дубль.

Для проверки сбоев используйте тестовые записи с узнаваемыми номерами и отдельный канал уведомлений. Фиксируйте, что было сохранено до прерывания, какой ответ увидел клиент и что появилось в очереди сотрудника. Повторите одну попытку после восстановления сети и сравните записи по идентификатору. Так проще обнаружить дубль, даже если оба ответа в интерфейсе выглядят одинаково.

6. Проверьте повторный вход

Закройте приложение до отправки формы и откройте его снова. Согласуйте ожидаемое поведение для черновика. Приложение может предложить продолжить или ясно сообщить, что данные не сохранились. Не восстанавливайте незаметно устаревшие цены, время записи или поля из прошлой сессии.

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

7. Проверьте ошибки и помощь

Пройдите сценарии с недоступной CRM, отклонённым файлом и пустым списком доступных дат. Сообщение должно объяснять, можно ли повторить действие или нужно изменить данные. Для поддержки сохраняйте номер обращения или идентификатор ошибки. Не выводите служебные детали и персональные данные в публичные журналы.

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

8. Решите, готов ли запуск

Соберите результаты в таблицу с устройством, версией клиента Telegram, сценарием и фактическим результатом. Отдельно отметьте ошибки, при которых пользователь не может войти, теряет данные или создаёт дубли. Сначала исправьте их и повторите весь связанный маршрут.

После запуска проверьте один согласованный тестовый сценарий на рабочем окружении и уберите тестовую запись по правилам команды. Опишите в брифе ваш Mini App и ключевой сценарий, чтобы согласовать проверки и критерии готовности до релиза.