Cómo solucionar errores de 'El número de teléfono debe estar en formato E.164'
Corrija la falta de códigos de país, signos más y prefijos nacionales antes de enviar un número para la verificación de registro en Telegram.
Corrija la falta de códigos de país, signos más y prefijos nacionales antes de enviar un número para la verificación de registro en Telegram.
Un error de 'El número de teléfono debe estar en formato E.164' significa que el valor enviado requiere un número de teléfono en formato internacional antes de que una verificación de registro en Telegram pueda procesarlo. Comience con el código de país y el número nacional correctos, añada el signo más inicial y elimine la puntuación de visualización, así como cualquier prefijo de marcado nacional que no pertenezca a la forma internacional. Valide el valor transformado con respecto al registro de origen antes de volver a enviarlo; un número sintácticamente correcto pero erróneo sigue siendo una entrada incorrecta.
Qué verifica el requisito E.164
E.164 es el plan de numeración internacional publicado por la Unión Internacional de Telecomunicaciones. En la aplicación cotidiana, su presentación habitual comienza con un signo más, seguido del código de país y el número nacional significativo. El signo más representa el contexto de marcado internacional; los espacios, corchetes y guiones pueden ayudar a una persona a leer un número de teléfono, pero no forman parte del valor compacto que espera una API de verificación.
Un error de formato ocurre antes de obtener una respuesta de registro significativa. No debe registrarse como "No registrado" en Telegram. La Verificación de registro en Telegram en tiempo real para un solo número de TG Validator requiere que el número de teléfono enviado esté en formato E.164. Una vez aceptada la entrada, el resultado obtenido se refiere a la presencia de una cuenta de Telegram para ese número en el momento de la verificación. La verificación de formato en sí misma no indica nada sobre la presencia de la cuenta, la identidad, la propiedad o el permiso de contacto.
Utilice el valor de origen original y el país conocido conjuntamente. No intente adivinar un código de país a partir de los primeros dígitos de un número incompleto o del país en la dirección postal de un contacto. Un número nacional solo puede ser significativo con su contexto de numeración. Cuando se desconozca el país, reserve el registro para una revisión de datos en lugar de crear silenciosamente un número internacional que parezca plausible.
Diagnostique los errores de entrada más comunes
Comience inspeccionando la cadena exacta enviada a la verificación, no solo la forma en que la muestra una hoja de cálculo. La falta de un signo más es común cuando un campo se almacenó como un número. Lo mismo ocurre con los espacios, paréntesis y guiones copiados de una tarjeta de contacto legible por humanos. Algunas fuentes conservan un prefijo de tronco nacional que debe omitirse después de añadir el código de país. Otras fuentes ya incluyen el código de país, por lo que anteponerlo de nuevo crea un duplicado.
| Síntoma | Problema de datos probable | Acción de revisión |
|---|---|---|
| Sin signo más inicial | Valor nacional o internacional truncado | Confirme el país y luego construya la forma internacional |
| Corchetes o separadores | Formato de visualización humana copiado en la entrada de la API | Elimine los caracteres de presentación del valor enviado |
| Cero inicial extra después del código de país | Prefijo de marcado nacional retenido | Aplique la regla de marcado internacional específica del país |
| Código de país repetido | Código añadido a un número ya internacional | Compare con la fuente y elimine el duplicado |
| Número inesperado de dígitos | Dígitos perdidos, extensión o país incorrecto | Vuelva a comprobar el registro de origen y el plan específico del país |
La guía de errores E.164 de Twilio ilustra un requisito común del lado del servicio para la misma forma compacta. No define el resultado de registro de TG Validator. Para una transformación específica de un país, consulte la guía de numeración autorizada; una regla genérica de "eliminar cada cero" no es segura porque un cero puede pertenecer al interior del número nacional significativo.
Normalice en una secuencia controlada
Primero, conserve el valor original en un campo separado. Segundo, asigne un país o región de numeración confiable a partir del registro de origen. Tercero, elimine solo los caracteres de visualización como espacios, guiones y corchetes; no descarte dígitos simplemente porque parezcan inusuales. Cuarto, decida si el valor ya tiene un signo más y un código de país. Quinto, si tiene formato nacional, aplique la regla nacional a internacional pertinente, incluyendo si se debe eliminar un prefijo de tronco. Finalmente, verifique que la salida comience con un signo más, contenga los dígitos previstos y no tenga ninguna extensión incrustada en el valor enviado.
Por ejemplo, un número en formato nacional del Reino Unido puede tener un 0 inicial utilizado en el marcado doméstico. En una representación internacional, el código de país del Reino Unido es +44 y ese 0 de tronco doméstico generalmente se elimina. La transformación debe basarse en un número verificado del Reino Unido; no es una regla universal para todos los países. La definición de la UIT de un prefijo de tronco nacional explica por qué la cadena de marcado nacional y un número internacional pueden diferir. Mantenga el valor de origen y el valor transformado uno al lado del otro para que un revisor pueda detectar la pérdida accidental de dígitos.
No utilice una coincidencia de Regex por sí sola como control de calidad final. Un Regex puede detectar puntuación obvia o un signo más faltante, pero no puede determinar si el país es correcto o si se aplicó correctamente una regla de numeración local. Un analizador consciente del país puede ayudar, pero los datos de origen del equipo aún necesitan revisión cuando la información sobre el país o la propiedad es incierta.
Compruebe lo que realmente almacenan la hoja de cálculo o el CRM
Excel y herramientas similares pueden alterar silenciosamente los valores similares a números cuando una columna se trata como numérica. Microsoft recomienda formatear las celdas como texto antes de la entrada, ya que los números de teléfono son identificadores en lugar de cantidades para aritmética. Un formato personalizado visualmente correcto solo puede cambiar la visualización y dejar un valor subyacente diferente. Si se perdió un dígito inicial antes de que la celda se convirtiera en texto, cambiar el formato después no lo reconstruirá.
Antes de enviar un lote, exporte una pequeña muestra e inspeccione el TXT o CSV sin formato en un visor de texto plano. Confirme la primera y la última fila, algunas entradas con prefijos nacionales y algunas entradas internacionales. Cuente los dígitos en los valores de origen y transformados para esas muestras. Si una fila contiene una extensión, manténgala en un campo de CRM separado; no es el número de teléfono enviado para una verificación de registro en Telegram.
Si la fuente es un formulario, recopile el país y el número de teléfono en campos distintos y validados cuando sea práctico. Si es una lista antigua, marque las filas inciertas para su revisión en lugar de aplicar una conversión amplia que podría cambiar miles de números incorrectamente. Esto es especialmente importante cuando una lista contiene varios países.
Vuelva a enviar el flujo de trabajo correcto después de corregir la entrada
Para un solo registro, utilice el Panel de control de Verificación única de TG Validator o su verificación de registro REST en tiempo real después de la normalización. La verificación única REST es la ruta documentada POST /api/v1/check. Una verificación decidida devuelve el resultado del registro en la misma sesión de solicitud. Una verificación indecisa es un resultado separado con un código de negocio distinto de cero; no debe reclasificarse como un error de formato o como un resultado de registro negativo.
Para un conjunto pequeño, la ruta de lote en tiempo real puede verificar hasta 100 números a través de la API, y la Verificación de lote en tiempo real del panel de control puede aceptar hasta 500 números pegados. Una lista preparada mucho más grande sigue el flujo de trabajo de archivo masivo asíncrono separado, con entrada TXT o CSV, monitoreo de tareas y descarga de resultados. Revise la documentación actual de la API de TG Validator antes de elegir una ruta o codificar los detalles de la solicitud. Estos flujos de trabajo difieren, pero cada uno se beneficia del mismo proceso de normalización que preserva la fuente.
Después de una corrección, registre qué registro cambió y por qué. Si una verificación anterior utilizó el número incorrecto, no edite ese resultado histórico como si se refiriera al número corregido. Ejecute una nueva verificación para el valor corregido y mantenga un registro de auditoría claro. El objetivo es obtener un resultado sobre el número previsto, no simplemente la desaparición de un error de entrada.
Preguntas frecuentes
¿Cómo pueden los equipos solucionar la falta de un signo más en un error E.164?
Confirme el número de origen y el país, luego construya el valor internacional con un signo más inicial y el código de país correcto. No añada un código adivinado a un registro incierto.
¿Deberían los equipos eliminar todos los ceros iniciales de los números de teléfono?
No. Aplique la regla de numeración del país específico. Un prefijo de tronco nacional puede omitirse internacionalmente, pero otros ceros pueden ser dígitos significativos.
¿Qué debería suceder con un registro que sigue fallando después de la normalización?
Mantenga los valores originales y transformados, inspeccione el país y los datos de origen, y dirija el registro para su revisión. Un error de formato no es un resultado de registro en Telegram.
Más información
Elija la información del producto que se ajuste al siguiente paso de su flujo de trabajo.