Cómo convertir una lista de teléfonos a E.164 antes de una verificación en Telegram
Guía paso a paso para convertir números a E.164: elimine símbolos, prefijos troncales, añada códigos de país y valide antes de una verificación en Telegram.
Un flujo de trabajo a nivel de hoja de cálculo para convertir números de teléfono locales al formato E.164, de modo que una verificación de registro en Telegram o un archivo masivo de un solo país puedan procesarlos.
Para convertir números de teléfono al formato E.164, elimine los espacios y símbolos, suprima cualquier prefijo troncal nacional (como un cero inicial) y escriba un signo más seguido del código de país y los dígitos restantes. El resultado no debe contener espacios ni puntuación y debe tener un máximo de 15 dígitos. Realizar este proceso en una hoja de cálculo antes de una verificación de registro en Telegram mantiene los números legibles tanto para la verificación en tiempo real como para los archivos masivos de un solo país.
Qué requiere E.164
E.164 es el plan de numeración de telecomunicaciones públicas internacionales publicado por la UIT, descrito en la página de recomendaciones de la UIT. En el trabajo diario con datos, esto significa una forma canónica única: un signo más, el código de país y luego el número de suscriptor incluyendo cualquier código de área, sin espacios, paréntesis ni guiones. La longitud total es de un máximo de 15 dígitos.
Dos hábitos causan la mayoría de los errores de conversión. El primero es tratar un número local como si fuera internacional. Un número escrito tal como lo marca la gente en su país a menudo comienza con un prefijo troncal, el cual no forma parte de la estructura internacional. El segundo es tratar el signo más como un elemento decorativo. En las hojas de cálculo, un signo más inicial a menudo se interpreta como un operador de fórmula, por lo que la celda lo elimina silenciosamente.
La verificación en tiempo real de TG Validator acepta un número de teléfono en formato E.164. Su panel de control y los archivos masivos para números de teléfono esperan códigos de país internacionales, por lo que una columna limpia en formato E.164 es la preparación adecuada para ambos casos.
Paso 1: Mantenga la columna como texto y cree una copia de seguridad
Antes de realizar cualquier cambio, copie la columna original en una nueva hoja o pestaña. Es fácil cometer errores en la conversión, y conservar el original intacto le permite rastrear cualquier número en caso de duda.
Luego, establezca el formato de la columna de trabajo como texto sin formato. En Excel o Google Sheets, esto evita que el programa elimine los ceros iniciales o interprete un signo más inicial como una operación aritmética. Si el archivo llega en formato CSV, impórtelo con la columna de teléfono definida explícitamente como texto en lugar de dejar que el programa lo adivine.
Paso 2: Elimine todo lo que no sea un dígito
Elimine espacios, guiones, puntos, paréntesis y cualquier texto como etiquetas de extensión. En Google Sheets, un reemplazo mediante Regex en la columna lo hace en un solo paso: reemplace cualquier carácter que no sea un dígito por nada. En Excel, las llamadas anidadas a SUBSTITUTE para cada símbolo logran el mismo resultado, o el paso de limpieza de texto de Power Query puede procesar una columna completa.
Tome nota de los números que comenzaban con un signo más o con un prefijo internacional de doble cero antes de la limpieza. Estos ya contienen un código de país y requieren un manejo diferente en el siguiente paso. Una columna auxiliar rápida que registre si el original comenzaba con un signo más o un doble cero facilita este proceso.
Paso 3: Elimine el prefijo troncal y añada el código de país
Este es el paso que requiere una decisión por país, por lo que debe trabajar con un país a la vez.
- Ya internacional. Si el original comenzaba con un signo más o un prefijo de doble cero, los dígitos que siguen son el código de país y el número. Elimine el prefijo de doble cero y coloque un signo más al principio.
- Local con prefijo troncal. Muchos países escriben números nacionales con un cero inicial que se omite en la forma internacional. Elimine ese dígito inicial y luego añada el signo más y el código de país.
- Local sin prefijo troncal. Algunos planes nacionales no tienen prefijo troncal, por lo que los dígitos se mantienen tal cual y solo se añaden el signo más y el código de país.
Para una hoja con una columna de país, una tabla de búsqueda que relacione el nombre del país con su código, además de una columna que registre si ese país utiliza un dígito troncal inicial, permite automatizar la fórmula. El resultado es una nueva columna: el signo más, seguido del código y luego el número con el dígito troncal eliminado cuando corresponda.
No adivine el país de un número que no lo especifique. Es preferible apartar una lista corta de filas sin un país claro que asignarles un valor predeterminado que las envíe al grupo incorrecto.
Paso 4: Valide la longitud y busque valores atípicos
Unas pocas comprobaciones rápidas detectan la mayoría de los errores que las fórmulas pasan por alto.
- Longitud. Después del signo más, el número debe tener un máximo de 15 dígitos. Cualquier número más largo es un error.
- Demasiado corto. Los resultados muy cortos suelen significar que falta un código de área o que se ha pegado una extensión.
- Códigos de país repetidos. Un número que ya contenía su código y al que se le añadió de nuevo comenzará con el código dos veces. Ordene por los primeros dígitos para detectar estos casos.
- Países mezclados en un archivo de un solo país. Las tareas masivas de números de teléfono funcionan para un país seleccionado, por lo que agrupe las filas por código de país y exporte un archivo por cada uno. La lista debe corresponder esencialmente al país seleccionado, ya que un archivo con una gran proporción de códigos de otros países será rechazado.
Mantenga una pestaña de rechazos con el valor original, el valor convertido y el motivo del fallo. Esa pestaña será su lista de trabajo para las correcciones manuales.
Paso 5: Exporte para la verificación en tiempo real o para un archivo masivo
Decida la ruta según el tamaño de la lista.
Para un conjunto pequeño, ejecute la verificación de registro en Telegram en tiempo real. La ruta REST es POST /api/v1/check, autenticada con X-API-Key, con un número E.164 y el tipo de servicio tg, y POST /api/v1/batch-check acepta hasta 100 números en una sola solicitud. La pestaña de verificación por lotes (Batch Check) del panel de control acepta hasta 500 números pegados. Todos estos devuelven resultados en la misma sesión.
Para una lista mucho mayor, exporte un archivo TXT o CSV con un número por línea, súbalo como una tarea masiva para el país elegido, espere a que la tarea finalice y descargue result.csv. Los límites exactos por servicio se encuentran en la documentación actual de la API y en la página de precios, así que consúltelos antes de realizar una ejecución grande.
Los números de China continental, Hong Kong y Macao pueden verificarse uno a uno en volúmenes pequeños mediante la verificación individual en tiempo real, pero los archivos masivos asíncronos no admiten estas regiones, por lo que debe excluirlos de las exportaciones masivas.
Qué ofrece y qué no ofrece un archivo E.164 limpio
El formato limpio elimina la causa más común de entradas ilegibles, pero no cambia el significado de la verificación. Un resultado de registro es una señal de presencia de cuenta en la plataforma en el momento de la verificación. No muestra actividad, identidad, propiedad, consentimiento o probabilidad de respuesta, por lo que debe mantener sus reglas normales de permiso y relevancia después de la verificación.
Un hábito final útil es mantener la columna convertida junto a la original en la hoja maestra, con la fecha de conversión, para que las importaciones posteriores puedan coincidir sin repetir el trabajo.
Preguntas frecuentes
¿Cómo pueden los equipos convertir números de teléfono locales a E.164 en una hoja de cálculo?
Los equipos pueden eliminar los caracteres que no sean dígitos, suprimir cualquier prefijo troncal nacional y luego añadir un signo más y el código de país. Trabajar con un país a la vez utilizando una tabla de búsqueda mantiene la fórmula sencilla.
¿Cuál es la longitud máxima de un número E.164?
Un número E.164 tiene un máximo de 15 dígitos después del signo más, sin espacios ni puntuación. Los resultados más largos suelen indicar un código de país duplicado.
¿Cómo pueden los equipos evitar que una hoja de cálculo elimine el signo más inicial?
Formatee la columna de teléfono como texto sin formato antes de introducir o importar valores, e importe los archivos CSV con la columna de teléfono definida como texto para que el signo más y los ceros iniciales se conserven.
¿Los archivos masivos de Telegram requieren un solo país?
Sí. Las tareas masivas de números de teléfono funcionan para un país seleccionado, por lo que debe agrupar las filas por código de país y exportar un archivo por país; los archivos con una gran proporción de códigos de otros países son rechazados.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.