Inteligencia de números telefónicos. Tipo de línea, operador, portabilidad previa, señales de fraude.
Consulta de operador con reconocimiento MNP sobre la misma infraestructura que transporta el tráfico de SMS y voz de Bird. Un solo endpoint, la misma autenticación, el mismo formato de errores que cualquier otro canal de Bird, porque el mismo equipo de ingeniería los construyó todos.
5 minutes from npm install to first lookup
Consulta un número desde el lenguaje que ya usas.
SDKs en todos los principales entornos de ejecución. Respuestas de consulta en menos de 300 ms en la mediana, lo suficientemente rápido como para condicionar el envío de un SMS.
Code samples arrive when this API ships. The SDKs already cover the live channels.
Diez campos que de otro modo ensamblarías de tres proveedores.
Datos concretos, nombrados y auditables. Cada uno proviene de una fuente real, no de un modelo adivinando.
- 01
Detección de tipo de línea
Móvil, fijo, VoIP, gratuito, premium, buscapersonas. Decide si el SMS es siquiera posible antes de enviarlo.
- 02
Identificación de operador
Nombre del operador actual y código de país por entrada E.164. Actualizado continuamente contra los registros MNP.
- 03
Historial de portabilidad
El operador anterior desde el que se portó el número. Útil para previsión de costos de enrutamiento y heurísticas de fraude.
- 04
Formato de país y región
Devuelve formato E.164, nacional e internacional; los códigos de país y región que un enrutador necesita.
- 05
Señales de fraude
Un fraud_score de 0 a 1 por número, combinando velocidad, heurísticas de tipo de línea, indicadores de portabilidad reciente y listas de números conocidos como fraudulentos.
- 06
Validez y alcanzabilidad
Un booleano de validez y una ventana de alcanzabilidad: algunos números se parsean correctamente, pero el operador ya no los tiene asignados.
- 07
Consulta por lotes
Envía con POST una lista de hasta 1000 números en una sola llamada. Se aplica el mismo precio por número; te ahorras los viajes de ida y vuelta.
- 08
Precios con reconocimiento de caché
Un caché de 24 h para entradas idénticas es gratuito. Solo pagas cuando la respuesta realmente cambiaría.
- 09
Webhooks para trabajos por lotes
Para lotes grandes, suscríbete a lookup.completed y lee el archivo de resultados en lugar de mantener una conexión HTTP.
- 10
Misma autenticación, mismo formato de error
Una sola API key para Lookup, SMS, Email, WhatsApp, Voice. Un único registro de tipos de error para todos.
Por qué creamos Lookup
Porque no deberías enterarte de que un número es fijo al ver fallar el SMS.
Ya estábamos ejecutando consultas MNP dentro del enrutamiento de SMS de Bird: teníamos que hacerlo para elegir la ruta de operador más económica en tiempo real. Lookup es esa misma consulta, expuesta como un endpoint de primera clase, para que pueda validar registros, evaluar riesgos y prever costes de enrutamiento sin enviar un solo SMS. La misma autenticación, el mismo formato de errores, los mismos webhooks que el resto de la plataforma.
Cada cambio de estado es un webhook.
Payloads firmados con HMAC, protegidos contra repetición, idempotentes. Las consultas de un solo número son síncronas; las consultas por lotes se distribuyen como webhooks.
Programa de reintentos: 5s, 30s, 5m, 30m, 2h, 6h, 12h. Dead-letter después del último intento; cada evento en dead-letter se puede reproducir desde el dashboard o la API.
lookup.completedUna consulta (individual o por lotes) finalizó. El payload incluye la respuesta completa.lookup.failedNo se pudo realizar la consulta; el payload incluye el formato de error.
Consulta el número y luego envía.
La misma autenticación, el mismo contrato de idempotencia, el mismo formato de errores. Lookup tiene la misma estructura que cualquier otro endpoint. La diferencia es que devuelve datos en lugar de despachar un mensaje.
Lookup.
Operador, tipo de línea, portabilidad de origen, señales de fraude: devueltos de forma síncrona en menos de 300 ms.
SMS.
La misma autenticación, el mismo formato de errores. Condicione el envío al resultado de la consulta: descarte los teléfonos fijos antes de que le cuesten dinero.