Pular para o conteúdo
POST AI agent ready /v1/phone

API de validação de telefone - analisador de número gratuito

Analisa e valida um número de telefone. Retorna versões formatadas (E.164, nacional), código do país e nome do país.

Parameters

stringrequired

Phone number to validate. Include the country code for best results.

string

ISO 3166-1 alpha-2 country code hint for parsing numbers without a country prefix.

Code examples

curl -X POST https://api.botoi.com/v1/phone \
  -H "Content-Type: application/json" \
  -d '{"phone":"+14155552671","country":"US"}'

When to use this API

Normalize números de telefone em um banco de dados de contatos

Os usuários inserem números de telefone em dezenas de formatos: "415-555-2671", "(415) 555 2671", "+1 415.555.2671". Analise cada um por meio deste endpoint para obter o formato E.164 padronizado para armazenamento. Use o national_format para exibição na IU.

Encaminhar mensagens SMS por país

Antes de enviar um SMS através do seu provedor de mensagens, valide o número de telefone e extraia o código do país. Encaminhe mensagens através de gateways SMS específicos da região para reduzir custos e melhorar as taxas de entrega.

Bloquear números inválidos em formulários de inscrição

Valide os números de telefone no envio do formulário de inscrição. Rejeite imediatamente números inválidos e mostre aos usuários o formato nacional como confirmação do que foi analisado, detectando erros de digitação antes que cheguem ao seu banco de dados.

Frequently asked questions

Quais formatos de número de telefone são aceitos?
O terminal aceita formato internacional (+14155552671), formato nacional ((415) 555-2671) e variações mais comuns com traços, pontos ou espaços. Incluir o prefixo do código do país fornece resultados mais precisos.
Quando devo usar o parâmetro país?
Use o parâmetro país quando o número de telefone não incluir um prefixo de código de país (por exemplo, "4155552671" sem "+1"). A dica do país informa ao analisador qual plano de numeração aplicar.
O que é o formato E.164?
E.164 é o padrão internacional para números de telefone. Começa com um “+” seguido do código do país e do número do assinante, sem espaços ou pontuação. Exemplo: +14155552671.
Isso verifica se o número de telefone está em serviço?
Não. Este endpoint valida apenas formato e estrutura. Ele não liga nem envia mensagem de texto para o número para verificar se está ativo.
Posso validar números fixos e móveis?
Sim. O analisador lida com formatos de números fixos e móveis. É validado com base nas regras do plano de numeração do país.

Get your API key

Free tier includes 5 requests per minute with no credit card required. Upgrade for higher limits.