Maytapi/Documentație//checkPhones
/checkPhonesValidează înainte să trimițiAPI WhatsApp pentru verificarea numerelor
Află ce numere sunt înregistrate pe WhatsApp înainte să le scrii. Trimite o listă de numere către un endpoint și primești care sunt valide — ca mesajele să ajungă doar la cei care le pot primi.
- verificare în masă
- rezultat valid / invalid
- id WhatsApp pentru fiecare număr
- instrument online gratuit

De ce să verifici numerele mai întâi
Trimiterea către numere care nu sunt pe WhatsApp irosește cereri și nu aduce decât risc.
-
list hygiene
Curăță listele de contacte
Elimină numerele care nu sunt pe WhatsApp înainte de o campanie sau un import.
-
forms
Validează la înregistrare
Verifică numărul imediat ce utilizatorul îl scrie în formular.
-
anti-ban
Mai puține trimiteri eșuate
Mesajele către numere fără WhatsApp nu ajung — dacă le sari, trimiterile rămân curate.
Verifică multe numere într-o singură cerere
Trimite numerele în format internațional, ca array. Răspunsul returnează fiecare număr cu statusul și id-ul WhatsApp pe care îl poți folosi ca to_number.
- ✓Format internațional, fără +
- ✓valid: true sau false pentru fiecare număr
- ✓Id-ul WhatsApp (…@c.us) este returnat pentru numerele valide
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/checkPhones" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"numbers": [
"4072xxxxx67",
"4072xxxxx43"
]
}'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: ["4072xxxxx67", "4072xxxxx43"] })
});
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": ["4072xxxxx67", "4072xxxxx43"]},
timeout=10,
)
on_whatsapp = [n["id"]["_serialized"] for n in res.json()["data"] if n["valid"]]Un răspuns clar: valid sau invalid
Folosește câmpul valid ca să împarți lista și păstrează id-ul returnat pentru a trimite mesaje fără alte căutări.
- ✓status: valid sau invalid
- ✓id._serialized e gata de folosit ca to_number
{
"success": true,
"data": [
{
"status": "valid",
"valid": true,
"id": {
"server": "c.us",
"user": "4072xxxxx67",
"_serialized": "4072xxxxx67@c.us"
}
},
{
"status": "invalid",
"valid": false,
"id": {
"server": "c.us",
"user": "4072xxxxx43",
"_serialized": "4072xxxxx43@c.us"
}
}
]
}Unde verifică echipele numerele
-
Importuri în CRM
Marchează ce clienți pot fi contactați pe WhatsApp la importul contactelor.
-
Checkout
Oferă notificări pe WhatsApp doar dacă numărul este pe WhatsApp.
-
Trimitere mai sigură
Ține numerele invalide în afara cozii de trimitere.
Întrebări frecvente despre verificarea numerelor
Întreabă echipa de suport orice pe WhatsApp. Timpul mediu de răspuns este sub 24 de ore.
Centru de ajutor →Află persoana că numărul i-a fost verificat?
Nu. Verificarea nu trimite nimic către număr, iar proprietarul nu este notificat.
Pot încerca gratuit?
Da. Verificatorul gratuit de numere WhatsApp de pe site-ul nostru verifică numere individuale fără cont.
Ce format de număr trebuie folosit?
Format internațional cu prefixul țării, fără + sau spații, de exemplu 4072xxxxx67.
Alte funcționalități ale API-ului WhatsApp

Obține cheia și trimite primul mesaj în zece minute
Fără aprobare, fără șabloane, fără card. Toate endpointurile sunt deschise timp de trei zile.