Maytapi
Maytapi/Documentación//checkPhones
/checkPhonesValida antes de enviarAPI de verificación de números de WhatsApp
Averigua qué números están registrados en WhatsApp antes de escribirles. Envía una lista de números a un endpoint y recibe cuáles son válidos, para que tus mensajes solo lleguen a quien puede recibirlos.
- verificación masiva
- resultado válido / no válido
- id de WhatsApp de cada número
- herramienta online gratuita
Por qué verificar los números primero
Enviar a números que no están en WhatsApp malgasta peticiones y solo añade riesgo.
-
list hygiene
Limpia tus listas
Elimina los números que no usan WhatsApp antes de una campaña o una importación.
-
forms
Valida en el registro
Comprueba el número en el momento en que el usuario lo escribe en tu formulario.
-
anti-ban
Menos envíos fallidos
Los mensajes a números sin WhatsApp nunca llegan; omitirlos mantiene limpio tu envío.
Verifica muchos números en una petición
Envía los números en formato internacional como un array. La respuesta devuelve cada número con su estado y el id de WhatsApp que puedes usar como to_number.
- ✓Formato internacional, sin +
- ✓valid: true o false para cada número
- ✓Se devuelve el id de WhatsApp (…@c.us) de los 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": [
"3461xxxxx67",
"3461xxxxx43"
]
}'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: ["3461xxxxx67", "3461xxxxx43"] })
});
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": ["3461xxxxx67", "3461xxxxx43"]},
timeout=10,
)
on_whatsapp = [n["id"]["_serialized"] for n in res.json()["data"] if n["valid"]]Una respuesta clara: válido o no válido
Usa el campo valid para dividir tu lista y guarda el id devuelto para enviar mensajes sin más consultas.
- ✓status: valid o invalid
- ✓id._serialized listo para usar como to_number
{
"success": true,
"data": [
{
"status": "valid",
"valid": true,
"id": {
"server": "c.us",
"user": "3461xxxxx67",
"_serialized": "3461xxxxx67@c.us"
}
},
{
"status": "invalid",
"valid": false,
"id": {
"server": "c.us",
"user": "3461xxxxx43",
"_serialized": "3461xxxxx43@c.us"
}
}
]
}Dónde verifican números los equipos
-
Importaciones al CRM
Marca qué clientes son contactables por WhatsApp al importar contactos.
-
Checkout
Ofrece avisos por WhatsApp solo si el número está en WhatsApp.
-
Envíos más seguros
Mantén los números no válidos fuera de tu cola de envío.
Preguntas frecuentes sobre la verificación de números
Pregunta lo que quieras a nuestro equipo de soporte por WhatsApp. El tiempo medio de respuesta es inferior a 24 horas.
Centro de ayuda →¿El titular sabe que se ha verificado su número?
No. La verificación no envía nada al número y el titular no recibe ningún aviso.
¿Hay una forma gratuita de probarlo?
Sí. El verificador de números gratuito de nuestra web comprueba números sueltos sin cuenta.
¿Qué formato de número debo usar?
Formato internacional con código de país y sin + ni espacios, por ejemplo 3461xxxxx67.
Más funciones de la API de WhatsApp
Consigue tu clave y envía tu primer mensaje en diez minutos
Sin aprobación, sin plantillas, sin tarjeta. Todos los endpoints abiertos durante tres días.