Región y ciudad de asignación de números: lea correctamente los resultados del operador
Comprenda qué indican la región y ciudad en CarrierLookup, cómo gestionar campos vacíos y por qué estos datos no representan la ubicación actual del dispositivo.

Una guía a nivel de campo sobre el uso de la geografía de asignación de números sin confundirla con la ubicación de una persona.
Los campos de región y ciudad de asignación de números describen el contexto geográfico asociado a un rango de números de teléfono. En los resultados de CarrierLookup, estos no localizan a la persona, al teléfono ni a la conexión de red actual. Trátelos como metadatos de asignación que pueden ayudar a agrupar registros para su revisión. Estos campos pueden estar vacíos incluso cuando la consulta se ha completado, y el operador original de un número puede diferir del proveedor que le presta servicio posteriormente debido a la portabilidad. Almacene los campos junto con la fuente de consulta y la hora de verificación, mantenga los valores vacíos como tales y utilice una fuente independiente para cualquier pregunta que requiera realmente la dirección actual o la posición del dispositivo de un cliente.
Qué describe la geografía de asignación
Los planes de numeración telefónica asignan números y rangos de números de acuerdo con reglas administrativas. En el sistema norteamericano, por ejemplo, los registros de códigos del administrador del Plan de Numeración de América del Norte identifican un código de área y prefijo, la compañía operadora y el centro de tarifas para los códigos asignados. Esa es información de asignación, no una observación de GPS. Los campos country_code, region y city de CarrierLookup deben leerse en la misma categoría de contexto de asignación. La página de consulta del operador original del producto describe la información disponible sobre el operador y la asignación de números.
Una etiqueta interna útil es "región de asignación de números" en lugar de "región del cliente". Esa redacción aclara el origen del campo en una exportación de CRM o en un panel de control de analistas. También evita que un equipo cambie tácitamente la pregunta que se está respondiendo. Si una regla de territorio de ventas se basa en la dirección declarada de un cliente, debe leer el campo de dirección, no la ciudad de asignación del número de teléfono. Si un revisor está investigando por qué varios registros comparten un patrón de numeración particular, los campos de asignación pueden ser un contexto apropiado. Indique siempre cuál de estas preguntas está abordando el flujo de trabajo antes de utilizar el campo.
Por qué el valor de una ciudad no es una ubicación en tiempo real
Un número puede permanecer igual mientras una persona se muda, cambia de dispositivo o cambia de proveedor. La guía para el consumidor de la FCC explica que un cliente puede conservar un número al cambiar de proveedor de servicios bajo la portabilidad numérica. Por lo tanto, la ubicación asociada a una asignación de numeración no debe utilizarse como una observación de ubicación actual. Un resultado de operador no contiene coordenadas GPS, movimientos del dispositivo, dirección del suscriptor ni prueba de que un dispositivo esté conectado en el lugar reportado. Incluso cuando un campo de ciudad contiene un nombre de ciudad familiar, está vinculado al contexto de asignación del número.
Esta diferencia es importante en los flujos de trabajo prácticos. Un representante de soporte podría ver una ciudad de asignación que difiere de una dirección de envío; esa discrepancia por sí sola no es motivo para rechazar la dirección declarada por el cliente. Un analista de operaciones podría agregar números por región de asignación para comprender la combinación de numeración de una lista de origen; el gráfico debe etiquetarse en consecuencia. Un revisor de fraudes puede utilizar el campo como una pieza de contexto, pero no puede afirmar que el cliente está "ubicado en" esa ciudad basándose en el resultado. Tratar el campo como un atributo del rango de números en lugar de la persona evita que un punto de datos, por lo demás útil, se convierta en una afirmación personal falsa.
Lea la región y la ciudad junto con el resto del resultado
CarrierLookup ofrece una consulta única síncrona y comprobaciones múltiples síncronas para números E.164, además de un producto de archivo masivo asíncrono independiente. El resultado documentado incluye el operador original, el operador subyacente, el tipo de número, el código de país, la región y la ciudad. Para una consulta única, un resultado completado puede tener campos de operador vacíos. Los valores de asignación vacíos significan que no se devolvió ningún valor utilizable para esos campos; no prueban, por sí mismos, que el número sea inválido, inactivo o esté desconectado. Mantenga una distinción entre una consulta completada con espacios en blanco y una solicitud fallida o un formato de número rechazado. La documentación de la API proporciona el contrato actual.
En una tabla de ensayo local, mantenga el número E.164 enviado, el producto, la hora de verificación y cada campo devuelto en su propia columna. Utilice una columna de estado de importación independiente para analizar y hacer coincidir errores. No sobrescriba una dirección de cliente conocida anteriormente con region o city. Si varias filas de origen comparten un número, resuelva su asignación de propiedad local antes de aplicar cualquier resultado. Para la salida masiva, recuerde que el identificador son dígitos con código de país sin el signo más inicial utilizado por la entrada en tiempo real. Normalice una clave de comparación para la unión, mientras conserva las cadenas de entrada y salida originales para auditoría.
Elija un agrupamiento o uso de revisión seguro
Un campo de geografía de asignación puede respaldar un informe de distribución etiquetado: cuente cuántos números verificados devolvieron una región determinada, cuántos devolvieron una ciudad y cuántos no tuvieron un valor de asignación utilizable. Esto puede ayudar a un equipo a inspeccionar una lista telefónica reunida de varias fuentes o decidir qué registros necesitan una limpieza manual. Evite colocar una región vacía en un grupo de "país desconocido" si se devolvió un código de país; cada campo tiene su propia disponibilidad. Del mismo modo, un campo de ciudad no debe promoverse a un perfil de ubicación a nivel de persona.
Un ejemplo hipotético muestra la distinción. Supongamos que una fila de CRM contiene una ciudad de entrega declarada por el cliente y un resultado de CarrierLookup contiene una ciudad de asignación diferente. El analista debe conservar ambos bajo etiquetas separadas e investigar solo si el flujo de trabajo tiene otra razón válida para hacerlo. La consulta no observó una mudanza, una dirección fraudulenta o un teléfono en itinerancia. Si un equipo desea dirigir una campaña regional, puede utilizar sus propios datos de dirección o preferencia de cliente verificados y mantener la geografía de asignación como contexto de fondo. Eso hace que el resultado sea útil sin exigir una conclusión que no puede respaldar.
Documente el significado del campo en cada exportación
Una entrada en el diccionario de datos puede evitar un uso indebido posterior. Para region y city, registre "geografía de asignación de rango de números devuelta por CarrierLookup; puede estar vacía; no es la ubicación del cliente o del dispositivo". Registre carrier como el operador originalmente asignado y tenga en cuenta que la portabilidad puede separar ese valor de un proveedor posterior. Almacene la hora de la consulta como la hora en que el equipo verificó el número, no la hora en que se asignó el número o la hora en que apareció una persona en el área. Estos son metadatos y explicaciones locales, no campos adicionales prometidos por el producto.
En gráficos y exportaciones CSV, utilice nombres de columna como allocation_region y allocation_city en el conjunto de datos transformado del equipo. Mantenga los campos de producto sin procesar accesibles para su conciliación. Cuente los espacios en blanco explícitamente y publique el denominador para cualquier distribución regional, porque un gráfico que omite silenciosamente los valores faltantes puede implicar una integridad injustificada. Revise las uniones posteriores antes de utilizar un campo para cambiar un registro. Una etiqueta de ciudad es más útil cuando la pregunta se refiere genuinamente a la asignación de numeración; para la verificación de direcciones o la ubicación en tiempo real, el equipo necesita otras pruebas.
Preguntas frecuentes
¿El campo de región indica a los equipos dónde vive una persona?
No. Describe la geografía de asignación de números. Un cliente puede vivir o trabajar en otro lugar, y el resultado no contiene una dirección verificada. Mantenga cualquier ubicación declarada por el cliente o verificada de forma independiente en un campo separado y etiquete el valor de asignación claramente en los informes.
¿Qué deben hacer los equipos con un valor de ciudad vacío?
Consérvelo como un valor de campo no disponible. Una consulta completada puede tener campos de operador o de asignación vacíos, por lo que una ciudad en blanco no debe convertirse en una afirmación de que el número es inválido o que la persona no tiene ubicación. Cuente los espacios en blanco por separado en el análisis.
¿Puede la portabilidad cambiar la forma en que se interpreta el campo de operador?
Sí. CarrierLookup informa el operador originalmente asignado, y un número puede portarse posteriormente. Ese valor de operador original sigue siendo contexto de asignación en lugar de evidencia del proveedor que presta servicio al número actualmente. Mantenga el significado original en el diccionario de datos y utilice otra fuente documentada para una pregunta sobre la red actual.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.