¿De qué país es este número de WhatsApp?

Te llega un mensaje de un número que no conoces y lo primero que quieres saber es de dónde sale. Es una pregunta razonable y tiene una respuesta corta: el país está en el prefijo, y eso sí se puede saber siempre. Lo que casi ninguna página dice es dónde acaba esa respuesta, así que empecemos por ahí.

Lo que un número te dice, y lo que no

Un número de teléfono en formato internacional empieza por un + y un prefijo de país. +52 es México, +34 España, +55 Brasil, +39 Italia. Eso no es una consulta a ninguna base de datos secreta: es cómo está construido el sistema telefónico mundial, y por eso funciona con cualquier número, esté o no en WhatsApp.

Lo que no sale del número es de quién es. No hay una guía pública que relacione números de teléfono con personas, ni en WhatsApp ni fuera de él. Si una web te promete el nombre y la dirección del titular a cambio de una suscripción, lo que te está vendiendo es una suscripción.

Hay una excepción, y es importante porque es la única: si el número es una cuenta de empresa, WhatsApp publica el nombre que esa empresa registró. No es un dato filtrado, es un dato que el negocio puso ahí a propósito para que lo veas, igual que el rótulo de una tienda. De un número personal no vas a sacar eso, porque no existe.

El prefijo tiene trampas, y conviene conocerlas

«Mira el prefijo» suena fácil hasta que te topas con uno de estos tres casos.

Los prefijos se solapan. +1 no es Estados Unidos: es Estados Unidos, Canadá y una veintena de países del Caribe. Para separarlos hay que mirar los tres dígitos siguientes. Lo mismo pasa con +7, que cubre Rusia y Kazajistán.

El país del número no es el país de la persona. Un número mexicano en manos de alguien que lleva seis años viviendo en Madrid sigue siendo un número mexicano. El prefijo dice dónde se dio de alta la línea, no dónde está quien la usa. Es un dato útil y no es una localización.

Argentina, México y Brasil escriben sus números móviles de dos maneras. Un número mexicano puede aparecer con un 1 después del +52 o sin él, y las dos formas circulan. Argentina hace algo parecido con el 9. Si buscas un número copiado de un sitio y no aparece, prueba con la otra forma antes de dar por hecho que no existe.

Qué añade comprobar el número

Saber el país está bien. Lo que normalmente quieres saber después es si ese número está en WhatsApp, y eso ya no se deduce: hay que preguntarlo.

Nuestra comprobación devuelve, cuando el número existe:

• el teléfono normalizado en formato internacional,
• su identificador en WhatsApp,
• si es una cuenta de empresa,
• el enlace para escribirle sin guardarlo en la agenda,
• y la ficha del país: nombre, nombre oficial, prefijo, bandera, moneda, idiomas y husos horarios.

Si además es una cuenta de empresa, añade la información que WhatsApp publica de ese negocio.

Es una llamada a la API, de una en una:

POST api.pulpo.chat/v1/verify/number
{ "phone": "+14155550142" }

Y cuando el número no está en WhatsApp, la respuesta se queda en cuatro campos y llega con un 404. Fíjate en que eso sigue incluyendo el país: el prefijo se resuelve exista o no la cuenta, porque no depende de WhatsApp.

Un «sí» significa «lo tenía»

Esta es la parte que preferimos contar nosotros antes de que la descubras tú.

Cuando un número ya se ha visto en WhatsApp alguna vez, la respuesta sale del registro de la plataforma sin volver a preguntar, y ese registro no caduca. Así que un número que tuvo WhatsApp y lo dejó puede seguir contestando que sí. Hay además tres cachés por el camino: una hora en la API, ocho horas en cada proceso de servicio y seis horas dentro de la sesión que resuelve la consulta.

Por eso no vas a ver en nuestra web ningún porcentaje de acierto. No tenemos esa medida y no vamos a inventárnosla.

También conviene saber quién contesta: la comprobación la resuelve una sesión de WhatsApp Web conectada, no la API oficial de Meta, porque Meta no ofrece comprobación de existencia de número. Si en ese momento no hay ninguna sesión disponible, la respuesta es un 503, que quiere decir «ahora no puedo», no «ese número no existe». Son dos cosas distintas y conviene tratarlas distinto en tu código.

Para qué sirve esto de verdad

La pregunta «¿de qué país es este número?» casi nunca es la pregunta final. Debajo suele haber una de estas tres.

Estoy limpiando una lista antes de escribirle. Este es el caso bueno. Si vas a mandar mensajes a mil contactos que llevan años en una hoja de cálculo, comprobar antes cuáles siguen en WhatsApp te ahorra mandarle a nadie un mensaje que no va a llegar. Y ahí hay una cosa que es fácil confundir: validar el formato y comprobar la existencia son dos cosas distintas. El formato se valida en lote, hasta mil números por petición, y no gasta cupo ni necesita ninguna sesión conectada. La existencia va de una en una.

Quiero saber si este proveedor es quien dice ser. Si es una cuenta de empresa, el nombre publicado te da algo con lo que trabajar. Si es un número personal, no.

Me está escribiendo un desconocido y quiero saber quién es. Aquí la respuesta honesta es que no vas a poder, y que eso es bueno: la misma razón por la que no puedes averiguar quién hay detrás de un número es la que impide que un desconocido averigüe quién hay detrás del tuyo. Lo que sí puedes hacer es bloquear y denunciar desde la propia app.

Y un aviso sobre el ritmo

Si vas a comprobar muchos números, hazlo despacio: recomendamos no pasar de treinta por minuto, uno cada dos segundos. No es un límite comercial. Es la misma cuenta de WhatsApp la que pregunta, y encadenar cientos de consultas seguidas puede dar problemas y, en el peor caso, acabar con el número bloqueado.

Es el mismo consejo que damos para cualquier cosa que se haga en volumen sobre WhatsApp: lo que parece una función es, por debajo, una cuenta comportándose de una manera. Si esa manera no se parece a la de una persona, se nota.