Авторизация в Telegram Mini App по Flash Call строится так: пользователь вводит номер телефона, сервис отправляет короткий входящий звонок, а приложение получает подтверждение после проверки номера и кода из звонка. Такой сценарий помогает заменить SMS-OTP в регистрации, входе и подтверждении заказа. В статье разберём архитектуру решения, порядок подключения, требования к интерфейсу и ошибки, которые часто мешают запуску у малого бизнеса в Беларуси.
Зачем Mini App нужна авторизация по номеру телефона?
Telegram Mini App открывается внутри Telegram, но бизнесу часто требуется собственная проверка номера. Например, пользователь записывается на услугу, оформляет заказ или получает доступ к персональному разделу. Одного факта открытия приложения недостаточно: системе нужно связать действие с конкретным номером телефона.
Flash Call использует входящий звонок вместо текстового сообщения. Пользователь указывает номер, после чего получает короткий вызов. В зависимости от выбранного сценария приложение проверяет сам факт звонка, последние цифры номера или код, который сообщает сервис авторизации. Голосовой OTP работает похожим образом, но код передаётся в голосовом сообщении. Различия между такими каналами разобраны в материале «Voice OTP и Flash Call: чем заменить SMS-код».
Для Mini App это особенно удобно в двух точках:
- при первом входе, когда нужно создать профиль пользователя;
- перед действием, которое связано с заказом, записью или изменением контактных данных.
Telegram при этом остаётся оболочкой для интерфейса и общения с пользователем. Flash Call отвечает за отдельный этап подтверждения номера, а сервер бизнеса связывает результат проверки с учётной записью. Эти части лучше разделить заранее: тогда замена интерфейса или способа доставки кода не потребует переделки всей Mini App.
Как выглядит схема авторизации в Telegram Mini App?
Минимальная схема состоит из четырёх элементов: интерфейса Mini App, сервера приложения, API сервиса Flash Call и базы пользователей. Пользователь видит только форму номера и экран подтверждения. Остальные действия проходят между сервером и внешним API.
- Пользователь открывает Mini App и выбирает вход по номеру телефона.
- Приложение проверяет формат номера и передаёт запрос на свой сервер.
- Сервер создаёт попытку авторизации и отправляет запрос в API Flash Call.
- Сервис инициирует короткий звонок на указанный номер.
- Пользователь подтверждает звонок способом, который предусмотрен вашим сценарием.
- Сервер получает результат проверки и создаёт сессию пользователя в Mini App.
Ключевой принцип здесь простой: секретные ключи API не попадают в код Mini App. Клиентская часть только отправляет номер и получает статус операции. Запрос к Flash Call выполняет сервер, где можно проверить срок действия попытки, повторный запрос и соответствие результата конкретному пользователю.
Для Telegram Mini App нужно отдельно продумать связь между Telegram-пользователем и номером телефона. Идентификатор Telegram помогает понять, кто открыл приложение, а Flash Call подтверждает номер. Если один человек войдёт с другого аккаунта Telegram, правила объединения профилей должны быть определены заранее.
Как подготовить Flash Call API и пользовательский сценарий?
Начните с одного сценария. Для малого бизнеса обычно достаточно входа по номеру или подтверждения заказа. Не стоит сразу добавлять несколько вариантов авторизации, повторную регистрацию и сложную систему ролей: сначала проверьте путь от нажатия кнопки до создания сессии.
На сервере понадобятся следующие операции:
- создание попытки с уникальным идентификатором;
- отправка номера в API Flash Call;
- получение статуса звонка;
- проверка результата по идентификатору попытки;
- завершение сессии после успешной авторизации;
- обработка отказа, истечения времени и повторной попытки.
В Mini App пользователь должен видеть понятные состояния: «запрашиваем звонок», «ожидаем подтверждение», «номер подтверждён», «попробуйте ещё раз». Кнопка повторного запроса не должна отправлять десятки одинаковых запросов подряд. Для неё задайте паузу и показывайте причину, если предыдущая попытка ещё не завершилась.
До разработки интерфейса зафиксируйте правила: сколько времени действует попытка, сколько раз разрешён повтор, что делать при занятом номере и куда направить пользователя при ошибке. Точные лимиты зависят от выбранной интеграции, поэтому их нужно проверить в документации и настройках подключаемого сервиса.
Если Mini App уже работает на сайте или в CMS, полезно сначала оценить готовые варианты подключения Flash Call. Например, отдельный разбор посвящён интеграции Flash Call с Tilda и WordPress. Для Telegram Mini App серверная часть всё равно остаётся важной, но такой материал помогает понять состав типового подключения.
Чем Flash Call отличается от SMS-кода?
SMS остаётся привычным способом подтверждения, однако код может прийти с задержкой или не дойти из-за особенностей маршрутизации и фильтрации сообщений. Call-based каналы передают подтверждение через звонок. Их выбирают, когда пользователю важно быстро завершить вход, а бизнес хочет иметь дополнительный канал авторизации.
| Критерий | SMS-OTP | Flash Call |
|---|---|---|
| Канал доставки | Текстовое сообщение | Короткий входящий звонок |
| Действие пользователя | Прочитать и ввести код | Подтвердить звонок или использовать код из сценария |
| Что проверяет сервер | Совпадение введённого кода | Результат проверки номера и попытки |
| Где использовать | Регистрация и вход | Вход, подтверждение заказа, повторная проверка номера |
Выбор зависит от аудитории и процесса. Если клиентам привычнее вводить цифры, интерфейс можно оставить похожим на SMS-форму. Если главная задача — убрать ручной ввод, настройте сценарий с подтверждением входящего звонка. Сравнение Flash Call с другими способами авторизации для малого бизнеса приведено в материале «Flash Call, Mobile ID или SIM Push: что выбрать малому бизнесу».
Какие ошибки мешают запуску авторизации?
- Ключ API хранится в Mini App. Любые секреты передавайте только через сервер.
- Номер связывают с профилем без проверки результата. Сначала дождитесь успешного статуса операции, затем создавайте сессию.
- Нет защиты от повторных запросов. Ограничьте кнопку повтора и связывайте каждую попытку с отдельным идентификатором.
- Пользователь не понимает, что делать после звонка. Напишите короткую инструкцию прямо на экране.
- Ошибки API показывают техническим текстом. Замените их сообщениями «номер не подтверждён», «попробуйте снова» или «проверьте формат номера».
- Не проверяют разные типы номеров. Перед запуском протестируйте мобильные номера, повторные попытки и прерванный сценарий.
3 шага, которые можно сделать на этой неделе:
- Описать один путь пользователя: вход в Mini App или подтверждение заказа.
- Нарисовать состояния экрана и определить, какие статусы возвращает сервер.
- Собрать тестовую интеграцию, где Telegram Mini App обращается к вашему серверу, а сервер отправляет запрос в Flash Call API.
После теста станет понятно, нужен ли Flash Call только для первого входа или также для подтверждения важных действий. Для продуктовой команды это удобная граница запуска: сначала проверяется авторизация по номеру, затем при необходимости добавляются подтверждение заказа и напоминания клиентам через тот же сценарий входящего звонка.
