Maytapi
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.
-
Безопасная отправка
Не допускайте недействительные номера в очередь отправки.
Вопросы о проверке номеров
Задайте любой вопрос поддержке по email или через справочный центр. Среднее время ответа — меньше 24 часов.
Центр помощи →Узнает ли человек, что его номер проверяли?
Нет. Проверка ничего не отправляет на номер, и владелец не получает уведомления.
Можно ли попробовать бесплатно?
Да. Бесплатный инструмент проверки номеров WhatsApp на нашем сайте проверяет отдельные номера. Он работает через ваш собственный номер, поэтому нужен бесплатный аккаунт Maytapi и подключённый телефон.
В каком формате указывать номер?
В международном формате с кодом страны, без + и пробелов, например 7916xxxxx67.
Другие возможности WhatsApp API
Получите ключ и отправьте первое сообщение за десять минут
Без одобрения, без шаблонов, без карты. Все эндпоинты открыты на три дня.