Этот метод переводит чат в статус завершён: в интерфейсе WAMM.chat он перестаёт отображаться среди открытых чатов и не попадает в выборку метода получения открытых чатов. Удобен для закрытия диалога из CRM или сценария после обработки обращения. Если чат уже завершён, API вернёт успех без повторного изменения (идемпотентно). Вернуть чат в работу можно методом установки статуса «открыт»; при новом входящем сообщении чат в программе также может снова стать открытым. Перед вызовом контакт должен существовать в WAMM.chat — при необходимости сначала используйте получение информации о контакте или добавление контакта.
Если в настройках организации включено снятие ответственного при завершении чата (chat_close_type=yes), вместе со статусом «завершён» сбрасывается ответственный за чат (last_user_id).
Поддерживаемые мессенджеры
Метод доступен для всех каналов связи, где чат (контакт) уже есть в WAMM.chat: WhatsApp, MAX Personal, Telegram Personal, Telegram Bot и другие подключённые каналы. Идентификатор контакта — номер в международном формате или ID чата / никнейм для Telegram и MAX (как в contact_get).
Пример запроса:
GET https://wamm.chat/api2/contact_complete/{token}/?phone={phone}или
GET https://wamm.chat/api2/contact_complete/{token}/{phone}Параметры запроса
| Параметр | Тип | Обязательный | Описание |
|---|---|---|---|
| token | string | Да | API-токен канала, полученный в настройках |
| phone | string | Да | Номер телефона в международном формате (например, 79001234567) или ID чата / никнейм для Telegram и MAX. Допускаются пробелы, скобки и дефисы — значение нормализуется по типу канала токена |
Ответ при успехе
{"err":0,"result":"success"}Если чат уже был завершён, ответ такой же — повторное завершение не является ошибкой.
Возможные ошибки
| Код ошибки | Описание |
|---|---|
| token fail | Ошибка в токене или канал не в статусе оплаты active |
| phone fail | Ошибка в номере телефона или идентификаторе чата (длина после нормализации 6–50 символов) |
| not found | Контакт (чат) не найден в WAMM.chat для данного аккаунта и канала |
Примеры использования
function completeChat($token, $phone) {
$url = 'https://wamm.chat/api2/contact_complete/'
. rawurlencode($token) . '/'
. rawurlencode($phone);
$response = file_get_contents($url);
if ($response === false) {
echo 'Не удалось выполнить запрос к серверу';
return;
}
$json = json_decode($response, true);
if (!is_array($json) || !array_key_exists('err', $json)) {
echo 'Не удалось обработать ответ от сервера';
return;
}
if ($json['err'] === 0 && ($json['result'] ?? '') === 'success') {
echo 'Чат успешно завершён';
return;
}
echo 'Ошибка: ' . (is_string($json['err']) ? $json['err'] : json_encode($json['err']));
}
$token = 'YOUR_TOKEN';
$phone = '79001234567';
completeChat($token, $phone);