Технический разбор: как построить современную систему верификации телефона
Подробный взгляд на архитектуру, технологии и инженерные решения нашей платформы верификации телефона. Инфраструктура бэкенда, проектирование 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», который избавляет пользователей от необходимости вручную вводить коды верификации. Вместо этого пользователь сканирует QR-код телефоном и отправляет сообщение в WhatsApp, чтобы завершить верификацию.
Шаги процесса верификации
- Инициализация сессии: клиент запрашивает сессию верификации через POST /start-verification Так создаётся уникальный токен валидации, связанный с идентификатором сессии; оба значения хранятся в базе данных redis.
- Интеграция с WhatsApp: формируется прямой deep link WhatsApp с заранее заполненным сообщением, содержащим токен. Эту ссылку можно показать в виде QR-кода, который открывает WhatsApp с заранее заполненным сообщением нашему боту
- Извлечение номера телефона: бэкенд на Vonage получает webhook от WhatsApp и извлекает номер телефона из сообщения WhatsApp
- Валидация: система проверяет формат номера телефона и связывает его с исходной сессией с помощью токена верификации. Фронтенд может постоянно проверять статус верификации

Проектирование схемы базы данных
Supabase предоставляет надёжную базу данных PostgreSQL с возможностями реального времени, что делает её идеальным выбором для нашей системы верификации. Она служит основой портала и хранилищем информации о пользователях, API-ключей и их квот. Она также используется для журналирования и аналитики. Наша схема PostgreSQL спроектирована с расчётом на масштабируемость, безопасность и производительность. Мы применяем политики Row Level Security, чтобы пользователи имели доступ только к своим данным, а системные операции выполняют служебные роли.
Функции безопасности
- Row Level Security: пользователи имеют доступ только к собственным сессиям верификации
- Проверка API-ключа: все запросы проверяются по API-ключу
- Истечение сессий: автоматическая очистка просроченных сессий верификации
- Ограничение частоты запросов: встроенная защита от злоупотреблений и спама
- Журнал аудита: подробное журналирование всех попыток верификации
Архитектура безопасности
В системе верификации телефона безопасность имеет первостепенное значение. Мы применяем несколько уровней защиты, чтобы предотвратить мошенничество, злоупотребления и несанкционированный доступ. Мы используем токены валидации с коротким сроком жизни и кратковременное хранение полного отсканированного номера телефона без возможности просмотра списков. Мы не храним номера телефонов в открытом виде, а для аналитики и отладки используем усечённую версию.
Производительность и масштабируемость
Наша система рассчитана на большие объёмы запросов на верификацию с минимальной задержкой. Мы достигаем этого за счёт продуманных архитектурных решений и стратегий оптимизации.
Показатели производительности
Особенности масштабирования
По мере роста объёма верификаций наша архитектура масштабируется горизонтально за счёт:
- • Автоматического масштабирования Edge Functions
- • Обработки очереди webhook
- • Балансировки нагрузки между регионами
- • Автоматического масштабирования экземпляров Vonage
Интеграция и проектирование API
Наш REST API создан для простоты и надёжности. Разработчики могут встроить верификацию телефона в свои приложения всего несколькими вызовами API.
Эндпоинты API
/start-verificationИнициализация новой сессии верификации
/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: проверка географической согласованности
Аналитика воронки конверсии
Типичная конверсия от формирования QR-кода до успешной верификации
Планы развития
Мы постоянно улучшаем платформу, добавляя новые функции и оптимизации.
Начните работу
Готовы встроить верификацию телефона в своё приложение? Наш API создан для разработчиков: подробная документация и SDK для популярных языков программирования.

