Проверить наличие WhatsApp по номеру телефона
Этот метод позволяет проверить наличие WhatsApp-аккаунта по указанному номеру телефона. Очень полезен для обработки списков контактов для фильтрации клиентов, у которых есть WhatsApp. Использование этого метода позволяет избежать попыток отправки сообщений на номера без WhatsApp, что улучшает аналитику и снижает количество ошибок. При отправке сообщений по API осуществляется автоматическая проверка, этот метод в таком случае вызывать перед отправкой нет необходимости.
GET /api2/check_phone/{token}/?phone={phone}
Параметры запроса
Параметр | Тип | Обязательный | Описание |
---|---|---|---|
token | string | Да | API-токен, полученный в настройках |
phone | string | Да | Номер телефона в международном формате (например, 79001234567) |
Ответ при успехе
{"err":0,"result":"exists"}
Возможные значения параметра result
:
exists
– есть WhatsApp на номереnone
– нет WhatsApp на номере
Возможные ошибки
Код ошибки | Описание |
---|---|
token fail | Ошибка в токене |
acc not authorized | Подключение к WhatsApp не авторизовано |
fail execution | Ошибка проверки, стоит повторить |
Примеры использования
curl -X GET "https://wamm.chat/api2/check_phone/YOUR_TOKEN/?phone=79001234567"
function checkWhatsApp($token, $phone) {
// Подготавливаем URL запроса
$url = "https://wamm.chat/api2/check_phone/$token/?phone=$phone";
// Выполняем запрос
$response = file_get_contents($url);
// Обрабатываем ответ
if ($response !== false) {
// Преобразуем ответ в массив
$json_response = json_decode($response, true);
// Проверяем наличие ошибок
if (isset($json_response['err'])) {
if ($json_response['err'] == 0 && isset($json_response['result'])) {
echo "Результат проверки: " . $json_response['result'];
return $json_response['result'] === 'exists';
} else {
echo "Ошибка: " . $json_response['err'];
}
} else {
echo "Не удалось обработать ответ от сервера";
}
} else {
echo "Не удалось выполнить запрос к серверу";
}
return false;
}
// Используем функцию для проверки наличия WhatsApp
$token = "YOUR_TOKEN";
$phone = "79001234567";
$hasWhatsApp = checkWhatsApp($token, $phone);
if ($hasWhatsApp) {
echo "Номер имеет WhatsApp";
} else {
echo "Номер не имеет WhatsApp или произошла ошибка";
}