Skip to main content
Mini App открывается внутри Telegram WebApp и принимает токен пользователя через GET параметр ___uat. При корректном токене пользователь авторизуется автоматически без экранов логина.

​
Для реализации автоматической авторизации на уровне API:

1

Создайте пользователя школы

  1. Вызовите POST /saas/v2/user/create.
  2. Передайте один из логинов (email, phone или tgId). Профиль можно задать сразу.
  3. Сохраните user.id из ответа — он понадобится для выдачи токена.
2

Передайте ссылку в Telegram Mini App

  1. Сформируйте URL школы с параметром ___uat.
  2. Передайте ссылку в payload startapp при открытии WebApp из бота или отправьте пользователю как обычную ссылку.
  3. При открытии Mini App пользователь будет авторизован автоматически.
https://my-school.exode.biz?___uat=eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.student-session-token
Для deep-link из бота используйте https://t.me/your_school_bot?startapp= и закодируйте URL mini app в startapp (base64 без знака равенства). Telegram передаст ссылку WebApp без изменений.
Если токен валиден и не истек, Mini App не покажет экран логина — пользователь попадет сразу в интерфейс школы.

​
Частые ошибки и как их избежать

  • Ошибка авторизации в Mini App: убедитесь, что токен передан в ___uat и не истек.
  • Пользователь не найден при выдаче токена: используйте user.id из шага создания пользователя.
  • Telegram не открывает WebApp: проверьте, что бот включил startapp и домен школы разрешен в настройках Mini App.
Не передавайте токен в открытых чатах или группах. Используйте персональные ссылки.