Как удалить теги для чата

Этот метод удаляет один тег у указанного чата (контакта) в WAMM.chat. Удобен для синхронизации с CRM, когда статус сделки или сегмент клиента изменился и метку в мессенджере нужно снять. Теги у чата перечислены в поле tags метода Получение инфо о контакте (чате); добавление выполняется через Теги для чата — добавить. Если указанного тега у чата уже нет, API всё равно вернёт успех — повторный вызов безопасен.

Контакт должен существовать в базе WAMM.chat. Идентификатор чата — номер в международном формате или ID чата / никнейм для Telegram и MAX (как в других contact-методах).

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

Метод доступен для чатов во всех каналах, где контакт заведён в WAMM.chat: WhatsApp, MAX Personal, Telegram Personal, Telegram Bot и другие подключённые каналы с API.

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

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

Название тега передаётся в URL (третий сегмент пути) и кодируется функцией urlencode, например VIP%20Client для тега «VIP Client».

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

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

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

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

Успех возвращается и при фактическом удалении тега, и если тег у чата уже отсутствовал.

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

Код ошибки	Описание
token fail	Ошибка в токене или канал не активен по тарифу
phone fail	Ошибка в номере телефона или идентификаторе чата
not found	Чат (контакт) не найден в WAMM.chat
tag not entry	Пустое название тега после обработки запроса

Примеры использования

function deleteTagFromChat($token, $phone, $tagName) {
    $url = "https://wamm.chat/api2/contact_tag_delete/$token/$phone/" . rawurlencode($tagName);

    $response = file_get_contents($url);

    if ($response === false) {
        echo "Не удалось выполнить запрос к серверу";
        return;
    }

    $json = json_decode($response, true);

    if (!isset($json['err'])) {
        echo "Не удалось обработать ответ от сервера";
        return;
    }

    if ($json['err'] === 0 && ($json['result'] ?? '') === 'success') {
        echo "Тег успешно удалён из чата (или уже отсутствовал)";
    } else {
        echo "Ошибка: " . $json['err'];
    }
}

$token = "YOUR_TOKEN";
$phone = "79001234567";
$tagName = "VIP Client";

deleteTagFromChat($token, $phone, $tagName);