Você precisa verificar automaticamente se um número de telefone está no WhatsApp e, especificamente, se é uma conta comercial do WhatsApp. Ao final deste guia, você será capaz de acessar um endpoint pronto para produção que responde a ambas as perguntas e integrá-lo aos seus fluxos de integração, validação de leads, verificações internas de CRM ou regras antifraude—esta semana.
O que você pode construir com esta API
A API de Verificação de Números do WhatsApp valida se um número de telefone está registrado no WhatsApp e se está vinculado a uma conta comercial do WhatsApp. Casos de uso típicos incluem:
- Verificar os dados de contato do cliente antes de iniciar notificações pelo WhatsApp.
- Roteamento de leads: priorizar números que estão ativos no WhatsApp ou que pertencem a contas comerciais.
- Imposição de regras de contato: evitar tentativas de contato via WhatsApp para números que não são elegíveis.
- Enriquecimento de CRM: sinalizar registros com status de WhatsApp e conta comercial.
Está disponível no Zyla API Hub, um marketplace de APIs que oferece mais de 10.000 APIs públicas sob uma conta, uma chave de API e um modelo de assinatura + cota (não pago por chamada). A API de Verificação de Números do WhatsApp suporta um teste de 7 dias ou 50 solicitações—verifique a página da API para opções de acesso e preços atuais.
Começando no Zyla API Hub
Para começar a chamar os endpoints:
- Abra a página da API e comece seu teste: Iniciar teste de 7 dias na API de Verificação de Números do WhatsApp.
- Inscreva-se e recupere sua chave de API no seu painel.
- Adicione o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Você pode navegar e se inscrever em APIs adicionais em zylalabs.com usando a mesma conta e chave.
Endpoints que você usará
1) Verificador de Números Conta Comercial V2
Método: GET
URL: https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2
Descrição: Identifique rapidamente se um número de telefone corresponde a uma conta comercial do WhatsApp.
Parâmetro de consulta necessário: phone (string). Exemplo: 34605797764
exemplo curl:
curl -s -X GET "https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker?number=972508623456" \
-H "Authorization: Bearer YOUR_API_KEY"Exemplo de resposta:
{
"id": 12574,
"status": true,
"numberstatus": true,
"businessnumber": false
}Como usá-lo:
- Envie o número de telefone no formato internacional sem nenhum sinal de mais ou espaços.
- Inspecione o valor de resposta associado à chave "phone". No exemplo acima, o número não é uma conta comercial do WhatsApp.
2) Verificador de Números
Método: GET
URL: https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker
Descrição: Insira o número de telefone com o código do país, mas sem o sinal de +. O endpoint informará se o número está no WhatsApp ou não. Exemplo de formato: 14083742784
Parâmetro de consulta necessário: number (number). Exemplo: 972508623456
exemplo curl (exemplo oficial):
Resposta JSON (exemplo oficial):
Anotações de campo:
- id: Referência interna para esta verificação.
- status: Status geral da solicitação.
- numberstatus: Se o número está no WhatsApp.
- businessnumber: Se o número é uma conta comercial do WhatsApp.
Exemplo de ponta a ponta em Python
O trecho abaixo verifica se um telefone é uma conta comercial do WhatsApp usando o endpoint Verificador de Números Conta Comercial V2. Substitua YOUR_API_KEY pela sua chave real.
import requests
API_KEY = "YOUR_API_KEY"
phone = "34605797764" # formato internacional, sem mais
url = "https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2"
headers = {"Authorization": f"Bearer {API_KEY}"}
params = {"phone": phone}
resp = requests.get(url, headers=headers, params=params, timeout=15)
resp.raise_for_status()
data = resp.json()
# Exemplo de resposta: {"phone":"Not a Business Account"}
status_text = data.get("phone", "")
is_business = status_text and status_text.lower() != "not a business account"
print(f"Entrada: {phone}")
print(f"Conta comercial? {'sim' if is_business else 'não'}")Detalhes de implementação que economizam tempo
- Formato de entrada: Sempre inclua o código do país e omita o sinal de + e espaços. Por exemplo, use 14083742784 ou 34605797764.
- Método HTTP: Ambos os endpoints são solicitações GET simples com parâmetros de consulta.
- Autenticação: Sempre inclua Authorization: Bearer YOUR_API_KEY.
- Verificações síncronas: Cada chamada retorna o resultado imediatamente; você pode validar sob demanda durante a submissão de formulários ou trabalhos em lote noturnos.
- Tratamento de erros: Lide com respostas não 2xx com tentativas ou alternativas conforme apropriado para seu sistema. Registre as entradas e a carga de resposta para diagnósticos.
- Cache: Se seu fluxo de trabalho verifica o mesmo número com frequência, armazene resultados por um curto período para reduzir a latência e diminuir chamadas redundantes.
- Modelo de assinatura: O acesso é por assinatura + cota (não pago por chamada). A primeira API oferece um teste de 7 dias ou 50 solicitações. Sem plano gratuito. Veja a página de listagem para detalhes atuais.
Padrões de integração do mundo real
- Validação de captura de leads: Ao enviar o formulário, chame o Verificador de Números para confirmar se o número está no WhatsApp. Se estiver, e você precisar de um contato comercial, chame o Verificador de Números Conta Comercial V2 (ou leia o businessnumber da resposta do Verificador de Números quando disponível em seu fluxo) para qualificar o lead.
- Roteamento de integração: Para marketplaces que interagem com comerciantes, certifique-se de que os números de telefone registrados pertencem a contas comerciais do WhatsApp para agilizar o suporte e a integração por meio de canais do WhatsApp.
- Enriquecimento de CRM: O trabalho noturno itera sobre contatos não verificados, verifica o status do WhatsApp e da conta comercial e marca registros para automação posterior (por exemplo, habilitar modelos do WhatsApp apenas para números elegíveis).
- Diretrizes de conformidade: Se sua política proíbe o envio de mensagens para números não comerciais para certos contatos, imponha isso restringindo fluxos de trabalho na verificação da Conta Comercial V2.
Chamando esta API de um agente de IA via MCP
Se você preferir chamar APIs de um agente de IA (por exemplo, dentro de um cliente compatível com MCP), você pode direcionar suas chamadas através do endpoint MCP e sua chave Zyla. Veja a referência aqui: MCP. Forneça sua chave de API Zyla ao cliente e configure uma ferramenta que emita uma solicitação GET para a URL do endpoint desejado com o cabeçalho de Autorização. Isso permite que seu agente valide números do WhatsApp sob demanda durante fluxos de trabalho conversacionais ou ações de código.
Notas operacionais
- Segurança: Nunca registre sua chave de API. Use variáveis de ambiente ou um gerenciador de segredos.
- Tentativas: Implemente tentativas curtas e limitadas para problemas de rede transitórios (por exemplo, retrocesso exponencial).
- Observabilidade: Registre IDs de solicitação (se presentes nos cabeçalhos ou respostas), números de entrada (hash ou mascarados, se necessário) e flags de decisão final para solução de problemas.
- Teste: Use um pequeno conjunto de números representativos (WhatsApp válidos, não WhatsApp válidos e números conhecidos como contas comerciais vs. não) em staging antes do lançamento.
Referência rápida
Verificador de Números Conta Comercial V2
- GET https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2
- Parâmetros: phone (string, obrigatório). Exemplo: 34605797764
- Resultado: Indica se o número fornecido é uma conta comercial do WhatsApp.
Verificador de Números
- GET https://zylalabs.com/api/926/whatsapp-number-checker-api/743/number-checker
- Parâmetros: number (number, obrigatório). Exemplo: 972508623456
- Resultado: Retorna campos incluindo numberstatus para presença no WhatsApp e businessnumber para status comercial.
FAQ
Q: Qual formato de entrada devo usar para números de telefone?
A: Use o formato internacional com código do país, sem sinal de mais e sem espaços (por exemplo, 34605797764).
Q: Como faço para autenticar?
A: Inclua o cabeçalho Authorization: Bearer YOUR_API_KEY em cada solicitação.
Q: Qual endpoint me diz se um número é uma conta comercial do WhatsApp?
A: Use GET https://zylalabs.com/api/926/whatsapp-number-checker-api/18773/number-checker-business-acount-v2 com o parâmetro phone. Você também pode verificar o campo businessnumber da resposta do Verificador de Números quando isso se encaixar em seu fluxo.
Q: Posso testar a API antes de me comprometer?
A: Sim. A listagem suporta um teste de 7 dias ou 50 solicitações. Verifique a página da API para opções de acesso e preços atuais.
Q: Posso chamar isso de um agente de codificação de IA?
A: Sim. Use a configuração compatível com MCP e direcione as solicitações através do endpoint MCP mencionado acima, fornecendo sua chave de API Zyla.
Se você está pronto para integrar isso em suas validações de formulário, CRM ou fluxos de mensagens, comece aqui: Iniciar teste de 7 dias na API de Verificação de Números do WhatsApp. Uma conta e uma chave de API desbloqueiam a chamada imediatamente, e você pode expandir para o restante do catálogo Zyla a partir do mesmo painel.
