Maytapi/Документация//checkPhones
/checkPhonesПроверяйте перед отправкойAPI проверки номеров WhatsApp
Узнайте, какие номера зарегистрированы в WhatsApp, прежде чем писать им. Отправьте список номеров на один эндпоинт и получите, какие из них действительны, — чтобы сообщения уходили только тем, кто может их получить.
- массовая проверка
- результат: действителен / нет
- id WhatsApp для каждого номера
- бесплатный онлайн-инструмент

Зачем сначала проверять номера
Отправка на номера без WhatsApp тратит запросы и только добавляет риск.
-
list hygiene
Чистые списки
Удаляйте номера без WhatsApp перед рассылкой или импортом.
-
forms
Проверка при регистрации
Проверяйте номер сразу, как пользователь вводит его в форму.
-
anti-ban
Меньше неудачных отправок
Сообщения на номера без WhatsApp не доходят — пропуская их, вы сохраняете отправку чистой.
Проверка многих номеров одним запросом
Передайте номера в международном формате массивом. В ответе — каждый номер со статусом и id WhatsApp, который можно использовать как to_number.
- ✓Международный формат без +
- ✓valid: true или false для каждого номера
- ✓Для действительных номеров возвращается id WhatsApp (…@c.us)
curl -X POST "https://api.maytapi.com/api/$PID/$PHONE_ID/checkPhones" \
-H "x-maytapi-key: $TOKEN" \
-H "Content-Type: application/json" \
-d '{
"numbers": [
"7916xxxxx67",
"7916xxxxx43"
]
}'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: ["7916xxxxx67", "7916xxxxx43"] })
});
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": ["7916xxxxx67", "7916xxxxx43"]},
timeout=10,
)
on_whatsapp = [n["id"]["_serialized"] for n in res.json()["data"] if n["valid"]]Понятный ответ: действителен или нет
Используйте поле valid, чтобы разделить список, и сохраняйте полученный id, чтобы отправлять сообщения без дополнительных запросов.
- ✓status: valid или invalid
- ✓id._serialized готов к использованию как to_number
{
"success": true,
"data": [
{
"status": "valid",
"valid": true,
"id": {
"server": "c.us",
"user": "7916xxxxx67",
"_serialized": "7916xxxxx67@c.us"
}
},
{
"status": "invalid",
"valid": false,
"id": {
"server": "c.us",
"user": "7916xxxxx43",
"_serialized": "7916xxxxx43@c.us"
}
}
]
}Где команды проверяют номера
-
Импорт в CRM
Отмечайте, с какими клиентами можно связаться в WhatsApp, при импорте контактов.
-
Оформление заказа
Предлагайте уведомления в WhatsApp, только если номер есть в WhatsApp.
-
Безопасная отправка
Не допускайте недействительные номера в очередь отправки.
Вопросы о проверке номеров
Задайте любой вопрос поддержке в WhatsApp. Среднее время ответа — меньше 24 часов.
Центр помощи →Узнает ли человек, что его номер проверяли?
Нет. Проверка ничего не отправляет на номер, и владелец не получает уведомления.
Можно ли попробовать бесплатно?
Да. Бесплатный инструмент проверки номеров WhatsApp на нашем сайте проверяет отдельные номера без регистрации.
В каком формате указывать номер?
В международном формате с кодом страны, без + и пробелов, например 7916xxxxx67.
Другие возможности WhatsApp API

Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.