Этот метод позволяет получить список открытых (активных) чатов конкретного пользователя по его user_id. Удобен для мониторинга загруженности операторов, анализа распределения чатов в команде и для автоматического перераспределения нагрузки между сотрудниками. Также может использоваться для аналитики работы службы поддержки и отдела продаж. Если у вас несколько каналов, то независимо, от канала с чьим токеном делается запрос - выводится информация по всем пользователям.

Вам может понадобиться запрос для получения списка пользователей и их user_id.

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

GET https://wamm.chat/api2/user_chats/{token}/{user_id}

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

Параметр	Тип	Обязательный	Описание
token	string	Да	API-токен, полученный в настройках
user_id	integer	Да	ID пользователя, чьи чаты нужно получить

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

{
    "err": 0,
    "data": [
        {
            "chat_id": "1xxx",
            "chat_name": "Name chat",
            "phone": "7xxx",
            "avatar": "https...jpg",
            "user_id": "8xxx",
            "date_msg": "2024-10-09 10:28:45"
        },
        ...
    ]
}

Описание полей ответа

Поле	Описание
chat_id	Идентификатор чата
chat_name	Имя чата или контакта
phone	Номер телефона или ID чата
avatar	URL аватара
user_id	ID пользователя, ответственного за чат
date_msg	Дата и время последнего сообщения в чате

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

Код ошибки	Описание
token fail	Ошибка в токене
acc not authorized	Подключение не авторизовано
user_id fail	Не найден пользователь по указанному user_id
fail get data	Не найдены чаты пользователя

curl -X GET "https://wamm.chat/api2/user_chats/YOUR_TOKEN/123"

function getUserChats($token, $userId) {
    // Подготавливаем URL запроса
    $url = "https://wamm.chat/api2/user_chats/$token/$userId";
    
    // Выполняем запрос
    $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['data'])) {
                echo "Список чатов пользователя успешно получен. Количество чатов: " . count($json_response['data']);
                return $json_response['data'];
            } else {
                echo "Ошибка: " . $json_response['err'];
            }
        } else {
            echo "Не удалось обработать ответ от сервера";
        }
    } else {
        echo "Не удалось выполнить запрос к серверу";
    }
    
    return [];
}

// Используем функцию для получения чатов пользователя
$token = "YOUR_TOKEN";
$userId = 123;

$userChats = getUserChats($token, $userId);
foreach ($userChats as $chat) {
    echo "Чат: " . $chat['chat_name'] . ", Последнее сообщение: " . $chat['date_msg'] . "\n";
}