logo
logo
Home / Verifica i telefoni / Convalida dei numeri di telefono: come funziona via API e file

Convalida dei numeri di telefono: come funziona via API e file

Aggiornato il 15 novembre 2026

La convalida dei numeri di telefono controlla che ogni numero abbia un formato e una numerazione possibili nel suo paese e, se serve, interroga la rete per sapere quale operatore lo gestisce oggi e se la linea è attiva. Puoi farla tramite API o caricando un file con tutta la lista. Il telefono non squilla e non riceve SMS.

Conviene convalidare i numeri prima di una campagna SMS o di chiamate, e ancora meglio nel momento in cui l’utente li inserisce in un modulo. Un numero sbagliato non blocca la campagna, ma ogni messaggio inviato a vuoto rischia di essere un costo senza ritorno. In questa guida vedi come funziona la convalida, quali dati restituisce e come usarla con API e file. Se vuoi controllare subito un numero, usa il campo della pagina del servizio di verifica dei numeri di telefono.

Come si convalida un numero di telefono?

Hai due strade. Con l’API di convalida del telefono invii ogni numero con una chiamata REST e in pochi secondi ricevi la risposta in JSON: è la soluzione per moduli, CRM e applicazioni. Con il file carichi l’intera lista dal pannello e, a verifica finita, scarichi il risultato in CSV o Excel.

MetodoCome funzionaQuando usarlo
Campo di verifica sul sitoInserisci un numero con il prefisso internazionale e vedi il risultato in pochi secondiControllare un numero alla volta
FileCarichi un file CSV, XLS, XLSX o TXT dal pannello e scarichi il file verificatoPulire un database prima di una campagna
API RESTUna chiamata per ogni numero, con risposta in JSONModuli di registrazione, CRM, ERP e app
Widget nei moduliIncolli il codice di verifica nel tuo moduloControllare i numeri mentre l’utente li inserisce
Assistente IA (MCP)Chiedi la convalida a un assistente come ChatGPT o Claude collegato a VerificarEmails tramite MCPControlli puntuali senza scrivere codice

Convalida in tempo reale tramite API

L’API serve quando i numeri arrivano uno alla volta: un utente si registra, un lead compila un modulo, un collega aggiorna una scheda nel CRM. Il tuo sistema invia il numero insieme alla chiave API e in pochi secondi riceve la risposta: se il numero è valido e, in base al tipo di verifica, il paese, il tipo di linea e l’operatore. La chiave la generi dal pannello dopo la registrazione.

Lo stesso controllo si usa nei moduli di registrazione, come per le email: trovi un esempio pratico, con il codice, nell’articolo su come convalidare un’email in PHP in modo sicuro. Così eviti che gli utenti inseriscano numeri errati o in formati difficili da usare.

Convalida di una lista tramite file

Se hai già i numeri in un file, lo carichi sulla piattaforma e il servizio li verifica in automatico. Quando ha finito, scarichi il risultato in CSV o Excel. Prima di caricare la lista, controlla che i numeri abbiano il prefisso internazionale: per l’Italia +39, senza togliere lo 0 dei fissi. Trovi tutti i passaggi nella guida su come scrivere un numero di telefono in formato internazionale.

Quali dati ottieni dalla convalida di un numero di telefono?

Dipende dal tipo di verifica. Quella sintattica restituisce il numero normalizzato nei formati E.164, internazionale e nazionale e ti dice se è un fisso o un cellulare. La verifica MNP aggiunge l’operatore attuale e la portabilità. L’HLR aggiunge lo stato della linea e il codice IMSI. Con l’API ricevi tutto in formato JSON.

Campo della rispostaCosa indicaEsempio
format.e164Numero in formato E.164, senza spazi+393XXXXXXXXX
format.internationalFormato internazionale leggibile+39 3XX XXX XXXX
format.nationalFormato nazionale3XX XXX XXXX
number_typeTipo di numeromobile (cellulare), landline (fisso)
current_network.country_namePaese della reteItaly
current_network.network_nameOperatore che gestisce il numero ogginome dell’operatore
original_network.network_nameOperatore che ha assegnato il numeronome dell’operatore
is_portedSe il numero è passato a un altro operatoretrue / false
reachableStato della linea (solo HLR)connected, absent
imsiIdentificativo della SIM (solo HLR, se l’operatore lo fornisce)codice numerico

Il campo reachable vale connected quando il cellulare si è connesso di recente alla rete e absent quando in questo momento non è raggiungibile, per esempio perché è spento o senza copertura. In Italia lo stato della linea è disponibile con Vodafone, WINDTRE, Iliad e altri operatori, ma non con TIM, Fastweb e PosteMobile: per questi numeri ottieni operatore e portabilità, non lo stato. Per approfondire, leggi come capire se un numero è attivo senza chiamare.

Come funziona il processo di convalida?

La convalida procede per livelli. Prima si controlla la sintassi: prefisso internazionale, numero di cifre e intervallo di numerazione del paese. Se il numero supera questo controllo, si interroga la rete degli operatori per sapere chi lo gestisce oggi e, per i cellulari, se la linea è attiva. Ogni livello aggiunge informazioni al precedente.

  1. Normalizzazione: il numero viene letto senza spazi e simboli e riportato al formato internazionale, con il prefisso del paese (+39 per l’Italia).
  2. Controllo sintattico: si verifica che lunghezza e numerazione siano possibili in quel paese. Conviene scartare qui i numeri impossibili, prima di pagare una verifica sulla rete.
  3. Tipo di numero: dall’intervallo di numerazione si capisce se è un fisso, un cellulare o un numero speciale, come i numeri verdi 800 e 803 o quelli a tariffazione speciale 899.
  4. Operatore attuale (MNP): in Italia la portabilità esiste dal 2002, quindi il prefisso indica al massimo l’operatore che ha assegnato il numero. La verifica MNP dice quale lo gestisce oggi.
  5. Stato della linea (HLR): per i cellulari, l’HLR lookup interroga la rete mobile e dice se il numero si è connesso di recente, quando l’operatore fornisce questo dato.

Che differenza c’è tra verifica sintattica, MNP e HLR?

Cambia la quantità di informazioni. La verifica sintattica guarda solo il numero e la numerazione del paese, senza interrogare la rete. L’MNP lookup chiede alla rete quale operatore gestisce oggi il numero. L’HLR lookup aggiunge se il cellulare è connesso. La sintattica è la verifica più economica, l’HLR quella che ti dà più dati.

Verifica sintatticaMNP lookupHLR lookup
Formato e numerazione validiSìSìSì
Numero normalizzato in E.164SìSìSì
Operatore attuale (dopo la portabilità)NoSìSì
Numero portato da un altro operatoreNoSìSì
Linea attiva (connessa di recente alla rete)NoNoSì, se l’operatore lo comunica
Codice IMSINoNoSì
Quando usarlaPer pulire il formato di un database a basso costoPer conoscere l’operatore e instradare gli SMSPrima di campagne SMS o chiamate, per sapere se la linea è attiva

Prezzi e dettagli di ogni verifica sono nella pagina del servizio. Se ti interessa soprattutto lo stato dei cellulari, leggi la pagina sulla verifica dei cellulari con HLR lookup.

Perché conviene convalidare i numeri prima di una campagna SMS?

Perché, se il tuo fornitore fa pagare ogni invio, ogni messaggio diretto a un numero inesistente o a una linea disattivata è un costo senza ritorno. Il calcolo è semplice: numeri non validi per costo di un SMS. Su una lista di 50.000 numeri, se il 10 % non fosse valido, pagheresti 5.000 messaggi che non arrivano a nessuno.

A questo si aggiunge il costo opportunità: i clienti che non ricevono l’offerta e il tempo perso a gestire gli errori. Il modo più semplice per evitarlo è convalidare il numero già nel modulo di registrazione, con l’API o con il widget. Per le liste che hai già, basta una convalida tramite file prima di ogni invio importante.

Convalida e aggiornamento dei dati di contatto

Dopo la convalida, alcune aziende fanno una chiamata automatica al numero per aggiornare gli altri dati del contatto, come nome, cognome o email: è l’utente stesso a confermarli con la voce o con la tastiera. La stessa chiamata si può usare per azioni di marketing vocale. Prima di chiamare per scopi commerciali, controlla che il numero non sia iscritto al Registro pubblico delle opposizioni, che dal 27 luglio 2022 comprende anche i cellulari.

Hai bisogno di aiuto per integrare la convalida nei tuoi sistemi? Contattaci e ti aiutiamo a scegliere il metodo più adatto. Puoi anche registrarti gratis e usare i crediti gratuiti per provare la convalida su un file o tramite API.

Domande frequenti

Un numero con un formato valido è sicuramente attivo?

No. La verifica sintattica dice solo che il numero è possibile nel suo paese: lunghezza e numerazione sono corrette. Non interroga la rete, quindi il numero potrebbe non essere assegnato o la linea potrebbe essere disattivata. Per i cellulari serve l’HLR, che in Italia dà lo stato della linea con molti operatori, ma non con TIM, Fastweb e PosteMobile.

Si possono convalidare anche i numeri fissi?

Sì. Per un numero fisso la verifica sintattica controlla formato e numerazione, ti dice che si tratta di una linea fissa e ti restituisce i formati nazionale e internazionale. L’HLR, invece, interroga la rete mobile: lo stato della linea riguarda solo i cellulari. Ricorda che in Italia i fissi conservano lo 0 anche dopo il +39.

Il titolare del numero si accorge della convalida?

No. Né la verifica sintattica né l’HLR lookup fanno squillare il telefono o inviano SMS, quindi il titolare non vede nulla. La convalida non rivela nemmeno il nome, l’indirizzo o la posizione di chi usa il numero: in Italia sono dati protetti, che l’operatore comunica solo all’autorità giudiziaria.

È la stessa cosa del codice di verifica che inviano Google o WhatsApp?

No. Quando un servizio ti chiede di verificare il tuo numero, ti invia un codice via SMS per confermare che il numero è tuo. La convalida dei numeri di telefono, invece, controlla un numero o un’intera lista senza inviare nulla: ti dice se il numero è valido, quale operatore lo gestisce e, per i cellulari, se la linea è attiva.

In che formato devo inserire i numeri da convalidare?

Con il prefisso internazionale e senza spazi né simboli. Per un cellulare italiano scrivi +39 seguito dal numero, per esempio +393XXXXXXXXX; per un fisso tieni lo 0 del prefisso di zona, come in +3906XXXXXXXX. Se la tua lista contiene numeri senza prefisso, aggiungilo prima di caricare il file, così ogni numero viene letto con il paese giusto.

Leggi anche: Come verificare i numeri di telefono prima della tua campagna SMS: guida passo dopo passo · Come convalidare e-mail e numeri di telefono in n8n

- MIGLIORARE LA QUALITÀ DEI VOSTRI DATI IN MODO SEMPLICE -
VERIFICA LE E-MAIL
TELEFONI
INDIRIZZI POSTALI
NOMI E NOMI...