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 email o desde el centro de ayuda. 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. Funciona a través de tu propio número, así que necesita una cuenta gratuita de Maytapi y un teléfono conectado.
¿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.