Maytapi
Maytapi/Documentação//checkPhones
/checkPhonesValide antes de enviarAPI de verificação de números do WhatsApp
Descubra quais números estão registrados no WhatsApp antes de mandar mensagem. Envie uma lista de números para um endpoint e receba quais são válidos — assim suas mensagens só vão para quem pode recebê-las.
- verificação em massa
- resultado válido / inválido
- id do WhatsApp de cada número
- ferramenta online grátis
Por que verificar os números antes
Enviar para números que não estão no WhatsApp desperdiça requisições e só aumenta o risco.
-
list hygiene
Limpe suas listas
Remova números que não usam WhatsApp antes de uma campanha ou importação.
-
forms
Valide no cadastro
Verifique o número assim que o usuário digitar no seu formulário.
-
anti-ban
Menos envios com falha
Mensagens para números sem WhatsApp nunca chegam — pulá-los mantém seu envio limpo.
Verifique vários números em uma requisição
Envie os números em formato internacional como um array. A resposta traz cada número com o status e o id do WhatsApp que você pode usar como to_number.
- ✓Formato internacional, sem +
- ✓valid: true ou false para cada número
- ✓O id do WhatsApp (…@c.us) é retornado para números válidos
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/checkPhones" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"numbers": [
"55119xxxxxx67",
"55119xxxxxx43"
]
}'const res = await fetch(`https://api.maytapi.com/api/${PID}/${PHONE_ID}/checkPhones`, {
method: "POST",
headers: { "x-maytapi-key": TOKEN, "Content-Type": "application/json" },
body: JSON.stringify({ numbers: ["55119xxxxxx67", "55119xxxxxx43"] })
});
const { data } = await res.json();
const onWhatsApp = data.filter((n) => n.valid).map((n) => n.id._serialized);res = requests.post(
f"https://api.maytapi.com/api/{PID}/{PHONE_ID}/checkPhones",
headers={"x-maytapi-key": TOKEN},
json={"numbers": ["55119xxxxxx67", "55119xxxxxx43"]},
timeout=10,
)
on_whatsapp = [n["id"]["_serialized"] for n in res.json()["data"] if n["valid"]]Uma resposta clara: válido ou inválido
Use o campo valid para separar sua lista e guarde o id retornado para enviar mensagens sem novas consultas.
- ✓status: valid ou invalid
- ✓id._serialized pronto para usar como to_number
{
"success": true,
"data": [
{
"status": "valid",
"valid": true,
"id": {
"server": "c.us",
"user": "55119xxxxxx67",
"_serialized": "55119xxxxxx67@c.us"
}
},
{
"status": "invalid",
"valid": false,
"id": {
"server": "c.us",
"user": "55119xxxxxx43",
"_serialized": "55119xxxxxx43@c.us"
}
}
]
}Onde as equipes verificam números
-
Importações no CRM
Marque quais clientes podem ser contatados pelo WhatsApp ao importar contatos.
-
Checkout
Ofereça avisos pelo WhatsApp só quando o número estiver no WhatsApp.
-
Envio mais seguro
Mantenha números inválidos fora da sua fila de envio.
Perguntas frequentes sobre verificação de números
Pergunte o que quiser ao nosso suporte pelo WhatsApp. O tempo médio de resposta é inferior a 24 horas.
Central de ajuda →O dono do número sabe que ele foi verificado?
Não. A verificação não envia nada para o número e o dono não é notificado.
Existe um jeito gratuito de testar?
Sim. O verificador de números gratuito do nosso site verifica números individuais sem conta.
Qual formato de número devo usar?
Formato internacional com código do país e sem + ou espaços, por exemplo 55119xxxxxx67.
Mais recursos da API do WhatsApp
Pegue sua chave e envie a primeira mensagem em dez minutos
Sem aprovação, sem templates, sem cartão. Todos os endpoints liberados por três dias.