API para normalizar teléfonos argentinos al formato WhatsApp y E.164

Los teléfonos argentinos llegan escritos de mil formas: con el 0, con el 15, con +54 o sin código de área. La API los lleva al formato internacional E.164, al de WhatsApp y al nacional, y te dice si es celular o fijo.

Cuesta 1 crédito por consulta (entre USD 0,02 y USD 0,03, según el pack). La key de prueba es gratis, sin registro ni tarjeta, y trae 50 créditos. La misma key sirve en las tres APIs de la suite (AR Tools, Índices AR y Direcciones AR), con un solo saldo.

Para qué la usan

Empezá en un minuto

1. Pedí una key de prueba

curl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/keys -H 'content-type: application/json' -d '{"name": "mi-sistema"}'

Devuelve key (empieza con ak_, guardala: no se vuelve a mostrar), key_id y los créditos.

2. Llamá a normalizar_telefono_ar

curl -X POST https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/normalizar_telefono_ar \
  -H 'Authorization: Bearer ak_...' \
  -H 'content-type: application/json' \
  -d '{"telefono":"011 15 2345-6789"}'

Respuesta

{
  "result": {
    "valido": true,
    "e164": "+5491123456789",
    "internacional": "+54 9 11 2345 6789",
    "nacional": "011 15-2345-6789",
    "whatsapp": "5491123456789",
    "tipo": "celular",
    "pais": "AR"
  },
  "credits": {
    "cost": 1,
    "balance": 49
  }
}

Python

import requests

r = requests.post(
    "https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/normalizar_telefono_ar",
    headers={"Authorization": "Bearer ak_..."},
    json={ "telefono": "011 15 2345-6789" },
    timeout=30,
)
print(r.json()["result"])

JavaScript

const r = await fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/normalizar_telefono_ar", {
  method: "POST",
  headers: { Authorization: "Bearer ak_...", "content-type": "application/json" },
  body: JSON.stringify({"telefono":"011 15 2345-6789"}),
});
const { result, credits } = await r.json();

Agentes de IA (MCP)

La misma tool está en el servidor MCP https://ar-tools-api-103907796853.us-east1.run.app/mcp, junto con las demás de AR Tools.

claude mcp add --transport http ar-tools https://ar-tools-api-103907796853.us-east1.run.app/mcp --header "Authorization: Bearer ak_..."
{
  "mcpServers": {
    "ar-tools": {
      "url": "https://ar-tools-api-103907796853.us-east1.run.app/mcp",
      "headers": {
        "Authorization": "Bearer ak_..."
      }
    }
  }
}

n8n

Usá un nodo HTTP Request: método POST, URL https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/normalizar_telefono_ar, header Authorization con el valor Bearer ak_... (mejor como credencial de tipo Header Auth) y, en Body, JSON con {"telefono":"011 15 2345-6789"}. El resultado queda en {{$json.result}}. También podés usar el nodo MCP Client con la URL https://ar-tools-api-103907796853.us-east1.run.app/mcp.

Google Sheets

En Extensiones → Apps Script, pegá esta función. Guardá la key en Configuración del proyecto → Propiedades de la secuencia de comandos con el nombre AR_API_KEY, así no queda en el código. Después usala en una celda: =WHATSAPP(C2). Cada celda hace una consulta y gasta créditos.

function WHATSAPP(telefono) {
  const key = PropertiesService.getScriptProperties().getProperty("AR_API_KEY");
  const r = UrlFetchApp.fetch("https://ar-tools-api-103907796853.us-east1.run.app/v1/tools/normalizar_telefono_ar", {
    method: "post",
    contentType: "application/json",
    headers: { Authorization: "Bearer " + key },
    payload: JSON.stringify({ telefono: telefono }),
  });
  return JSON.parse(r.getContentText()).result.whatsapp;
}

Preguntas frecuentes

¿Por qué WhatsApp no encuentra los celulares argentinos?

Porque necesita el formato 549 + código de área sin el 0 + número sin el 15. La API hace esa conversión.

¿Funciona con fijos?

Sí: los fijos no llevan el 9 y la respuesta trae tipo: "fijo".

¿Qué pasa si falta el código de área?

Sin código de área el número es ambiguo y la API responde valido: false con el motivo.

¿Qué pasa cuando se terminan los créditos?

La API responde 402 con un checkout_url para recargar. Los packs se pagan una sola vez, sin suscripción, y los créditos no vencen. Ver precios.

Más

Otras APIs de datos argentinos

Privacidad