Neste breve tutorial, você vai aprender como validar se um determinado número de telefone existe e como receber mensagens do WhatsApp para melhorar a efetividade da comunicação com clientes.
O WhatsApp é bem conhecido como a melhor forma de se comunicar diretamente com seus clientes de maneira privada, segura, direta e muito mais barata.
Embora o WhatsApp seja extremamente popular e a maioria das pessoas no mundo o utilize, nem todos os números de telefone têm uma conta do WhatsApp ativamente vinculada a eles. Isso acontece porque o WhatsApp é um serviço independente da operadora móvel, e cabe ao proprietário da linha móvel se registrar no WhatsApp para enviar e receber mensagens com outros usuários do WhatsApp.
Especialmente em relações business-to-customer, é crucial para uma comunicação confiável e eficaz saber antecipadamente se você pode alcançar os clientes pelo WhatsApp ou, caso contrário, usar canais de comunicação menos eficazes, como SMS ou e-mail.
E aqui está a mágica: usando a Wassenger API, você pode validar de forma fácil e automática se um número de telefone tem o WhatsApp ativo e pode receber mensagens do WhatsApp. Você também pode validar muitos números de telefone. É mais fácil do que você pensa, então vamos lá 😎
Requisitos
- Crie uma conta gratuita na Wassenger
- Conecte seu número do WhatsApp: Isso leva 2 minutos, literalmente!
- Obtenha sua chave de API aqui
- Cliente HTTP usando código, Postman ou o testador de API da Wassenger
🤩 🤖 Wassenger é uma solução API completa para o 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!
Como validar números de telefone no WhatsApp
Você deve ter um número de telefone móvel com o prefixo internacional do país, apenas com dígitos, sem espaços e sem símbolos.
Se você não tem os números de telefone em um formato padrão, sem problema. Você também pode padronizar múltiplos números de telefone usando a API muito facilmente. leia mais aqui.
Exemplos de números de telefone padronizados no formato E164:
+14155552671 +442071838750 +551155256325 +496912345678
Preparando a requisição HTTP da API
Método HTTP: POST
URL da API (página de documentação):
https://api.wassenger.com/v1/numbers/exists?token=$API_KEY
> Substitua o *$API_KEY* pelo seu Wassenger API key
Cabeçalhos da requisição HTTP > Content-Type: application/json
Agora, vamos definir o corpo da requisição HTTP em formato JSON:
{
"phone": "+14158586273"
}
> Substitua o número de telefone de exemplo pelo que você deseja validar.
Avaliando a resposta
Se o número de telefone existir, você receberá uma resposta 200 OK da API:
{
"exists": true,
"phone": "+14158586273",
"wid": "14158586273@c.us",
"isBusiness": true,
"businessInfo": {
"level": "verified",
"name": "WhatsApp Business name",
"isApi": false,
"isSmb": true,
"privacyMode": null
},
"country": {
"code": "US",
"name": "USA",
"officialName": "United States of America",
"phonePrefix": "+1",
"flag": "🇺🇸",
"domain": ".us",
"currency": "USD",
"currencyName": "United States Dollar",
"languages": ["en"],
"locales": ["en-US"],
"timezones": ["America/New_York"]
}
}
Se o número de telefone NÃO existir, você receberá uma resposta 404 Not Found da API:
{
"phone": "+14158586273",
"wid": "14158586273@c.us",
"exists": false
}
🤩 🤖 Wassenger é uma solução API completa para o WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!
🖥️ Procurando um exemplo de código? Vá ao testador de API ao vivo e obtenha exemplos de código prontos para uso em mais de 15 linguagens de programação, incluindo JavaScript, PHP, C#, Java, Ruby, Go, Powershell, cURL e mais.
Validar números de telefone com C# (.NET) RestClient
// 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/exists");
var request = new RestRequest(Method.POST);
request.AddHeader("Content-Type", "application/json");
request.AddHeader("Token", "API TOKEN GOES HERE");
request.AddParameter("application/json", "{\"phone\":\"+14155552671\"}", ParameterType.RequestBody);
IRestResponse response = client.Execute(request);
Validar números de telefone com C# (.NET) HttpClient
// This code uses the built-in HttpClient package in the.NET framework.
// Documentation: https://docs.microsoft.com/en-us/dotnet/api/system.net.http.httpclient?view=net-6.0
using System.Net.Http.Headers;
var client = new HttpClient();
var request = new HttpRequestMessage
{
Method = HttpMethod.Post,
RequestUri = new Uri("https://api.wassenger.com/v1/numbers/exists"),
Headers =
{
{ "Token", "API TOKEN GOES HERE" },
},
Content = new StringContent("{\"phone\":\"+14155552671\"}")
{
Headers =
{
ContentType = new MediaTypeHeaderValue("application/json")
}
}
};
using(var response = await client.SendAsync(request))
{
response.EnsureSuccessStatusCode();
var body = await response.Content.ReadAsStringAsync();
Console.WriteLine(body);
}
🤩 🤖 Wassenger é uma solução API completa para o WhatsApp. Inscreva-se para um teste gratuito de 7 dias e comece em minutos!
👉 Clique aqui para ver um exemplo ao vivo no testador HTTP da API ✌️
Perguntas?
Como validar e normalizar o formato do número de telefone
Você pode validar e padronizar o formato de vários números de telefone antes de verificar se eles existem no WhatsApp.
Para isso, você pode usar o endpoint validator de números.
Este endpoint da API apenas valida o formato correto E164, mas não verifica se o número de telefone efetivamente existe no WhatsApp ou não. Para esse propósito, por favor use as instruções fornecidas anteriormente neste tutorial.
Quantos números de telefone você pode validar?
Dependendo do seu plano de assinatura ativo na Wassenger, você pode validar de 2.000 até 50.000 por mês. Veja a tabela de preços para mais detalhes sobre os recursos de cada plano. Durante o teste gratuito, você pode validar até 100 números de telefone.
