Panoramica di Lookup

Lookup risponde a domande su un destinatario prima che tu gli invii qualcosa. Passagli un numero di telefono e ti dice cosa è quel numero: la rete che lo serve, il paese, se ha cambiato rete e che tipo di linea è. Passagli un indirizzo email e ti dice se vale la pena inviarci messaggi.

Entrambi sono una richiesta e una risposta. Non c'è nulla da creare, nulla da interrogare periodicamente e nulla da ripulire dopo. La pagina Lookup nella dashboard esegue le stesse due operazioni una alla volta, ed è il modo più rapido per vedere com'è fatta una risposta prima di scrivere codice.

Quanto costa ogni lookup

Ogni lookup viene addebitato al wallet della tua organizzazione, e questa è la parte che vale la pena capire prima di costruirci sopra.

Un lookup su numero di telefono addebita sempre una volta per il lookup base. In più puoi richiedere delle proprietà, dati aggiuntivi che provengono da una fonte dati a pagamento. Ogni proprietà richiesta viene addebitata separatamente, ma solo quando viene restituita. Una proprietà che non ha potuto ricevere risposta torna con uno stato che lo indica e non ti costa nulla.

Un lookup su indirizzo email addebita una volta per ogni indirizzo a cui è stata data risposta. Ogni verdetto viene addebitato, undeliverable incluso: è la risposta che hai chiesto, ed è quella che ti evita un bounce.

Non viene addebitato nulla quando un lookup fallisce. Un numero malformato, un indirizzo che rifiutiamo o una fonte dati non raggiungibile non costano nulla.

Prezzi di Lookup elenca la tariffa per il lookup base, per ogni proprietà e per un lookup su indirizzo email.

Il lookup su numero ha due livelli

Questa suddivisione è l'intero design del lookup su numero di telefono, quindi vale la pena spiegarla chiaramente.

Il lookup base viene sempre eseguito. Risponde con la rete che serve il numero, la rete che lo ha emesso, il paese, se il numero ha mai cambiato rete e un line_type generico (mobile, rete fissa, VoIP, numero verde e così via). Se il lookup base non può ricevere risposta, l'intera richiesta fallisce anziché restituire una risposta semivuota che dovresti ispezionare per scoprire che era vuota.

Le proprietà sono ciò che aggiungi sopra, indicandole in type. Rispondono a domande più specifiche: il servizio allocato preciso dell'intervallo, il record completo di portabilità, se il numero è attivo sulla rete in questo momento, se è in roaming, quando la SIM è stata cambiata l'ultima volta e un punteggio di credibilità. Una proprietà che non può ricevere risposta non fa mai fallire la richiesta. Degrada a uno stato, e il lookup base viene comunque restituito.

Solo ok contiene un valore, e solo ok viene addebitato

Ogni blocco proprietà ha un status, e leggerlo non è facoltativo.

ok significa che la proprietà ha ricevuto risposta, il suo valore è nella risposta e l'addebito è avvenuto.

unavailable significa che non è arrivata nessuna risposta, quindi la proprietà non aggiunge nulla. Non è stata addebitata.

inconclusive significa che è arrivata una risposta ma non risolve la proprietà: il numero è fuori dalla copertura dei dati che la alimentano, oppure la fonte ha restituito un valore che questa proprietà non riporta. È un risultato reale, non mancante, e non è stato addebitato nemmeno questo.

status è un vocabolario aperto, quindi potrebbero essere aggiunti altri valori. Controlla ok e tratta tutto il resto come "not answered": il tuo codice resterà corretto indipendentemente da come cresce.

Scegliere tra Lookup e la validazione all'invio

Lookup serve a decidere prima di procedere, un destinatario alla volta: verificare un numero o un indirizzo alla registrazione, valutare un lead prima di agire, oppure instradare un messaggio in modo diverso a seconda del tipo di linea. Costa denaro per ogni controllo e ti dà una risposta su cui puoi agire.

Se vuoi solo smettere di inviare a indirizzi che hanno già generato un bounce o un reclamo, non hai bisogno di Lookup. Le soppressioni lo fanno automaticamente e senza costi.

Nessuna delle due operazioni ha una forma batch, e la limitazione delle richieste di lookup parte da 10 richieste al minuto per credenziale, quindi controllare un'intera lista non è ciò per cui è dimensionato oggi. Contattaci per aumentare il limite se è quello che ti serve.

Prossimi passi

• Cercare un numero di telefono copre il lookup base, ogni proprietà e cosa restituisce ciascuna.
• Cercare un indirizzo email copre i verdetti e cosa fare con ognuno.
• Riferimento API di Lookup documenta ogni campo.
• Idempotenza spiega come riprovare un lookup senza pagarlo due volte.