· 6 min read
Qué verificar cuando una biblioteca de números de teléfono rechaza un nuevo rango
Investigue el contexto del país, los metadatos instalados y la evidencia oficial de numeración antes de descartar el número de teléfono de un cliente en disputa.
Trate el rechazo de un supuesto nuevo rango como una investigación. Reproduzca el resultado con la entrada exacta y el contexto del país, compare la biblioteca implementada con los metadatos actuales y encuentre evidencia autorizada del rango antes de decidir qué hacer con el registro.
Capture el rechazo antes de cambiar el número
Un cliente afirma que su número es correcto, pero su importación lo rechaza. Eliminar repetidamente un dígito inicial hasta que el validador acepte algo es una reparación peligrosa: el nuevo valor podría identificar un número diferente. Comience conservando la entrada original y el valor exacto que llegó a la biblioteca.
Registre el país predeterminado proporcionado al análisis, el código de país resultante si el análisis fue exitoso y la operación de validación que falló. Distinga un error de análisis de un posible error de longitud o de un error de validez de rango. Un número sin contexto de país aún no es evidencia de un nuevo rango de numeración.
Reproduzca el caso fuera de la lógica del formulario circundante utilizando el mismo paquete y metadatos implementados. Esto revela si el rechazo proviene de la biblioteca o de una regla de aplicación adicional. Una máscara de interfaz, una expresión regular en caché o una restricción de país del lado del servidor pueden rechazar la entrada incluso cuando la biblioteca de teléfonos la acepta.
Verifique qué versión se está ejecutando realmente
Encuentre la versión de la dependencia resuelta en la aplicación implementada, en lugar de leer solo el rango de versiones en un manifiesto de paquete. Si la aplicación agrupa los metadatos telefónicos por separado, registre también ese activo. Una máquina de desarrollo puede producir un resultado diferente al de un paquete implementado que aún contiene una compilación anterior.
Repita la misma entrada y contexto de país frente a la versión mantenida actual en una prueba aislada. Mantenga los dos resultados uno al lado del otro. Si la versión más nueva acepta el rango, inspeccione la versión relevante o el cambio de metadatos antes de planificar una actualización. Ejecute también números existentes representativos a través de la actualización, especialmente de países centrales para su base de clientes.
Si ambas versiones rechazan el número, la actualización por sí sola no ha resuelto la pregunta. Continúe con la evidencia de numeración. No elimine la verificación de validez globalmente solo porque un cliente informe un número válido; ese cambio afectaría a todas las presentaciones posteriores, incluidas las que están genuinamente mal formadas.
Busque evidencia que aborde el rango exacto
Las preguntas frecuentes de libphonenumber de Google describen un rango válido como aquel para el cual existe suficiente documentación oficial que indica que se pueden asignar números. También explica que los cambios en los metadatos pueden retrasarse respecto a la introducción de un rango. Esa es una razón para investigar un rechazo, no una razón para asumir que cada prefijo desconocido es recién válido.
Busque el plan de numeración de la autoridad nacional de telecomunicaciones pertinente o un aviso de asignación oficial. Haga coincidir el código de llamada del país, la longitud del número nacional y los límites de prefijo. Verifique la fecha de vigencia: un anuncio sobre un rango futuro puede no establecer que ya esté disponible para su asignación.
El aviso autorizado de un operador puede agregar contexto donde el plan nacional esté incompleto. Guarde la URL original, la fecha del documento y el pasaje que respalda el rango en sus notas de investigación. Un informe de foro u otro sitio web que acepte la entrada puede proporcionar una pista, pero no reemplaza esa evidencia. Una copia histórica de las preguntas frecuentes sobre numeración explica el problema general; no puede confirmar una asignación actual.
Elija una respuesta limitada a la evidencia
Cuando los metadatos actuales aceptan el número y los metadatos implementados más antiguos lo rechazan, pruebe y publique la actualización compatible a través de su proceso de implementación normal. Mantenga el número reportado como un caso de regresión para que el mismo rechazo no regrese silenciosamente con un cambio de paquete posterior.
Cuando falte una asignación oficial efectiva en los metadatos actuales, prepare un informe conciso para el proveedor con una entrada reproducible, el contexto del país y la fuente autorizada. Elimine los detalles de identidad del cliente del informe. Evite publicar el registro de contacto completo de un cliente cuando un caso de prueba permitido o una descripción de rango puedan explicar el problema.
Para su propio flujo de trabajo, mantenga los registros afectados en una cola de rangos en disputa en lugar de eliminarlos o declararlos válidos silenciosamente. Cualquier excepción temporal debe limitarse al rango evidenciado y a la decisión comercial específica. Por ejemplo, permitir que un usuario guarde un registro de contacto no necesita otorgar permiso para comenzar cada acción que dependa del teléfono. Documente cuándo se debe revisar la excepción después de que los metadatos se actualicen.
Agregue una verificación separada solo para la pregunta que responde
Una investigación del plan de numeración y un resultado de verificación masiva son observaciones separadas. La Validación de números de teléfono de CheckNumber proporciona una señal de validez documentada para las listas admitidas. Otros productos del catálogo responden a diferentes preguntas, como el registro en una plataforma nombrada. Elija el producto según la decisión que su equipo deba tomar.
Prepare los candidatos aprobados en CSV o TXT con un país por archivo y un número por línea, incluido el código de país. Confirme la cobertura de país actual del producto seleccionado. Mantenga las entradas originales no resueltas en su propia hoja de revisión, de modo que una exportación posterior pueda reconciliarse con la investigación en lugar de sobrescribir sus notas.
Una observación de verificación positiva no establece la propiedad ni repara un registro de asignación oficial faltante. Del mismo modo, un rechazo de la biblioteca no debería borrar una observación separada sin revisión. Almacene la fuente y la hora de cada conclusión, luego decida si el registro del cliente puede proceder, necesita corrección o permanece retenido.
Comience con el rechazo reproducible y la versión instalada. Una vez que se comprenda la pregunta sobre el rango, utilice nuestro verificador de números de teléfono para la tarea de verificación de listas admitidas que sigue. Esto preserva la distinción útil entre corregir su regla de validación y comprender la lista de contactos.