Skip to content
Разработка
8 мин чтения29 сентября 2025 г.

Технический разбор: как построить современную систему верификации телефона

Подробный взгляд на архитектуру, технологии и инженерные решения нашей платформы верификации телефона. Инфраструктура бэкенда, проектирование API, вопросы безопасности и процесс верификации в реальном времени.

Схема технической архитектуры с компонентами системы верификации телефона

Обзор системы

Наша система верификации телефона построена на современной масштабируемой архитектуре, которая объединяет возможности Supabase для бэкенд-сервисов, Vonage для телекоммуникационной инфраструктуры и фронтенд на React с поддержкой работы в реальном времени. Система обрабатывает тысячи запросов на верификацию со временем отклика менее секунды и доступностью 99,9%.

Стек фронтенда

  • React 18 — компонентный интерфейс с конкурентными возможностями
  • TypeScript — типобезопасная разработка
  • Vite — быстрая разработка и оптимизированные сборки
  • Tailwind CSS — утилитарная стилизация с собственной дизайн-системой
  • Framer Motion — плавные анимации и переходы
  • React Query — управление серверным состоянием и кэширование

Стек бэкенда

  • Supabase — база данных PostgreSQL с подписками в реальном времени
  • Supabase Edge Functions — бессерверная среда выполнения Deno для эндпоинтов API
  • Supabase Row Level Security — контроль доступа на уровне базы данных
  • Vonage API — телекоммуникационная инфраструктура
  • Vonage Cloud Runtime — размещённые масштабируемые высокопроизводительные бэкенд-сервисы
  • Stripe — обработка платежей и управление подписками
Схема процесса интеграции Reverse OTP

Архитектура Reverse OTP

Главное новшество нашей системы — сценарий «Reverse OTP», который избавляет пользователей от необходимости вручную вводить коды верификации. Вместо этого пользователь сканирует QR-код телефоном и отправляет сообщение в WhatsApp, чтобы завершить верификацию.

Шаги процесса верификации

  1. Инициализация сессии: клиент запрашивает сессию верификации через POST /start-verification
  2. Так создаётся уникальный токен валидации, связанный с идентификатором сессии; оба значения хранятся в базе данных redis.
  3. Интеграция с WhatsApp: формируется прямой deep link WhatsApp с заранее заполненным сообщением, содержащим токен. Эту ссылку можно показать в виде QR-кода, который открывает WhatsApp с заранее заполненным сообщением нашему боту
  4. Извлечение номера телефона: бэкенд на Vonage получает webhook от WhatsApp и извлекает номер телефона из сообщения WhatsApp
  5. Валидация: система проверяет формат номера телефона и связывает его с исходной сессией с помощью токена верификации. Фронтенд может постоянно проверять статус верификации
Схема процесса интеграции Reverse OTP

Проектирование схемы базы данных

Supabase предоставляет надёжную базу данных PostgreSQL с возможностями реального времени, что делает её идеальным выбором для нашей системы верификации. Она служит основой портала и хранилищем информации о пользователях, API-ключей и их квот. Она также используется для журналирования и аналитики. Наша схема PostgreSQL спроектирована с расчётом на масштабируемость, безопасность и производительность. Мы применяем политики Row Level Security, чтобы пользователи имели доступ только к своим данным, а системные операции выполняют служебные роли.

Функции безопасности

  • Row Level Security: пользователи имеют доступ только к собственным сессиям верификации
  • Проверка API-ключа: все запросы проверяются по API-ключу
  • Истечение сессий: автоматическая очистка просроченных сессий верификации
  • Ограничение частоты запросов: встроенная защита от злоупотреблений и спама
  • Журнал аудита: подробное журналирование всех попыток верификации

Архитектура безопасности

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

Производительность и масштабируемость

Наша система рассчитана на большие объёмы запросов на верификацию с минимальной задержкой. Мы достигаем этого за счёт продуманных архитектурных решений и стратегий оптимизации.

Показатели производительности

< 200ms
Время отклика API
99.9%
SLA по доступности
до 500 запросов/с
и масштабируется

Особенности масштабирования

По мере роста объёма верификаций наша архитектура масштабируется горизонтально за счёт:

  • • Автоматического масштабирования Edge Functions
  • • Обработки очереди webhook
  • • Балансировки нагрузки между регионами
  • • Автоматического масштабирования экземпляров Vonage

Интеграция и проектирование API

Наш REST API создан для простоты и надёжности. Разработчики могут встроить верификацию телефона в свои приложения всего несколькими вызовами API.

Эндпоинты API

POST
/start-verification

Инициализация новой сессии верификации

GET
/check-verification-status/{session_id}

Проверка статуса верификации в реальном времени

Управление сессиями и токенами

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

Жизненный цикл сессии

1. Создание сессии

Когда запрос на верификацию инициирован, система генерирует:

  • • Идентификатор сессии: уникальный UUID для отслеживания попытки верификации
  • • Токен валидации: криптографически стойкий токен, встроенный в QR-код
  • • Время действия: окно в 15 минут на завершение

2. Валидация токена

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

Статусы верификации

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

Последовательность статусов

pending

Начальное состояние при создании сессии верификации. QR-код сформирован, но ещё не отсканирован.

qr_code_scanned

Пользователь отсканировал QR-код своим устройством. Открыт URL отслеживания.

whatsapp_previewed

WhatsApp открыт, сообщение показано в предпросмотре, но ещё не отправлено.

opened

Диалог WhatsApp полностью открыт, сообщение готово к отправке.

verified / sms_validated

Номер телефона успешно извлечён и проверен. Верификация завершена.

expired / failed

Срок действия сессии истёк (тайм-аут 15 минут) или произошла ошибка из-за недействительного токена или номера телефона.

Предпросмотр WhatsApp и отслеживание QR-кода

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

Обнаружение сканирования QR-кода

Формирование URL отслеживания

Каждый QR-код содержит уникальный URL отслеживания, который фиксирует событие сканирования перед перенаправлением в WhatsApp:

https://t.phone-verif.com/t/{validation_token}?sid={session_id}

Отслеживание состояния WhatsApp

Обнаружение предпросмотра

WhatsApp обращается к нашему URL отслеживания при генерации предпросмотра ссылок, что позволяет определить, что сообщение составляется, но ещё не отправлено.

  • • Анализ User-Agent: отличие ботов предпросмотра WhatsApp от реальных пользователей
  • • Анализ времени: различие между предпросмотром и реальным обращением
  • • Геолокация по IP: проверка географической согласованности

Аналитика воронки конверсии

100%
QR сформирован
~90%
QR отсканирован
~89%
WhatsApp открыт
~85%
Сообщение отправлено

Типичная конверсия от формирования QR-кода до успешной верификации

Планы развития

Мы постоянно улучшаем платформу, добавляя новые функции и оптимизации.

Начните работу

Готовы встроить верификацию телефона в своё приложение? Наш API создан для разработчиков: подробная документация и SDK для популярных языков программирования.

🚀 Бесплатный тариф: 100 верификаций в месяц
📚 Полная документация по API
🛠️ SDK для JS, Python, PHP, Go