Formato E.164 de números de teléfono: conversión y validación

¿Por qué las API de SMS y WhatsApp necesitan E.164?

Porque el enrutamiento depende de un número sin ambigüedad. Un número sin prefijo de país puede pertenecer a muchos países, así que la plataforma podría enviar al mercado equivocado, aplicar las reglas de sender ID equivocadas y facturar la tarifa equivocada. Las tarifas, el registro de sender ID y los horarios de envío promocional se aplican por país de destino, y el prefijo del país es lo que identifica el destino.

¿Qué dice Meta sobre los números de WhatsApp?

La documentación de Meta sobre los formatos de número de teléfono de los usuarios de WhatsApp dice que se admiten signos más, guiones, paréntesis y espacios en las solicitudes de envío de mensajes, y recomienda encarecidamente incluir el signo más y el prefijo telefónico del país. Si falta el signo más, se añade al número el prefijo del país del remitente, lo que puede hacer que un mensaje llegue a un número equivocado. El ejemplo de Meta: para un remitente en India (prefijo 91), (631) 555-1234 se entrega a +916315551234, mientras que +1 (631) 555-1234 se entrega correctamente. Meta señala también que, para Brasil y México, la API en la nube puede modificar el prefijo adicional que aparece en algunos números, y lo califica de comportamiento estándar.

El enfoque seguro: almacene E.164 limpio y envíe exactamente eso.

¿Y para SMS?

Las API de SMS también esperan el número internacional completo. Algunas exigen los dígitos sin el signo más; el formato difiere entre API y protocolos, así que consulte la documentación de la API que use y pruebe con su propio número. Vea enviar SMS por API y enviar un mensaje de WhatsApp por API para ejemplos prácticos.

¿Cómo valido y normalizo números en código?

Use una regex para una comprobación rápida de la forma y una biblioteca para una validación real.

Una comprobación habitual de la forma E.164:

// Plus, a non-zero first digit, then 1 to 14 more digits: 15 digits at most
const E164 = /^\+[1-9]\d{1,14}$/;

function looksLikeE164(value) {
  return E164.test(value);
}

looksLikeE164("+971501234567"); // true
looksLikeE164("0501234567");    // false: no plus or country code
looksLikeE164("+0501234567");   // false: country codes do not start with 0

La regex solo comprueba la longitud y los caracteres. Acepta +99999999999 aunque no exista tal número. Para una validación real, use libphonenumber, la biblioteca de código abierto de Google para analizar, formatear y validar números de teléfono internacionales, disponible para Java, C++ y JavaScript, con adaptaciones de la comunidad a otros lenguajes. Su README describe isValidNumber como la validación completa para una región mediante información de longitud y prefijo, y muestra cómo formatear un número analizado como E.164.

# pip install phonenumbers  (a Python port of libphonenumber)
import phonenumbers

def to_e164(raw, default_region):
    try:
        number = phonenumbers.parse(raw, default_region)  # e.g. "AE", "SA", "GB"
    except phonenumbers.NumberParseException:
        return None
    if not phonenumbers.is_valid_number(number):
        return None
    return phonenumbers.format_number(number, phonenumbers.PhoneNumberFormat.E164)

print(to_e164("050 123 4567", "AE"))   # +971501234567 if the number is valid for the UAE
print(to_e164("+44 7700 900123", "GB"))

Las adaptaciones las escriben desarrolladores externos, así que compruebe la calidad de la que elija. Analice con una región predeterminada tomada del país de su cliente y almacene después el resultado E.164. Guarde también la entrada original, para poder volver a analizarla si cambian las reglas.

Normalice en el punto de entrada, en el formulario de alta, la importación del CRM o la API, no en el momento del envío. Un número escrito de dos formas se convierte en dos contactos que reciben cada uno la misma campaña.

¿Cómo arreglo los números de teléfono en una hoja de cálculo?

Dé formato Texto a la columna de teléfono antes de escribir o pegar los números. Los problemas habituales son:

Microsoft documenta que Excel elimina los ceros iniciales y convierte los números grandes a notación científica, y que los números introducidos antes de aplicar el formato Texto deben volver a escribirse. Cuando abre un CSV directamente, Excel aplica sus formatos predeterminados a cada columna, así que use el Asistente para importar texto o Desde texto/CSV para marcar la columna de teléfono como texto.

Para una lista de móviles de EAU guardada como 050 123 4567 en la columna A, esta fórmula construye el E.164 como texto:

="+971"&RIGHT(SUBSTITUTE(A2," ",""),9)

Conserva los últimos nueve dígitos tras quitar los espacios, por lo que solo sirve para números de esa forma. Copie el resultado y péguelo como valores antes de guardar como CSV. El formateador de números convierte un número sin fórmula, y nuestra guía para enviar SMS masivos desde Excel o CSV muestra el flujo completo de carga.

Ejemplo práctico: depurar una lista de clientes

«Souq Rafiq» (ficticio), un minorista de Dubái, exporta 8000 contactos de tres sistemas con números como 0501234567, 971 50 123 4567, +971-50-123-4567 y 00971501234567.

1. El analista añade una columna de país a partir del país de facturación de cada cliente.
2. Un script analiza cada fila con el país como región predeterminada, de modo que los cuatro formatos pasan a ser +971501234567.
3. Las filas que no superan la validación van a una hoja de revisión en lugar de enviarse.
4. Los duplicados se eliminan tras la normalización, lo que reúne los cuatro formatos en un solo contacto.
5. Una consulta HLR señala los números inactivos antes de la campaña. Vea la consulta HLR explicada.
6. La columna limpia se almacena como Texto y se sube.

Normalizar primero es lo que hace que funcione la detección de duplicados; antes, el mismo cliente parecía cuatro personas.

¿Cuáles son los errores más comunes?

• Quitar siempre el cero inicial. Algunos países, como Italia, no tienen prefijo troncal.
• Conservar el cero y añadir el prefijo del país, lo que da +9710501234567.
• Enviar sin el signo más a WhatsApp, de modo que se añade el prefijo del país del remitente.
• Usar una regex como validación. Comprueba la forma, no la validez.
• Dejar que Excel trate los teléfonos como números, con pérdida de ceros o paso a notación científica.
• Normalizar en el momento del envío en lugar de en la entrada.
• Suponer que un formato válido equivale a un número alcanzable. Los números portados o desconectados siguen fallando.
• Fiarse de una tabla estática. Los planes de numeración cambian; use una biblioteca mantenida.

Cómo ayuda OmniChannels.ai

OmniChannels.ai acepta números internacionales para SMS y WhatsApp mediante una sola API REST, y sus campañas admiten cargas de Excel y CSV con vista previa y filtrado de duplicados. BroadNet ofrece consultas HLR y de numeración, para comprobar que un número bien formado está activo. Lea la documentación de la API de SMS y la de la API de WhatsApp para los campos exactos de las solicitudes, o hable con nuestro equipo sobre el onboarding.