Descripción general de Lookup

Lookup responde preguntas sobre un destinatario antes de que le envíes algo. Dale un número de teléfono y te dice qué es ese número: la red que lo sirve, el país, si ha cambiado de red y qué tipo de línea es. Dale una dirección de correo electrónico y te dice si vale la pena enviar a esa dirección.

Ambas son una solicitud y una respuesta. No hay nada que crear, nada que consultar periódicamente y nada que limpiar después. La página de Lookup en el dashboard ejecuta las mismas dos operaciones de una en una, que es la forma más rápida de ver cómo es una respuesta antes de escribir código.

Cuánto cuesta cada consulta

Cada consulta se cobra del saldo de tu organización, y esta es la parte que conviene entender antes de construir sobre ella.

Una consulta de número de teléfono siempre factura una vez por la consulta base. Además, puedes solicitar propiedades, datos adicionales que provienen de una fuente de datos de pago. Cada propiedad que solicitas se factura por separado, pero solo cuando se entrega. Una propiedad que no pudo responderse vuelve con un estado que lo indica y no te cuesta nada.

Una consulta de dirección de correo electrónico factura una vez por dirección respondida. Todos los veredictos se facturan, undeliverable incluido: esa es la respuesta que pediste y la que te ahorra un rebote.

No se factura nada cuando una consulta falla. Un número mal formado, una dirección que rechazamos o una fuente de datos inaccesible no cuestan nada.

Precios de Lookup lista la tarifa de la consulta base, de cada propiedad y de una consulta de dirección de correo electrónico.

La consulta de número tiene dos niveles

Esta división es el diseño completo de la consulta de número de teléfono, así que vale la pena ser explícito al respecto.

La consulta base siempre se ejecuta. Responde la red que sirve el número, la red que lo emitió, el país, si el número ha cambiado alguna vez de red y un line_type general (móvil, línea fija, VoIP, número gratuito, etc.). Si la consulta base no puede responderse, toda la solicitud falla en lugar de devolver una respuesta medio vacía que tendrías que inspeccionar para descubrir que estaba vacía.

Las propiedades son lo que añades encima, nombrándolas en type. Responden preguntas más específicas: el servicio asignado exacto del rango, el historial completo de portabilidad, si el número está activo en la red en este momento, si está en roaming, cuándo cambió su SIM por última vez y una puntuación de credibilidad. Una propiedad que no puede responderse nunca hace fallar la solicitud. Se degrada a un estado, y la consulta base se sigue sirviendo.

Solo ok lleva un valor, y solo ok se factura

Cada bloque de propiedad tiene un status, y leerlo no es opcional.

ok significa que la propiedad fue respondida, su valor está en la respuesta y se facturó.

unavailable significa que no llegó ninguna respuesta, así que la propiedad no aporta nada. No se facturó.

inconclusive significa que llegó una respuesta pero no resuelve la propiedad: el número está fuera de la cobertura de los datos detrás de ella, o la fuente devolvió un valor que esta propiedad no reporta. Es un hallazgo real y no uno faltante, y tampoco se facturó.

status es un vocabulario abierto, así que pueden añadirse más valores. Evalúa sobre ok y trata todo lo demás como "not answered", y tu código seguirá siendo correcto sin importar cómo crezca.

Elegir entre Lookup y validar al enviar

Lookup sirve para decidir antes de comprometerte, un destinatario a la vez: verificar un número o dirección en el registro, filtrar un lead antes de actuar sobre él, o enrutar un mensaje de forma diferente según el tipo de línea. Cuesta dinero por consulta y te da una respuesta sobre la que puedes actuar.

Si solo quieres dejar de enviar a direcciones que ya rebotaron o se quejaron, no necesitas Lookup. Las supresiones lo hacen automáticamente y sin costo.

Ninguna de las dos operaciones tiene forma de lote, y el límite de solicitudes de lookup comienza en 10 solicitudes por minuto por credencial, así que revisar una lista completa no es para lo que está dimensionado hoy. Habla con nosotros sobre aumentar el límite si eso es lo que necesitas.

Próximos pasos

• Consultar un número de teléfono cubre la consulta base, cada propiedad y lo que devuelve cada una.
• Consultar una dirección de correo electrónico cubre los veredictos y qué hacer con cada uno.
• Referencia de API de Lookup documenta cada campo.
• Idempotencia explica cómo reintentar una consulta sin pagarla dos veces.