Tutorial de Validação em Massa de Números de Telefone do WhatsApp

15 de julho de 2024

Você já quis garantir que os números dos clientes da sua empresa estejam salvos corretamente na sua lista de contatos? Pois com o Wassenger isso muda completamente o jogo para comunicação direta. Para empresas, verificar a validade, os dígitos e o formato de números de telefone aleatórios e não normalizados para o formato internacional E164 é essencial para maximizar esforços de marketing, economizar tempo e reduzir custos ao se comunicar com clientes em potencial nos negócios digitais em escala global de hoje.

Seguindo este tutorial, você poderá limpar e validar os números de telefone do seu banco de dados usando a API do Wassenger e obter números normalizados, filtrados e válidos no formato E164 que você pode usar para fazer chamadas, enviar mensagens WhatsApp ou SMS para sua base de usuários (aliás, o Wassenger pode ajudar você a se comunicar melhor no WhatsApp, saiba mais aqui)

Wassenger oferece uma solução confiável para validar números de telefone no WhatsApp, simplificando a comunicação e melhorando o engajamento do cliente. Neste artigo, vamos explorar a importância da validação de números e como o Wassenger pode ajudar a otimizar suas estratégias de alcance.

🤩 🤖 Wassenger é uma plataforma completa de comunicação e solução de API para WhatsApp. Explore mais de 100+ casos de uso da API e automatize qualquer coisa no WhatsApp inscrevendo-se para um teste gratuito e começando em minutos**!**

Requisitos

Neste tutorial usaremos o seguinte endpoint da API:

Novidade! Agora você pode validar uma lista de números em uma única requisição de API passando-os no corpo da chamada. Clique aqui para testar

Validar os números

Validar e normalizar uma lista de números de telefone, opcionalmente forçando o código do país ou o prefixo local.

A validação é realizada apenas no nível do formato dos dígitos, ela não verifica se um determinado número de telefone existe no WhatsApp.

URL da API alvo (POST)

O token da chave API do usuário precisa ser usado em toda requisição da API que requer autenticação

https://api.wassenger.com/v1/numbers/validate

Cabeçalhos HTTPS obrigatórios

Você pode defini‑lo via o parâmetro de consulta “token” na URL ou pelo cabeçalho HTTP “Token”.

Content-Type: application/json
Token: $API-TOKEN

Corpo da requisição em formato JSON

{
  "country": "US",
  "numbers": [
    {
      "phone": "202-456-1414"
    },
    {
      "phone": "+1 202 456 1414"
    },
    {
      "phone": "1 415(858-6273)"
    }
  ]
}

Obter a resposta da API

{
  "numbers": [
    {
      "valid": true,
      "error": null,
      "phone": "+12024561414",
      "wid": "12024561414@c.us",
      "input": "202-456-1414",
      "kind": "fixed_line",
      "countryPrefix": 1,
      "country": "US",
      "formats": {
        "local": "2024561414",
        "national": "2024561414",
        "international": "+12024561414"
      }
    }
  ],
  "summary": {
    "valid": 3,
    "invalid": 0
  }
}

Validar números usando código

Explore como usar o código no seu navegador sem instalar nenhum software.

Além disso, você pode encontrar diferentes linguagens que pode testar no Replit.com:

# Exemplos requerem que o pacote requests do Python esteja instalado. # Instale-o executando: pip install requests

import requests

url = "https://api.wassenger.com/v1/numbers/validate"

payload = { "country": "US", "numbers": [{ "phone": "202-456-1414" }, { "phone": "+1 202 456 1414" }, { "phone": "1 415 (858-6273)" }] } headers = { "Content-Type": "application/json", "Token": "$API_KEY" }

response = requests.post(url, json=payload, headers=headers)

print(response.json())

"https://api.wassenger.com/v1/numbers/validate", CURLOPT\_RETURNTRANSFER => true, CURLOPT\_ENCODING => "", CURLOPT\_MAXREDIRS => 10, CURLOPT\_TIMEOUT => 30, CURLOPT\_HTTP\_VERSION => CURL\_HTTP\_VERSION\_1\_1, CURLOPT\_CUSTOMREQUEST => "POST", CURLOPT\_POSTFIELDS => json\_encode(\[ 'country' => 'US', 'numbers' => \[ \[ 'phone' => '202-456-1414' \], \[ 'phone' => '+1 202 456 1414' \], \[ 'phone' => '1 415 (858-6273)' \] \] \]), CURLOPT\_HTTPHEADER => \[ "Content-Type: application/json", "Token: $API\_KEY" \], \]); $response = curl\_exec($curl); $err = curl\_error($curl); curl\_close($curl); if ($err) { echo "cURL Error #:" . $err; } else { echo $response; } - [PHP](https://replit.com/new) \# Exemplos requerem que o pacote pecl\_http esteja instalado, um cliente HTTP simples e elegante para PHP. \# Instale-o executando: pecl install pecl\_http \# Mais informações: https://pecl.php.net/package/pecl\_http/3.2.0 append(json\_encode(\[ 'country' => 'US', 'numbers' => \[ \[ 'phone' => '202-456-1414' \], \[ 'phone' => '+1 202 456 1414' \], \[ 'phone' => '1 415 (858-6273)' \] \] \])); $request->setRequestUrl('https://api.wassenger.com/v1/numbers/validate'); $request->setRequestMethod('POST'); $request->setBody($body); $request->setHeaders(\[ 'Content-Type' => 'application/json', 'Token' => '$API\_KEY' \]); $client->enqueue($request)->send(); $response = $client->getResponse(); echo $response->getBody(); - [Go](https://replit.com/new) ```swift package main import( "fmt" "strings" "net/http" "io" ) func main() { url:= "https://api.wassenger.com/v1/numbers/validate" payload:= strings.NewReader("{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}") req, _:= http.NewRequest("POST", url, payload) req.Header.Add("Content-Type", "application/json") req.Header.Add("Token", "$API_KEY") res, _:= http.DefaultClient.Do(req) defer res.Body.Close() body, _:= io.ReadAll(res.Body) fmt.Println(res) fmt.Println(string(body)) } ``` - [C#](https://replit.com/new) (RestClient) ```swift // This code requires you to have installed RestSharp package. // Documentation: https://restsharp.dev // Installation: https://www.nuget.org/packages/RestSharp var client = new RestClient("https://api.wassenger.com/v1/numbers/validate"); var request = new RestRequest(Method.POST); request.AddHeader("Content-Type", "application/json"); request.AddHeader("Token", "$API_KEY"); request.AddParameter("application/json", "{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}", ParameterType.RequestBody); IRestResponse response = client.Execute(request); ``` - [Ruby](https://replit.com/new) require 'uri' require 'net/http' url = URI("https://api.wassenger.com/v1/numbers/validate") http = Net::HTTP.new(url.host, url.port) http.use\_ssl = true request = Net::HTTP::Post.new(url) request\["Content-Type"\] = 'application/json' request\["Token"\] = '$API\_KEY' request.body = "{\\"country\\":\\"US\\",\\"numbers\\":\[{\\"phone\\":\\"202-456-1414\\"},{\\"phone\\":\\"+1 202 456 1414\\"},{\\"phone\\":\\"1 415 (858-6273)\\"}\]}" response = http.request(request) puts response.read\_body - [Java](https://replit.com/new) ```swift // This code requires you to have installed Unirest package. // Documentation: https://kong.github.io/unirest-java/#requests // Installation: http://kong.github.io/unirest-java/ HttpResponse response = Unirest.post("https://api.wassenger.com/v1/numbers/validate") .header("Content-Type", "application/json") .header("Token", "$API_KEY") .body("{\"country\":\"US\", \"numbers\":[{\"phone\":\"202-456-1414\"}, {\"phone\":\"+1 202 456 1414\"}, {\"phone\":\"1 415(858-6273)\"}]}") .asString(); ``` > 🤩 🤖 [**Wassenger**](https://wassenger.com/) é uma plataforma completa de comunicação e solução de API para WhatsApp. [**Explore mais de 100+ casos de uso da API e automatize qualquer coisa no WhatsApp**](https://wassenger.com/) inscrevendo-se [para um teste gratuito e começando em minutos**!**](https://wassenger.com/register) #### Teste ao vivo do upload de arquivo usando a API ![](/images/blog/whatsapp-phone-numbers-bulk-validation-tuto-02.png) [Explore nosso testador ao vivo da API](https://app.wassenger.com/help/api-tester) ### Perguntas Frequentes #### Preciso de uma conta WhatsApp Business? Nossa plataforma funciona da mesma forma, quer você tenha uma conta WhatsApp pessoal ou uma conta WhatsApp Business. #### Posso usar o Wassenger para chatbots? Sim, você pode construir seu chatbot com nossa API e webhooks. Para isso, é necessário assinar qualquer plano Platform que permita implementar chatbots sobre a API. Explore mais no nosso artigo relacionado [**aqui**](https://medium.com/@wassenger/build-a-whatsapp-chatgpt-powered-ai-chatbot-for-your-business-595a60eb17da). #### Onde posso obter os exemplos de código da API? Por favor, verifique a [documentação da API](https://app.wassenger.com/docs) e selecione o exemplo de código pronto para uso na linguagem desejada. Oferecemos exemplos de código para as linguagens e ferramentas CLI mais comuns, como JavaScript, Node.js, Python, Ruby, PHP, Java, C#, Swift, Go e mais. > ***Procurando por mais respostas?*** [***Confira as FAQs estendidas***](https://app.wassenger.com/help/category/faq)***.*** #### Recursos úteis adicionais #### Documentação da API 🖥️ Para mais detalhes sobre o endpoint da API, por favor consulte a documentação onde você encontrará todos os detalhes sobre os parâmetros de requisição aceitos, possíveis respostas de sucesso ou erro e exemplos de código prontos para uso em múltiplas linguagens de programação: [https://app.wassenger.com/docs/#tag/Numbers/operation/validateNumbers](https://app.wassenger.com/docs/#tag/Numbers/operation/validateNumbers)

Ready to transform your WhatsApp communication?

Start automating your customer interactions today with Wassenger

Get Started Free