Un'API di validazione dei numeri di telefono controlla un numero prima che tu gli invii un messaggio o lo chiami. A seconda del livello, conferma formato e Paese, identifica il tipo di linea e l'operatore attuale (MNP lookup) e verifica con la rete mobile se il numero è attivo (HLR lookup). Chi invia la usa per pulire le liste, instradare sulla rete giusta, bloccare registrazioni a rischio ed evitare di pagare messaggi che non possono essere consegnati.
Cosa restituisce un'API di validazione dei numeri di telefono?
I lookup hanno più livelli, e ognuno costa di più e richiede più tempo del precedente:
| Livello | Come funziona | Restituisce | Velocità e costo |
|---|---|---|---|
| Validazione del formato | Regole dei piani di numerazione nazionali | Valido o no, Paese, forma E.164, tipo possibile | Istantaneo, spesso gratuito (librerie open source) |
| Tipo di linea e operatore | Blocchi di numerazione e database degli operatori | Mobile, fisso, VoIP, numero verde; operatore originale | Veloce, costo basso |
| MNP lookup | Database della portabilità del numero | Operatore attuale dopo la portabilità, MCC/MNC | Veloce, costo basso, non disponibile in tutti i Paesi |
| HLR lookup | Interrogazione in tempo reale del registro abbonati della rete mobile | Attivo o no, rete attuale, a volte stato di roaming | Più lento, costo più alto; solo numeri mobili |
I controlli di formato vanno messi su ogni modulo. I controlli su operatore e tipo di linea valgono la spesa in fase di registrazione e per il routing. L'HLR serve per i controlli di alto valore e la pulizia delle liste. I dettagli sono in l'HLR lookup spiegato e lookup dei numeri VoIP.
Validazione o verifica del numero: che differenza c'è?
La validazione controlla il numero: è reale, di che tipo, su quale rete. La verifica controlla la persona: dimostra di avere il numero inserendo un codice inviato via SMS o voce. Un buon flusso di registrazione fa entrambe, in quest'ordine: prima valida, così non invii OTP a numeri non validi, fissi o ad alto rischio, poi verifica con un OTP. Vedi buone pratiche per gli SMS OTP.
A cosa serve un'API di HLR lookup?
- Pulizia delle liste: elimina i numeri inattivi prima di una campagna, così non paghi messaggi non consegnabili.
- Routing: invia ogni messaggio sulla rotta della rete attuale dell'abbonato, usando i codici MCC e MNC.
- Controlli antifrode: segnala in fase di registrazione i numeri non attivi o non su una rete mobile.
- Diagnosi della consegna: quando un messaggio fallisce, verifica che il numero esista prima di dare la colpa alla rotta.
I registri dietro questi lookup sono spiegati in HLR e VLR.
Come scegliere un'API di validazione dei numeri
- Copertura per Paese: la qualità dei dati MNP e HLR cambia molto da Paese a Paese; chiedi la copertura Paese per Paese, non una promessa globale.
- Aggiornamento dei dati: ogni quanto vengono aggiornati i dati su operatori e portabilità.
- Precisione sul tuo traffico: prova un campione di numeri noti dei tuoi utenti.
- Latenza: i controlli in registrazione richiedono risposte ben sotto il secondo; l'HLR può impiegare di più.
- Modello di prezzo: a lookup, per livello; verifica se si pagano i lookup falliti o in cache.
- Privacy: dove vengono elaborate le interrogazioni e per quanto tempo vengono conservati i numeri.
Dove usare la validazione nel tuo flusso
- Nel modulo: controllo del formato mentre l'utente digita, con il Paese preselezionato, e salvataggio dei numeri in formato E.164.
- All'invio del modulo: lookup di tipo di linea e operatore; blocca le numerazioni a sovrapprezzo e applica la tua policy sui numeri VoIP.
- Prima dell'OTP: limiti di frequenza per numero, IP e dispositivo, poi invio del codice via SMS o via voce per i fissi.
- Prima delle campagne: HLR o MNP lookup sulle liste vecchie per eliminare i numeri inattivi e instradare sulla rete giusta.
La validazione dei numeri di telefono è legale?
Controllare formato e operatore per i tuoi utenti e contatti è prassi comune. L'HLR e interrogazioni di rete simili restituiscono uno stato tecnico, non l'identità del titolare, ma tratti comunque dati personali, quindi ti serve una base giuridica e devi rispettare la legge sulla privacy (per esempio il GDPR nell'UE). Non usare i lookup per profilare le persone o per costruire liste di numeri con cui non hai alcun rapporto.
Abbina la validazione a buone rotte
La validazione riduce gli sprechi, e la rotta giusta consegna ciò che resta. VoIPMatcher cerca rotte SMS A2P presso i suoi carrier e le gestisce per te. Richiedi una rotta SMS.
Domande frequenti
Esiste un'API gratuita per validare i numeri di telefono?
La validazione del formato può essere gratuita: librerie open source come libphonenumber di Google verificano offline il formato e il tipo possibile del numero. I dati su operatore, portabilità e HLR vengono da database a pagamento e da interrogazioni di rete, quindi le API che li restituiscono di solito si pagano a lookup, a volte con una piccola prova gratuita.
Che differenza c'è tra HLR lookup e MNP lookup?
Un MNP lookup consulta i database della portabilità per trovare l'operatore attuale di un numero. Un HLR lookup interroga il registro abbonati della rete mobile e può anche dire se il numero è attivo. L'MNP è più veloce ed economico; l'HLR dà lo stato in tempo reale, ma solo per i numeri mobili.
Un'API di validazione può dire se un numero è su WhatsApp?
Le API di validazione standard restituiscono dati di telecomunicazione come formato, tipo di linea, operatore e stato in rete. Sapere se un numero usa un'app di messaggistica non fa parte dei lookup telefonici, e verificarlo senza consenso può violare i termini dell'app e le regole sulla privacy.
Quanto è precisa la validazione dei numeri di telefono?
I controlli di formato sono molto precisi. I dati su tipo di linea e operatore di solito sono affidabili per distinguere mobile e fisso, ma più deboli per le categorie VoIP e per i numeri portati o assegnati di recente. I risultati HLR sono in tempo reale, ma possono fallire quando le reti limitano le interrogazioni. Prova ogni fornitore sui tuoi numeri.
Ti serve una rotta?
Mandaci destinazione, tipo di rotta e tariffa target. Ti rispondiamo con quello che possiamo offrirti.