# Formato de teléfonos

> Cómo escribir los números de cada país para que MINDO los reconozca.

WhatsApp identifica a cada persona por su número en **formato internacional**: el código del país seguido del número, sin ceros ni prefijos locales. MINDO lo guarda así, por ejemplo `5491123456789`, y te lo muestra más legible: `+54 9 11 2345-6789`.

## La regla corta

<Steps>
  <Step title="Empieza con + y el código del país">
    `+52`, `+57`, `+54`… Si lo escribes con `00` adelante (`0054…`), también funciona.
  </Step>
  <Step title="Sigue con el número completo">
    Con código de área o de ciudad, sin el `0` inicial de las llamadas nacionales.
  </Step>
  <Step title="Espacios, guiones y paréntesis dan igual">
    `+54 9 11 2345-6789`, `+5491123456789` y `+54 (9 11) 2345 6789` son el mismo número.
  </Step>
</Steps>

## Ejemplos por país

Estos ejemplos están probados con el mismo código que usa MINDO para importar y para la API.

| País | Cómo lo escribe la gente | Formato internacional |
| --- | --- | --- |
| 🇦🇷 Argentina | `011 15 2345-6789` · `351 234-5678` | `+54 9 11 2345 6789` · `+54 9 351 234 5678` |
| 🇲🇽 México | `55 1234 5678` | `+52 55 1234 5678` |
| 🇨🇴 Colombia | `300 123 4567` | `+57 300 123 4567` |
| 🇨🇱 Chile | `9 1234 5678` | `+56 9 1234 5678` |
| 🇵🇪 Perú | `987 654 321` | `+51 987 654 321` |
| 🇺🇾 Uruguay | `094 123 456` | `+598 94 123 456` |
| 🇵🇾 Paraguay | `0981 123456` | `+595 981 123 456` |
| 🇧🇴 Bolivia | `71234567` | `+591 7123 4567` |
| 🇪🇨 Ecuador | `099 123 4567` | `+593 99 123 4567` |
| 🇻🇪 Venezuela | `0412 1234567` | `+58 412 123 4567` |
| 🇧🇷 Brasil | `(11) 91234-5678` | `+55 11 91234 5678` |
| 🇪🇸 España | `612 34 56 78` | `+34 612 34 56 78` |
| 🇺🇸 Estados Unidos | `(305) 555-0123` | `+1 305 555 0123` |

### Casos especiales

<AccordionGroup>
  <Accordion title="Argentina: el 9 de los celulares" icon="flag">
    En WhatsApp, los celulares argentinos llevan un `9` entre el `54` y el código de área, y **no** llevan el `15`. MINDO lo resuelve solo: si escribes `+54 11 2345-6789` o `011 15 2345-6789` (con Argentina como país por defecto), lo guarda como `+54 9 11 2345 6789`.
  </Accordion>
  <Accordion title="México: sin el 1 después del 52" icon="flag">
    Escribe los números mexicanos como `+52` y los 10 dígitos, **sin** el `1` que se usaba antes para celulares. `+52 1 55 1234 5678` se rechaza como inválido; `+52 55 1234 5678` funciona. El viejo prefijo `044` tampoco se acepta.
  </Accordion>
  <Accordion title="Números sin código de país" icon="circle-help">
    Si importas una planilla con números locales, elige el **País por defecto** en el paso **Revisar** y MINDO completa el código. Sin país por defecto, los números tienen que venir con `+`.

    Por la API, el teléfono siempre tiene que incluir el código de país. Un número de 11 a 15 dígitos sin `+` (por ejemplo `5491123456789`) también se acepta.
  </Accordion>
</AccordionGroup>

## Al importar una planilla

En el paso **Revisar** de la importación tienes dos ayudas:

- **País por defecto**: se usa para los números que no empiezan con `+`.
- **Prefijo**: escribe un prefijo (por ejemplo `+57`) y toca **Agregar a N sin +** para ponérselo adelante a todos los números que no empiezan con `+`.

Las filas con un número que no se puede reconocer quedan marcadas en **Con errores** para que las corrijas antes de importar, y las repetidas en **Repetidas**.

<Frame>
  <img src="/images/guias/import-2-review.webp" alt="Paso Revisar de la importación con el país por defecto Argentina" />
</Frame>

Todo el paso a paso está en [Importar contactos](/guias/contactos/importar).

## Por la API

Los endpoints que reciben un teléfono (`to` en `POST /messages`, `phone` en `POST /contacts`) aceptan cualquiera de los formatos de arriba con código de país. Si no lo reconocen, responden `400`:

```json
{
  "error": "El teléfono “1123456789” no es válido. Usá formato internacional, por ejemplo +5491123456789.",
  "cause": null
}
```

En las respuestas y los webhooks, el teléfono siempre viene sin `+` y sin espacios: `5491123456789`.