> ## 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.

# Validação de telefone

> Confira se um número é válido e se tem WhatsApp antes de gastar crédito em SMS, voz ou WhatsApp.

<Tip>
  **Validação de telefone** é o **conferente da lista de contatos**: antes de ligar, mandar SMS ou WhatsApp, você sabe se o número existe, se é celular ou fixo e, no modo completo, se **tem WhatsApp**. Use no painel em **Add-ons → Validação de telefone** ou integre no cadastro do seu sistema.
</Tip>

## O que é?

É um add-on que responde: *este número é utilizável?*

Diferente de [contratar um número](/phone-numbers-api/como-funciona/introducao) para **ligar ou enviar**, aqui você **verifica números de clientes** na sua base — higienização de CRM, formulário ou importação de lista.

## Por que usar?

| Sem validação                             | Com validação                                  |
| ----------------------------------------- | ---------------------------------------------- |
| SMS para 5.000 números com 40% inválidos  | Remove inválidos antes do disparo              |
| Campanha WhatsApp em número sem app       | No modo completo, filtra quem não tem WhatsApp |
| Ligação para fixo quando esperava celular | `line_type` mostra móvel, fixo ou VoIP         |

## Dois modos de verificação

| Modo                  | O que confere                               | Créditos (plano) | Pague pelo uso |
| --------------------- | ------------------------------------------- | ---------------- | -------------- |
| **Rápida** (`quick`)  | Formato internacional, país e tipo de linha | 1 por número     | R\$ 0,01       |
| **Completa** (`full`) | Tudo da rápida + **se tem WhatsApp**        | 27 por número    | R\$ 0,04       |

<Info>
  A checagem de WhatsApp **não usa API oficial da Meta** para lookup prévio. A plataforma executa internamente; você vê só o resultado (`whatsapp_registered`: sim, não ou indeterminado).
</Info>

## Painel vs API

| Canal                                        | Limite               | Uso típico                       |
| -------------------------------------------- | -------------------- | -------------------------------- |
| **Painel** (Add-ons → Validação de telefone) | Até **10** números   | Teste manual, lista pequena      |
| **API** `POST /v1/validations/phone`         | Até **10** números   | Validação no cadastro do usuário |
| **API** `POST /v1/validations/phone/batch`   | **500** a **10.000** | Listas grandes (assíncrono)      |

No painel: cole os números, escolha **Rápida** ou **Completa** e veja o resultado — **aprovado**, **reprovado** ou **indeterminado**, com badge **Com WhatsApp** / **Sem WhatsApp** no modo completo.

## O que significa cada status

| `status`  | Em português claro                                                |
| --------- | ----------------------------------------------------------------- |
| `valid`   | Número válido (e com WhatsApp no modo completo, quando aplicável) |
| `invalid` | Formato inválido ou sem WhatsApp (modo completo)                  |
| `unknown` | Formato ok, mas a verificação completa não pôde concluir          |
| `risky`   | Sinais de baixa confiança (quando aplicável)                      |

Campos úteis em cada item:

| Campo                 | O que é                                                   |
| --------------------- | --------------------------------------------------------- |
| `phone`               | Número normalizado (ex.: `+5511999999999`)                |
| `phone_valid`         | Passou na checagem de formato                             |
| `line_type`           | `mobile` (celular), `fixed_line` (fixo), `voip` ou `null` |
| `country_code`        | País (ex.: `BR`)                                          |
| `whatsapp_registered` | `true` / `false` no modo completo; `null` no modo rápido  |
| `reason`              | Texto legível para log ou tooltip                         |
| `credits_charged`     | Créditos cobrados nesta verificação                       |

## Escopo da API Key

Rotas de telefone exigem **`validations:phone`** — separado de `sms:send`, `whatsapp:send` e de `validations:email`.

## Pool compartilhado (opcional)

Workspaces com linha WhatsApp não oficial (Evolution) podem **optar** em **Configurações do workspace → Ajuda na validação de telefone** para contribuir com suas linhas ao pool compartilhado. Isso ajuda outros clientes a concluir verificações quando não têm linha própria — **desativado por padrão**. Suas verificações **sempre** usam primeiro as linhas do seu workspace; a plataforma alterna entre instâncias para não sobrecarregar um único número.

## Próximos passos

* [Quick Start](/validations-api/como-funciona/quick-start)
* [Modos e cobrança](/validations-api/como-funciona/modos-e-cobranca)
* [Escopos da API Key](/validations-api/como-funciona/escopos-da-api-key)
* [Validação de e-mail](/validations-api/como-funciona/introducao)
* [Consulta de CPF](/validations-api/como-funciona/introducao-cpf)
* [API de preços](/guides/precos/api-de-precos) — SKUs `PHONE_VERIFY_QUICK` e `PHONE_VERIFY_FULL`