Approfondimento tecnico: costruire un moderno sistema di verifica telefonica
Uno sguardo completo all'architettura, alle tecnologie e alle scelte ingegneristiche alla base della nostra piattaforma di verifica telefonica. Esplori l'infrastruttura backend, la progettazione delle API, gli aspetti di sicurezza e il flusso di verifica in tempo reale.

Panoramica del sistema
Il nostro sistema di verifica telefonica poggia su un'architettura moderna e scalabile che combina la potenza di Supabase per i servizi di backend, Vonage per l'infrastruttura di telecomunicazioni e un frontend basato su React con funzionalità in tempo reale. Il sistema è in grado di gestire migliaia di richieste di verifica con tempi di risposta inferiori al secondo e un uptime del 99,9%.
Stack frontend
- React 18 - UI a componenti con funzionalità concorrenti
- TypeScript - Sviluppo con tipizzazione sicura
- Vite - Sviluppo rapido e build ottimizzate
- Tailwind CSS - Stili utility-first con design system personalizzato
- Framer Motion - Animazioni e transizioni fluide
- React Query - Gestione dello stato del server e caching
Stack backend
- Supabase - Database PostgreSQL con sottoscrizioni in tempo reale
- Supabase Edge Functions - Runtime Deno serverless per gli endpoint API
- Supabase Row Level Security - Controllo degli accessi a livello di database
- Vonage API - Infrastruttura di telecomunicazioni
- Vonage Cloud Runtime - Servizi backend ospitati, scalabili e ad alte prestazioni
- Stripe - Elaborazione dei pagamenti e gestione degli abbonamenti

Architettura del Reverse OTP
L'innovazione centrale del nostro sistema è il flusso «Reverse OTP», che elimina la necessità di inserire manualmente i codici di verifica. Gli utenti inquadrano invece un codice QR con il telefono e inviano un messaggio WhatsApp per completare la verifica.
Fasi del flusso di verifica
- Inizializzazione della sessione: il client richiede una sessione di verifica tramite POST /start-verification Viene così generato un token di validazione univoco collegato a un ID di sessione, entrambi memorizzati in un database Redis.
- Integrazione con WhatsApp: viene generato un deep link WhatsApp diretto contenente un messaggio precompilato con il token. Il link può essere presentato come codice QR che porta a WhatsApp con un messaggio precompilato destinato al nostro bot
- Estrazione del numero: il backend ospitato su Vonage riceve un webhook da WhatsApp ed estrae il numero di telefono dal messaggio WhatsApp
- Validazione: il sistema convalida il formato del numero di telefono e lo collega alla sessione originale grazie al token di verifica. Il frontend può controllare lo stato della verifica in modo continuo

Progettazione dello schema del database
Supabase offre un database PostgreSQL robusto con funzionalità in tempo reale, che lo rende la scelta ideale per il nostro sistema di verifica. Costituisce la spina dorsale del portale e l'archivio dei dati degli utenti, delle chiavi API e delle relative quote. Viene utilizzato anche per il logging e per le analisi. Il nostro schema PostgreSQL è progettato per scalabilità, sicurezza e prestazioni. Utilizziamo policy di Row Level Security per garantire che gli utenti possano accedere solo ai propri dati, mentre i service role gestiscono le operazioni di sistema.
Funzionalità di sicurezza
- Row Level Security: gli utenti possono accedere solo alle proprie sessioni di verifica
- Validazione della chiave API: tutte le richieste vengono convalidate rispetto alla chiave API
- Scadenza delle sessioni: pulizia automatica delle sessioni di verifica scadute
- Rate limiting: protezione integrata contro abusi e spam
- Audit logging: registrazione completa di tutti i tentativi di verifica
Architettura di sicurezza
La sicurezza è fondamentale in un sistema di verifica telefonica. Implementiamo più livelli di protezione per prevenire frodi, abusi e accessi non autorizzati. Utilizziamo token di validazione di breve durata e una conservazione a breve termine del numero di telefono completo acquisito, senza alcuna possibilità di elencarlo. Non conserviamo alcun numero di telefono in chiaro e utilizziamo una versione troncata per finalità di analisi e debug.
Prestazioni e scalabilità
Il nostro sistema è progettato per gestire richieste di verifica ad alto volume con una latenza minima. Lo otteniamo grazie a scelte architetturali accurate e a strategie di ottimizzazione.
Metriche di prestazione
Considerazioni sulla scalabilità
Con la crescita del volume di verifiche, la nostra architettura scala orizzontalmente grazie a:
- • Scalabilità automatica delle Edge Function
- • Elaborazione delle code di webhook
- • Bilanciamento del carico tra le regioni
- • Scalabilità automatica delle istanze di Vonage
Integrazione e progettazione delle API
La nostra API REST è progettata per semplicità e affidabilità. Gli sviluppatori possono integrare la verifica telefonica nelle proprie applicazioni con poche chiamate API.
Endpoint API
/start-verificationInizializza una nuova sessione di verifica
/check-verification-status/{session_id}Controlla lo stato della verifica in tempo reale
Gestione di sessioni e token
Il nostro sistema di verifica utilizza un sofisticato sistema di gestione di sessioni e token per garantire la sicurezza, monitorare l'avanzamento e prevenire gli abusi. Ogni richiesta di verifica crea una sessione univoca con diversi punti di tracciamento lungo il percorso dell'utente.
Ciclo di vita della sessione
1. Creazione della sessione
Quando viene avviata una richiesta di verifica, il sistema genera:
- • ID di sessione: UUID univoco per tracciare il tentativo di verifica
- • Token di validazione: token crittograficamente sicuro incorporato nel codice QR
- • Tempo di scadenza: finestra di 15 minuti per il completamento
2. Validazione del token
Il token di validazione svolge più funzioni: autentica il messaggio WhatsApp, previene gli attacchi replay e collega il numero di telefono alla sessione corretta. I token sono monouso e scadono automaticamente.
Stati della verifica
Il sistema di verifica traccia informazioni di stato dettagliate lungo il percorso dell'utente, fornendo feedback in tempo reale e consentendo analisi precise sul comportamento degli utenti e sui tassi di conversione.
Progressione degli stati
pending
Stato iniziale quando viene creata la sessione di verifica. Il codice QR è stato generato ma non ancora scansionato.
qr_code_scanned
L'utente ha scansionato il codice QR con il proprio dispositivo. L'URL di tracciamento è stato aperto.
whatsapp_previewed
WhatsApp è stato aperto e il messaggio è stato visualizzato in anteprima, ma non ancora inviato.
opened
La conversazione WhatsApp è stata aperta completamente e il messaggio è pronto per essere inviato.
verified / sms_validated
Il numero di telefono è stato estratto e convalidato con successo. Verifica completata.
expired / failed
La sessione è scaduta (timeout di 15 minuti) oppure non è riuscita a causa di un token o di un numero di telefono non validi.
Anteprima WhatsApp e tracciamento del codice QR
Meccanismi di tracciamento avanzati monitorano l'interazione dell'utente a ogni passaggio del processo di verifica, fornendo analisi dettagliate sul comportamento degli utenti e contribuendo a ottimizzare i tassi di conversione.
Rilevamento della scansione del codice QR
Generazione dell'URL di tracciamento
Ogni codice QR contiene un URL di tracciamento univoco che registra l'evento di scansione prima di reindirizzare a WhatsApp:
https://t.phone-verif.com/t/{validation_token}?sid={session_id}Tracciamento dello stato di WhatsApp
Rilevamento dell'anteprima
WhatsApp richiama il nostro URL di tracciamento quando genera le anteprime dei link, permettendoci di rilevare quando il messaggio è in fase di composizione ma non ancora inviato.
- • Analisi dello User-Agent: distinguere i bot di anteprima di WhatsApp dagli utenti reali
- • Analisi dei tempi: distinguere l'anteprima dall'accesso effettivo
- • Geolocalizzazione IP: verificare la coerenza geografica
Analisi del funnel di conversione
Tassi di conversione tipici dalla generazione del codice QR alla verifica riuscita
Roadmap futura
Miglioriamo continuamente la piattaforma con nuove funzionalità e ottimizzazioni.
Per iniziare
Pronto a integrare la verifica telefonica nella Sua applicazione? La nostra API è pensata per gli sviluppatori, con una documentazione completa e SDK per i linguaggi di programmazione più diffusi.

