Análisis técnico: cómo construir un sistema moderno de verificación telefónica
Una mirada completa a la arquitectura, las tecnologías y las decisiones de ingeniería detrás de nuestra plataforma de verificación telefónica. Conozca la infraestructura de backend, el diseño de la API, las consideraciones de seguridad y el flujo de verificación en tiempo real.

Visión general del sistema
Nuestro sistema de verificación telefónica se basa en una arquitectura moderna y escalable que combina la potencia de Supabase para los servicios de backend, Vonage para la infraestructura de telecomunicaciones y un frontend en React con capacidades en tiempo real. El sistema puede procesar miles de solicitudes de verificación con tiempos de respuesta inferiores a un segundo y una disponibilidad del 99.9 %.
Stack de frontend
- React 18 - Interfaz basada en componentes con funciones concurrentes
- TypeScript - Desarrollo con tipado seguro
- Vite - Desarrollo rápido y compilaciones optimizadas
- Tailwind CSS - Estilos utility-first con un sistema de diseño personalizado
- Framer Motion - Animaciones y transiciones fluidas
- React Query - Gestión y caché del estado del servidor
Stack de backend
- Supabase - Base de datos PostgreSQL con suscripciones en tiempo real
- Supabase Edge Functions - Entorno serverless Deno para los endpoints de la API
- Supabase Row Level Security - Control de acceso a nivel de base de datos
- Vonage API - Infraestructura de telecomunicaciones
- Vonage Cloud Runtime - Servicios de backend alojados, escalables y de alto rendimiento
- Stripe - Procesamiento de pagos y gestión de suscripciones

Arquitectura de Reverse OTP
La principal innovación de nuestro sistema es el flujo "Reverse OTP", que elimina la necesidad de que los usuarios escriban códigos de verificación manualmente. En su lugar, escanean un código QR con su teléfono y envían un mensaje de WhatsApp para completar la verificación.
Pasos del flujo de verificación
- Inicialización de la sesión: El cliente solicita una sesión de verificación mediante POST /start-verification Esto genera un token de validación único vinculado a un ID de sesión; ambos se almacenan en una base de datos Redis.
- Integración con WhatsApp: Se genera un enlace directo a WhatsApp que contiene un mensaje precompletado con el token. Este enlace puede presentarse como un código QR que lleva a WhatsApp con un mensaje precompletado dirigido a nuestro bot
- Extracción del teléfono: El backend alojado en Vonage recibe un webhook de WhatsApp y extrae el número de teléfono del mensaje de WhatsApp
- Validación: El sistema valida el formato del número de teléfono y lo vincula con la sesión original gracias al token de verificación. El frontend puede consultar el estado de la verificación de forma continua

Diseño del esquema de la base de datos
Supabase ofrece una base de datos PostgreSQL robusta con capacidades en tiempo real, lo que la convierte en una elección ideal para nuestro sistema de verificación. Es la columna vertebral del portal y el almacén de datos de la información de los usuarios, las claves de API y sus cuotas. También se usa para registros y analítica. Nuestro esquema de PostgreSQL está diseñado para la escalabilidad, la seguridad y el rendimiento. Usamos políticas de Row Level Security para garantizar que los usuarios solo accedan a sus propios datos, mientras que los roles de servicio se encargan de las operaciones del sistema.
Funciones de seguridad
- Row Level Security: Los usuarios solo pueden acceder a sus propias sesiones de verificación
- Validación de la clave de API: Todas las solicitudes se validan contra la clave de API
- Expiración de sesiones: Limpieza automática de las sesiones de verificación vencidas
- Limitación de tasa: Protección integrada contra abuso y spam
- Registro de auditoría: Registro exhaustivo de todos los intentos de verificación
Arquitectura de seguridad
La seguridad es fundamental en un sistema de verificación telefónica. Implementamos varias capas de protección para prevenir el fraude, el abuso y el acceso no autorizado. Usamos tokens de validación de corta duración y un almacenamiento a corto plazo del número de teléfono completo escaneado, sin posibilidad de listarlo. No conservamos ningún número de teléfono en claro y usamos una versión truncada para fines de analítica y depuración.
Rendimiento y escalabilidad
Nuestro sistema está diseñado para procesar solicitudes de verificación de alto volumen con una latencia mínima. Lo logramos mediante decisiones de arquitectura cuidadosas y estrategias de optimización.
Métricas de rendimiento
Consideraciones de escalado
A medida que crece el volumen de verificaciones, nuestra arquitectura escala horizontalmente mediante:
- • Escalado automático de las Edge Functions
- • Procesamiento de webhooks mediante colas
- • Balanceo de carga entre regiones
- • Escalado automático de las instancias de Vonage
Integración y diseño de la API
Nuestra API REST está diseñada para ser simple y confiable. Los desarrolladores pueden integrar la verificación telefónica en sus aplicaciones con solo unas pocas llamadas a la API.
Endpoints de la API
/start-verificationInicializa una nueva sesión de verificación
/check-verification-status/{session_id}Consulta el estado de la verificación en tiempo real
Gestión de sesiones y tokens
Nuestro sistema de verificación usa una gestión sofisticada de sesiones y tokens para garantizar la seguridad, seguir el progreso y prevenir abusos. Cada solicitud de verificación crea una sesión única con varios puntos de seguimiento a lo largo del recorrido del usuario.
Ciclo de vida de la sesión
1. Creación de la sesión
Cuando se inicia una solicitud de verificación, el sistema genera:
- • ID de sesión: UUID único para hacer seguimiento del intento de verificación
- • Token de validación: Token criptográficamente seguro incrustado en el código QR
- • Tiempo de expiración: Ventana de 15 minutos para completar el proceso
2. Validación del token
El token de validación cumple varias funciones: autenticar el mensaje de WhatsApp, prevenir ataques de repetición y vincular el número de teléfono con la sesión correcta. Los tokens son de un solo uso y expiran automáticamente.
Estados de la verificación
El sistema de verificación registra información de estado detallada a lo largo del recorrido del usuario, lo que permite dar retroalimentación en tiempo real y obtener analítica precisa sobre el comportamiento del usuario y las tasas de conversión.
Progresión de estados
pending
Estado inicial cuando se crea la sesión de verificación. El código QR se genera, pero aún no se ha escaneado.
qr_code_scanned
El usuario escaneó el código QR con su dispositivo. Se accedió a la URL de seguimiento.
whatsapp_previewed
Se abrió WhatsApp y se mostró una vista previa del mensaje, pero aún no se ha enviado.
opened
La conversación de WhatsApp se abrió por completo y el mensaje está listo para enviarse.
verified / sms_validated
El número de teléfono se extrajo y se validó correctamente. Verificación completada.
expired / failed
La sesión expiró (tiempo límite de 15 min) o falló por un token o número de teléfono no válido.
Vista previa de WhatsApp y seguimiento del código QR
Mecanismos avanzados de seguimiento monitorean la interacción del usuario en cada paso del proceso de verificación, con analítica detallada sobre su comportamiento que ayuda a optimizar las tasas de conversión.
Detección del escaneo del código QR
Generación de la URL de seguimiento
Cada código QR contiene una URL de seguimiento única que registra el evento de escaneo antes de redirigir a WhatsApp:
https://t.phone-verif.com/t/{validation_token}?sid={session_id}Seguimiento del estado de WhatsApp
Detección de la vista previa
WhatsApp llama a nuestra URL de seguimiento al generar las vistas previas de los enlaces, lo que nos permite detectar cuándo se está redactando el mensaje pero aún no se ha enviado.
- • Análisis del User-Agent: Distingue los bots de vista previa de WhatsApp de los usuarios reales
- • Análisis de tiempos: Diferencia entre la vista previa y el acceso real
- • Geolocalización por IP: Verifica la coherencia geográfica
Analítica del embudo de conversión
Tasas de conversión típicas desde la generación del código QR hasta una verificación exitosa
Hoja de ruta
Mejoramos continuamente la plataforma con nuevas funciones y optimizaciones.
Comience ahora
¿Listo para integrar la verificación telefónica en su aplicación? Nuestra API está pensada para desarrolladores, con documentación completa y SDK para los lenguajes de programación más populares.

