Этот метод позволяет проверить наличие аккаунта в мессенджере по указанному номеру телефона, никнейму или ID чата, в зависимости от идентификатора, используемого в мессенджере. Особенно полезен для обработки списков контактов для фильтрации клиентов. Использование этого метода позволяет избежать попыток отправки сообщений пользователям, у которых нет мессенджеров, что улучшает аналитику и снижает количество ошибок. Если контакт есть в базе WAMM.chat, то проверка пройдена, если нет - то делается внешний запрос к мессенджеру.

При отправке сообщений или файлов эта проверка выполняется автоматически, этот метод перед отправкой нет необходимости вызывать отдельно.

Поддерживаемые мессенджеры

Метод API проверки наличия мессенджера доступен для: WhatsApp, MAX Personal, Telegram Personal, Telegram Bot.

Пример запроса:

GET https://wamm.chat/api2/check_phone/{token}/?phone={phone}

или

GET https://wamm.chat/api2/check_phone/{token}/{phone}

Параметры запроса

Параметр	Тип	Обязательный	Описание
token	string	Да	API-токен, полученный в настройках
phone	string	Да	Номер телефона в международном формате (например, 79001234567). Для Telegram вместо номера можно указывать ID чата или никнейм, для MAX - ID чата

Ответ при успехе

{"err":0,"result":"exists"}

Возможные значения параметра result:

exists – есть аккаунт мессенджера
none – нет

Возможные ошибки

Код ошибки	Описание
token fail	Ошибка в токене
acc not authorized	Подключение не авторизовано
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 или произошла ошибка";
}