API HLR di CaptainVerify

API HLR

Con l'API Captain Verify, puoi integrare la verifica HLR Lookup nelle tue applicazioni. Puoi anche dare un'occhiata alla documentazione HLR.

Chiave dell'API

È necessario un account per generare la chiave per l'API, questo è ciò che ti darà accesso al servizio.

La richiesta

Per effettuare una richiesta all'API, basta chiamare il protocollo GET a questo URL:

https://api.captainverify.com/verify?phone={PHONE_NUMBER}&apikey=XXXXXXXXXXXXXXXXXXXX

Sostituisci {PHONE_NUMBER} con il numero di cellulare da verificare (in formato internazionale)

Limiti dell'API

L'API è limitata a un massimo di 2 connessioni simultanee e 50 controlli al minuto. Quando integri l'API, assicurati che la tua applicazione non superi questo limite.

La risposta

Verrà restituita una tabella json con queste variabili:

Variabili	Valore possibile
status	true, false. Lo stato della richiesta.
credits	89 Crediti disponibili nel tuo account.
message	default : null Quando lo stato è falso, verrà inviato un messaggio di errore.
requested_number	33600000000 Il numero di cellulare da interrogare.
formatted_number	+33600000000 Il numero di cellulare in formato internazionale.
network	Free Mobile Il nome della rete.
original_network	Orange Il nome della rete originale.
roaming	true, false Stato di roaming attuale.
ported	true, false Se l'utente ha cambiato operatore con lo stesso numero.
country	France Il nome completo del paese per il numero richiesto.
country_prefix	33 Il prefisso numerico del paese del numero.
details	DELIVERED_TO_HANDSET, UNDELIVERABLE_NOT_DELIVERED DELIVERED_TO_HANDSET : La verifica HLR è stata elaborata (numero assegnato). UNDELIVERABLE_NOT_DELIVERED: La verifica HLR non è stata completata (numero non assegnato).
result	Lo stato del numero: valido, non valido, sconosciuto Se tutti i tuoi crediti sono stati esauriti, verrà sempre restituito lo stato sconosciuto, per non bloccare la tua domanda.

Perché integrare un'API HLR?

Un file di numeri mobili invecchia in fretta. Alcune linee vengono cessate, alcuni numeri cambiano operatore, altri contengono un errore di digitazione e non sono mai esistiti. Ogni SMS inviato verso un numero non valido viene fatturato, ma non arriva mai. Su una campagna di diverse migliaia di messaggi, questi invii persi pesano direttamente sul budget senza produrre il minimo ritorno.

Il problema va oltre l'SMS. Nella prospezione telefonica, un file inquinato da numeri cessati fa perdere tempo ai team: ogni chiamata verso una linea morta è una chiamata che non andrà a buon fine. Le statistiche di campagna diventano illeggibili, la deliverability SMS si degrada e diventa impossibile distinguere un messaggio ignorato da un messaggio mai consegnato.

Un'API HLR affronta il problema alla radice. L'HLR (Home Location Register) è il registro degli operatori che censisce lo stato delle linee mobili. Interrogando la rete dell'operatore in tempo reale, l'API conferma che una linea è attiva prima che tu la contatti. Smetti di inviare alla cieca e non paghi più per raggiungere numeri che non esistono più.

Casi d'uso dell'API HLR

Pulizia di un file di numeri mobili prima di una campagna SMS

Prima di un invio massivo, passa ogni numero attraverso l'API. Le linee attive vengono conservate, i numeri cessati o non validi vengono esclusi dal file. Paghi solo SMS che hanno una possibilità reale di essere consegnati, e i tassi della tua campagna riflettono la qualità del tuo messaggio invece dell'usura della tua base.

Filtraggio prima della prospezione telefonica

Un call center perde denaro a ogni numero morto composto. Verificando lo stato delle linee a monte, trasmetti ai team solo numeri attivi. I commerciali passano il loro tempo a parlare con i prospect, non ad ascoltare messaggi di errore dell'operatore. Il costo per contatto utile scende meccanicamente.

Rilevamento dei numeri cessati in un CRM

Le schede contatto di un CRM si degradano in silenzio. Una verifica HLR periodica identifica le linee cessate e permette di contrassegnare queste schede, avviare un aggiornamento o passare a un altro canale di contatto. La tua base resta utilizzabile invece di accumulare numeri morti che falsano tutti i tuoi indicatori.

Identificazione dell'operatore reale nonostante la portabilità

Un numero portato conserva il suo prefisso di origine ma dipende ormai da un altro operatore. La risposta dell'API distingue la rete attuale (network) dalla rete di origine (original_network). Sai quale operatore gestisce realmente la linea, un'informazione preziosa per il routing dei tuoi SMS o per l'analisi della composizione del tuo file.

Domande frequenti sull'API HLR

Cosa verifica esattamente l'API HLR?

L'API interroga l'operatore per conoscere lo stato della linea mobile. La risposta JSON contiene lo stato della richiesta, il numero formattato in internazionale, la rete attuale e la rete di origine. Il confronto tra questi ultimi due campi rivela se il numero è stato portato verso un altro operatore.

L'API funziona in tempo reale?

Sì. Ogni richiesta attiva un'interrogazione della rete dell'operatore nel momento in cui la invii. Due limiti documentati inquadrano l'uso: 2 connessioni simultanee al massimo e 50 verifiche al minuto. Per trattare grandi volumi, basta cadenzare le tue chiamate nel rispetto di queste soglie.

Quanto costa?

La fatturazione funziona a crediti, e ogni risposta dell'API include un campo credits che ti permette di seguire il tuo consumo direttamente dalle tue chiamate. Le tariffe dettagliate delle verifiche HLR sono disponibili sulla pagina HLR Lookup.