Números de teléfono en formato E.164: Cómo formatear números para una Consulta del operador original

Una guía práctica para escribir números de teléfono en formato E.164, convertir formatos locales y preparar entradas en tiempo real y archivos para CarrierLookup.

Un número de teléfono en formato E.164 se escribe con un signo más al principio, seguido del código de país y el número de suscriptor, sin espacios, guiones ni paréntesis; por ejemplo, +442071838750. El estándar internacional E.164 limita la longitud total a 15 dígitos. Para una consulta del operador, convierta primero cada número local a este formato, eliminando cualquier prefijo nacional (como un cero inicial). Las consultas en tiempo real de CarrierLookup requieren el signo más inicial. Las filas de archivos masivos utilizan los mismos dígitos sin el signo más, un número por línea. Un número rechazado por su formato es un problema de formato que debe corregirse, no un resultado de "sin operador".

Qué significa el formato E.164

E.164 es el plan de numeración internacional publicado por la ITU. Un número en este plan tiene hasta tres partes: un código de país de uno a tres dígitos, un código nacional de destino y el número de suscriptor. Al escribirlo, se convierte en un signo más seguido únicamente de dígitos. La longitud total está limitada a 15 dígitos.

El signo más es la notación para el prefijo de llamada internacional. El prefijo que se marca desde una línea fija o un teléfono varía según el país, razón por la cual el estándar utiliza un signo más en lugar de un prefijo específico.

Considere el formato E.164 como el formato de almacenamiento único para números de teléfono. Los formatos de visualización, como los paréntesis y los espacios, son útiles para las personas, pero pertenecen a una capa de presentación y no al campo que usted envía para una consulta.

Conversión de formatos locales paso a paso

La mayoría de las columnas de números de teléfono desordenadas siguen algunos patrones. Trabaje con ellos en este orden.

1. Elimine todo lo que no sea un dígito o un signo más inicial. Los espacios, puntos, guiones y paréntesis deben eliminarse.
2. Reemplace el prefijo de marcación internacional inicial. Un número que comienza con 00 seguido del código de país se convierte en un signo más seguido del código de país.
3. Elimine el prefijo nacional. Muchos países escriben números locales con un cero inicial que no forma parte del número internacional. Un móvil del Reino Unido escrito como 07911 123456 se convierte en +447911123456, mientras que un número de EE. UU. escrito como (212) 555-0123 se convierte en +12125550123 una vez que se añade el código de país 1.
4. Añada el código de país cuando falte. Haga esto solo cuando conozca el país a partir de otro campo, como la dirección de facturación o el formulario desde el cual provino el contacto. Adivinar el país añade errores que no podrá detectar más tarde.
5. Compruebe la longitud. Un resultado vacío o un resultado de más de 15 dígitos requiere revisión, no una consulta.

Ejecute esto como un script repetible o una fórmula de hoja de cálculo y mantenga el valor original en una columna separada para poder auditar cualquier conversión que parezca extraña.

Entrada en tiempo real frente a filas de archivos masivos

CarrierLookup acepta dos estilos de entrada, y no son intercambiables.

Para consultas en tiempo real, envíe el número en formato E.164 con el signo más inicial. Una consulta única utiliza POST /api/v1/check, y una solicitud múltiple síncrona utiliza POST /api/v1/batch-check. Las consultas en tiempo real no necesitan una selección de país por separado, por lo que una solicitud múltiple puede contener números de diferentes países.

Para tareas de archivos masivos, cree un archivo TXT o CSV con un número por línea y sin encabezados adicionales. Cada fila contiene el código de país, escrito como dígitos simples, y se selecciona un país al enviar la tarea. El archivo de resultados también informa el identificador como dígitos simples con el código de país y sin signo más, por lo que una unión con su columna maestra prefijada con el signo más requiere un paso de normalización.

Una regla práctica es mantener una única columna maestra en formato E.164 y generar la versión para el archivo a partir de ella eliminando el signo más. Esto mantiene ambas rutas consistentes y evita tener dos fuentes de información para el mismo número.

Por qué un formato rechazado no es un resultado de "sin operador"

Cuando un número no tiene una forma que la consulta pueda analizar, se rechaza por su formato. Esto no dice nada sobre el número en sí. Muchos equipos leen un rechazo como un veredicto y eliminan filas, lo que provoca la pérdida de contactos válidos.

Distinga tres resultados en su flujo de trabajo:

• Formato rechazado. Corrija el número siguiendo los pasos anteriores y envíelo de nuevo.
• Consulta completada con campos vacíos. La consulta finalizó y algunos valores no están disponibles. Mantenga la fila y almacene los valores vacíos como no disponibles.
• Consulta fallida o indeterminada. No se produjo ningún resultado y no se realiza ningún cargo. Vuelva a intentarlo más tarde o ponga la fila en cola para su revisión.

En la ruta masiva, el preprocesamiento también excluye las filas que no son válidas, están duplicadas, carecen de código de país o están fuera del país seleccionado. Las filas excluidas no se cobran, y mantener un registro de qué filas fueron excluidas le indica qué parte de su limpieza necesita mejoras.

Errores de formato comunes

La mayoría de los problemas de formato provienen de una lista corta de hábitos.

• Mantener el cero nacional después del código de país. +4407911123456 es incorrecto. El cero pertenece solo al formato local.
• Mezclar separadores en una misma columna. Una regla ordenada aplicada a todo es mejor que una docena de excepciones.
• Tratar los números como celdas numéricas en una hoja de cálculo. Los signos más y los ceros iniciales desaparecen. Almacene la columna como texto.
• Códigos de país compartidos. Varios países comparten el +1, por lo que el código por sí solo no identifica a un país. Para tareas de archivos, seleccione el país que coincida con la lista.
• Adivinar el país para un número local sin prefijo. Utilice otro campo de confianza o excluya la fila.

Después de la conversión, verifique manualmente algunas docenas de filas comparándolas con una referencia, como el plan de numeración nacional, y luego ejecute la lista completa. Recuerde que un número correctamente formateado solo le indica que el formato es correcto. El resultado del operador que sigue informa sobre el contexto de asignación original del número, no sobre el operador actual ni la alcanzabilidad.

Preguntas frecuentes

¿Cómo pueden los equipos convertir un número local al formato E.164?

Elimine todos los espacios y separadores, elimine el prefijo nacional (como un cero inicial) y coloque un signo más y el código de país al principio. Añada un código de país solo cuando otro campo de confianza identifique el país. Mantenga el valor original en una columna separada para auditoría.

¿Cómo pueden los equipos preparar números para una tarea de archivo masivo?

Escriba un número por línea en un archivo TXT o CSV, como dígitos con el código de país y sin signo más, luego seleccione el país que coincida con la lista. Las filas que no son válidas, están duplicadas o están fuera del país seleccionado se excluyen durante el preprocesamiento y no se cobran.

¿Cómo deben tratar los equipos un número rechazado en una consulta del operador?

Trátelo como un problema de formato. Compruebe el signo más, el código de país, el prefijo nacional y la longitud, corrija el número y envíelo de nuevo. Un rechazo no es un resultado de "sin operador", por lo que debe mantener el contacto en la lista en lugar de eliminarlo.

Más información

Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.

• Ver la documentación del producto →
• Hablar con el equipo →