API di verifica telefonica
Verifichi che gli utenti siano davvero titolari del numero di telefono indicato.
Confermi la proprietà del numero in pochi secondi
La verifica del numero di telefono è il fondamento di ogni esperienza utente affidabile. Invii una password monouso (OTP) via SMS, WhatsApp o chiamata vocale e confermi la titolarità in pochi secondi.
Che cos'è la verifica telefonica?
La verifica telefonica consiste nel dimostrare che la persona che si ha di fronte controlla davvero il numero di telefono che ha digitato. Un numero in un modulo è una dichiarazione; la verifica la trasforma in una prova. Senza di essa, un campo di registrazione accetta errori di battitura, numeri usa e getta, numeri altrui e qualunque cosa uno script decida di incollare.
Questa prova è utile per tre motivi distinti. Offre un canale di contatto funzionante, così reset di password e notifiche di consegna raggiungono un telefono reale. Offre un identificatore stabile per un account, ciò che rende costosi multi-account e abuso dei bonus. E offre un secondo fattore a cui ricorrere in seguito, senza chiedere all'utente di registrare nulla di nuovo.
Come funziona la verifica telefonica
Ogni flusso di verifica telefonica si basa sulla stessa idea: sul telefono deve accadere qualcosa che solo chi lo possiede può causare. La versione classica invia un codice monouso via SMS e chiede all'utente di digitarlo. Phone-Verif lo fa al contrario, perché è l'utente a inviare un messaggio anziché riceverlo, ma lo schema è lo stesso: creare una sessione, presentare una sfida, attendere la prova, leggere il risultato.
In pratica, dal Suo lato ci sono tre elementi. Una chiamata che apre una sessione di verifica e restituisce qualcosa da mostrare all'utente. Una schermata o un widget in cui l'utente agisce. E un modo per conoscere l'esito, tramite una callback oppure leggendo lo stato della sessione.
Verifica tramite WhatsApp
WhatsApp è qui il canale principale. L'API restituisce un deep link WhatsApp che contiene un breve token di sessione; lo si mostra come codice QR su desktop o come pulsante su dispositivi mobili. L'utente lo tocca, WhatsApp si apre con il messaggio già scritto e lui lo invia. WhatsApp comunica al server il numero mittente e, poiché WhatsApp ha verificato quel numero al momento della creazione dell'account, si eredita una prova che non è stato necessario costruire.
Quanta parte del traffico venga coperta dipende interamente dal mercato. L'uso di WhatsApp è quasi universale in Brasile, India e gran parte di Europa e Africa, e marginale negli Stati Uniti, in Giappone e in Corea del Sud. Conviene controllare dove si trovano davvero gli utenti prima di decidere quanto fallback serva.
Verifica via SMS e fallback
Per gli utenti senza WhatsApp, la stessa sessione accetta lo stesso token via SMS: l'utente invia il token come semplice messaggio di testo al numero di verifica. La sessione, il token e lo stato che si legge poi sono identici, quindi l'integrazione non si ramifica: cambia soltanto l'istruzione mostrata all'utente.
Conta più di quanto sembri. Un flusso solo WhatsApp perde silenziosamente tutti i mercati a bassa adozione; un flusso solo SMS paga un operatore per ogni tentativo, compresi quelli attivati da un bot. Mantenere entrambi su un'unica sessione consente di privilegiare il canale economico e sicuro raggiungendo comunque tutti gli altri.
Reverse OTP: perché la direzione conta
In un flusso OTP tradizionale il server invia un segreto e spera che arrivi al telefono giusto e a nessun altro. È questo presupposto che sfruttano sia gli attacchi di SIM swap sia il phishing degli OTP, ed è ciò che rende redditizio il traffico gonfiato artificialmente: ogni tentativo costa un messaggio, che dietro ci sia o meno un utente reale.
Il Reverse OTP elimina il presupposto. All'utente non viene inviato alcun segreto, quindi non c'è nulla da intercettare, nulla da sottrargli con il phishing e nessun messaggio in uscita con cui un truffatore possa farLe pagare dei costi. La prova è l'atto stesso di inviare dell'utente.
Il flusso di verifica, dall'inizio alla fine
Una sessione parte nello stato pending. Passa a whatsapp_previewed quando l'utente vede il messaggio precompilato, a opened quando apre il link e a verified quando il messaggio arriva e viene abbinato alla sessione. Se nessuno agisce in tempo, termina invece in expired.
Solo lo stato verified contiene il numero di telefono; fino ad allora il campo è null. Consideri lo stato come il segnale e il numero come il suo contenuto, mai il contrario: questa sola regola elimina la maggior parte delle race condition in cui ci si imbatte alla prima integrazione.
Integrare l'API
L'integrazione consiste in due chiamate REST. POST /start-verification apre una sessione e restituisce il numero WhatsApp, il deep link e un URL web ospitato, se si preferisce reindirizzare anziché costruire una propria schermata. GET /check-verification-status restituisce lo stato della sessione e, una volta verificato, il numero stesso.
È possibile saltare del tutto l'interfaccia e incorporare in un iframe la pagina di verifica ospitata, la via più rapida per avere qualcosa di funzionante. In ogni caso, in produzione si preferisca la callback a un ciclo di polling, e si faccia polling solo in sviluppo o quando l'utente torna esplicitamente alla pagina.
Sicurezza e privacy
Le sessioni hanno vita breve e ogni token è legato a una sola di esse, quindi un messaggio riproposto non corrisponde a nulla. Il numero ricevuto proviene dall'infrastruttura di WhatsApp e non dall'input dell'utente, il che chiude la falla per cui un utente può semplicemente digitare il numero di qualcun altro e attendere un codice che ha intercettato.
Sul fronte della privacy, il flusso sposta meno dati personali di quello che sostituisce: nessun codice viaggia su una rete telefonica per raggiungere l'utente, e si conserva il numero verificato anziché una scia di tentativi di consegna.
Prezzi
Le verifiche sono fatturate come crediti prepagati. Non c'è alcun abbonamento e i crediti non scadono: un picco stagionale di registrazioni costa quel che costa e un mese tranquillo non costa nulla. I nuovi account partono con crediti gratuiti, sufficienti per provare il flusso da cima a fondo in un ambiente di staging prima di impegnarsi.
Domande frequenti
- Che cos'è un'API di verifica telefonica?
- Un'API di verifica telefonica è un'interfaccia HTTP che dimostra che un utente controlla un numero di telefono. La si chiama per aprire una sessione di verifica, si mostra all'utente ciò che restituisce e si legge un numero verificato dopo che l'utente ha agito.
- La verifica telefonica funziona senza WhatsApp?
- Sì. La stessa sessione accetta il token di verifica via SMS, quindi gli utenti senza WhatsApp inviano il token come semplice messaggio di testo. L'integrazione legge il risultato dallo stesso endpoint in entrambi i casi.
- Quanto dura una verifica?
- La chiamata API è immediata; il resto è l'utente che inquadra un codice e tocca invio. In pratica la maggior parte delle sessioni si completa in pochi secondi anziché in minuti, perché non c'è alcuna fase di consegna da parte dell'operatore da attendere.
- Che cosa restituisce l'API una volta verificato un numero?
- Lo stato della sessione diventa verified e la risposta contiene il numero di telefono convalidato insieme ai timestamp di ogni passaggio compiuto. Prima di allora il campo del numero è null.
- La verifica telefonica coincide con l'autenticazione a due fattori?
- No. La verifica telefonica dimostra che il numero appartiene all'utente, di solito una sola volta, alla registrazione. L'autenticazione a due fattori ricontrolla quella prova al momento dell'accesso o prima di un'azione sensibile. La stessa API copre entrambe, ma rispondono a domande diverse.
Related
Scenari comuni
Verifica dei contatti
Confermi che gli utenti forniscano numeri di telefono reali e raggiungibili.
Onboarding dei clienti
Costruisca fiducia con recapiti verificati fin dal primo giorno.
Convalida dei numeri
Scarti i numeri non validi, usa e getta o irraggiungibili.
Conferma dell'identità dell'utente
Colleghi un numero di telefono a un profilo utente per un riconoscimento sicuro dell'identità.
Build your verifica telefonica flow today
Start integrating in minutes with clear documentation, SDKs, and global message delivery.