Этот метод позволяет добавлять новые контакты в WAMM.chat или обновлять информацию о существующих контактах. Полезен для синхронизации базы контактов между различными системами, автоматического обновления данных о клиентах из CRM и для добавления новых клиентов перед отправкой им сообщений. Добавление контакта не требует предварительной проверки его наличия в системе.

GET /api2/contact_to/{token}/?phone={phone}&name={name}&info={info}&email={email}&web={web}

Параметры запроса
ПараметрТипОбязательныйОписание
tokenstringДаAPI-токен, полученный в настройках
phonestringДаНомер телефона в международном формате (например, 79001234567) или ID чата для Telegram
namestringДаИмя контакта
infostringНетПримечание или заметка к контакту
emailstringНетEmail контакта
webstringНетURL сайта или страницы контакта
Ответ при успехе
{"err":0,"result":"insert"}

или

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

Возможные ошибки
Код ошибкиОписание
token failОшибка в токене
acc not authorizedПодключение не авторизовано
phone failОшибка в номере телефона
no WhatsApp on the numberНет WhatsApp с таким номером
no Account on the numberНет аккаунта с таким номером для других каналов (Telegram...)
phone not checked for WhatsApp, please retryНе проверен номер на наличие WhatsApp
phone not checked, please retryНе проверен номер на наличие аккаунта для других каналов
name failНе указано имя
name fail, more 250Имя слишком большое, превышает 250 символов
web fail, more 150URL слишком большой, превышает 150 символов
email fail, more 150Email слишком большой, превышает 150 символов

Примеры использования
curl -X GET "https://wamm.chat/api2/contact_to/YOUR_TOKEN/?phone=79001234567&name=Иван%20Петров&info=Новый%20клиент&email=ivan@example.com&web=https://example.com"
function addOrUpdateContact($token, $phone, $name, $info = '', $email = '', $web = '') {
    // Подготавливаем URL запроса
    $url = "https://wamm.chat/api2/contact_to/$token/?phone=" . urlencode($phone) . 
           "&name=" . urlencode($name);
    
    // Добавляем опциональные параметры, если они указаны
    if (!empty($info)) {
        $url .= "&info=" . urlencode($info);
    }
    if (!empty($email)) {
        $url .= "&email=" . urlencode($email);
    }
    if (!empty($web)) {
        $url .= "&web=" . urlencode($web);
    }
    
    // Выполняем запрос
    $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'])) {
                if ($json_response['result'] === 'insert') {
                    echo "Контакт успешно добавлен";
                } else if ($json_response['result'] === 'update') {
                    echo "Контакт успешно обновлен";
                }
                return true;
            } else {
                echo "Ошибка: " . $json_response['err'];
            }
        } else {
            echo "Не удалось обработать ответ от сервера";
        }
    } else {
        echo "Не удалось выполнить запрос к серверу";
    }
    
    return false;
}

// Используем функцию для добавления или обновления контакта
$token = "YOUR_TOKEN";
$phone = "79001234567";
$name = "Иван Петров";
$info = "Новый клиент";
$email = "ivan@example.com";
$web = "https://example.com";

addOrUpdateContact($token, $phone, $name, $info, $email, $web);