> ## Documentation Index
> Fetch the complete documentation index at: https://docs.notifique.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# Validación de teléfono

> Comprueba si un número es válido y si tiene WhatsApp antes de gastar crédito en SMS, voz o WhatsApp.

<Tip>
  **Validación de teléfono** es el **revisor de la lista de contactos**: antes de llamar, mandar SMS o WhatsApp, sabes si el número existe, si es móvil o fijo y, en modo completo, si **tiene WhatsApp**. Usa el panel en **Add-ons → Validación de teléfono** o integra en el registro de tu sistema.
</Tip>

## ¿Qué es?

Es un add-on que responde: *¿este número es utilizable?*

A diferencia de [contratar un número](/es/phone-numbers-api/como-funciona/introducao) para **llamar o enviar**, aquí **verificas números de clientes** en tu base — higienización de CRM, formulario o importación de lista.

## ¿Por qué usar?

| Sin validación                        | Con validación                                   |
| ------------------------------------- | ------------------------------------------------ |
| SMS a 5.000 números con 40% inválidos | Elimina inválidos antes del envío                |
| Campaña WhatsApp a número sin app     | En modo completo, filtra quien no tiene WhatsApp |
| Llamada a fijo cuando esperabas móvil | `line_type` muestra móvil, fijo o VoIP           |

## Dos modos de verificación

| Modo                  | Qué comprueba                                | Créditos (plan) | Pago por uso |
| --------------------- | -------------------------------------------- | --------------- | ------------ |
| **Rápida** (`quick`)  | Formato internacional, país y tipo de línea  | 1 por número    | R\$ 0,01     |
| **Completa** (`full`) | Todo lo de la rápida + **si tiene WhatsApp** | 27 por número   | R\$ 0,04     |

<Info>
  La verificación de WhatsApp **no usa la API oficial de Meta** para lookup previo. La plataforma lo ejecuta internamente; solo ves el resultado (`whatsapp_registered`: sí, no o indeterminado).
</Info>

## Panel vs API

| Canal                                        | Límite               | Uso típico                            |
| -------------------------------------------- | -------------------- | ------------------------------------- |
| **Panel** (Add-ons → Validación de teléfono) | Hasta **10** números | Prueba manual, lista pequeña          |
| **API** `POST /v1/validations/phone`         | Hasta **10** números | Validación en el registro del usuario |
| **API** `POST /v1/validations/phone/batch`   | **500** a **10.000** | Listas grandes (asíncrono)            |

En el panel: pega los números, elige **Rápida** o **Completa** y mira el resultado — **aprobado**, **rechazado** o **indeterminado**, con badge **Con WhatsApp** / **Sin WhatsApp** en modo completo.

## Qué significa cada status

| `status`  | En español claro                                               |
| --------- | -------------------------------------------------------------- |
| `valid`   | Número válido (y con WhatsApp en modo completo, cuando aplica) |
| `invalid` | Formato inválido o sin WhatsApp (modo completo)                |
| `unknown` | Formato ok, pero la verificación completa no pudo concluir     |
| `risky`   | Señales de baja confianza (cuando aplica)                      |

Campos útiles en cada ítem:

| Campo                 | Qué es                                                   |
| --------------------- | -------------------------------------------------------- |
| `phone`               | Número normalizado (ej.: `+5511999999999`)               |
| `phone_valid`         | Pasó la verificación de formato                          |
| `line_type`           | `mobile` (móvil), `fixed_line` (fijo), `voip` o `null`   |
| `country_code`        | País (ej.: `BR`)                                         |
| `whatsapp_registered` | `true` / `false` en modo completo; `null` en modo rápido |
| `reason`              | Texto legible para log o tooltip                         |
| `credits_charged`     | Créditos cobrados en esta verificación                   |

## Ámbito de la API Key

Las rutas de teléfono exigen **`validations:phone`** — separado de `sms:send`, `whatsapp:send` y de `validations:email`.

## Pool compartido (opcional)

En **Configuración del workspace** puede activar la contribución de sus líneas no oficiales para ayudar en validaciones de otros clientes. **Desactivado por defecto.** Sus propias verificaciones siempre usan primero las líneas de su workspace.

## Próximos pasos

* [Inicio rápido](/es/validations-api/como-funciona/quick-start)
* [Modos y cobro](/es/validations-api/como-funciona/modos-e-cobranca)
* [Ámbitos de la API Key](/es/validations-api/como-funciona/escopos-da-api-key)
* [Validación de correo](/es/validations-api/como-funciona/introducao)
* [Consulta de CPF](/es/validations-api/como-funciona/introducao-cpf)
* [API de precios](/es/guides/precos/api-de-precos) — SKUs `PHONE_VERIFY_QUICK` y `PHONE_VERIFY_FULL`