Получить список пользователей диалога

Получает список участников диалога

Параметры

Функция ПолучитьСписокПользователейДиалога(Знач URL, Знач IDЧата, Знач Токен = "") Экспорт

Параметр	CLI опция	Тип	Обяз.	Назначение
URL	--url	Строка	✔	URL внешнего вебхука или адрес Bitrix24 при использовании токена
IDЧата	--chat	Строка, Число	✔	ID чата (chatXXX) или пользователя (XXX) для диалога
Токен	--token	Строка	✖	Токен авторизации, если используется не вебхук

Возвращаемое значение

Соответствие Из КлючИЗначение - сериализованный JSON ответа от Bitrix24

Расширенный вызов ?

Параметр	Описание
proxy	ИнтернетПрокси или структура полей Протокол, Сервер, Порт, Пользователь, Пароль, ИспользоватьАутентификациюОС
timeout	Таймаут выполнения запроса
adv_response	Оформляет ответ в виде полной структуры HTTP-ответа с полями code, body и headers
retries	Число попыток отправки HTTP-запроса при коде 5** или внутренних ошибках клиента
dontwait	Создает фоновое задание и возвращает его данные (только для 1С и OneScript)

подсказка

Метод в документации API: im.dialog.users.list

Пример использования для 1С:Предприятие/OneScript

    URL    = "https://b24-ar17wx.bitrix24.by/rest/1/av5...";
    IDЧата = "3390";

    OPI_ПреобразованиеТипов.ПолучитьСтроку(IDЧата);

    СтрокаЧата = "chat" + IDЧата;

    Результат = OPI_Bitrix24.ПолучитьСписокПользователейДиалога(URL, СтрокаЧата);

    URL            = "b24-ar17wx.bitrix24.by";
    Токен          = "a5b00469006e9f06006b12e400000001000...";
    IDПользователя = 10;

    Результат = OPI_Bitrix24.ПолучитьСписокПользователейДиалога(URL, IDПользователя, Токен);

Bash

    oint bitrix24 ПолучитьСписокПользователейДиалога \
      --url "b24-ar17wx.bitrix24.by" \
      --chat "***" \
      --token "***"

CMD/Bat

    oint bitrix24 ПолучитьСписокПользователейДиалога ^
      --url "b24-ar17wx.bitrix24.by" ^
      --chat "***" ^
      --token "***"

Результат

{
 "result": [
  {
   "id": 10,
   "active": true,
   "name": "Techno Pizza",
   "first_name": "Techno",
   "last_name": "Pizza",
   "work_position": null,
   "color": "#ab7761",
   "avatar": "",
   "avatar_hr": "https://b24-ar17wx.bitrix24.by/bitrix/js/im/images/blank.gif",
   "gender": "M",
   "birthday": "",
   "extranet": false,
   "network": false,
   "bot": false,
   "connector": false,
   "external_auth_id": "socservices",
   "status": "online",
   "idle": false,
   "last_activity_date": "2024-07-13T18:36:23+00:00",
   "mobile_last_date": false,
   "desktop_last_date": false,
   "absent": false,
   "departments": [
    1,
    640
   ],
   "phones": "***",
   "bot_data": null,
   "type": "user",
   "website": "",
   "email": "iscript13@gmail.com"
  },
  {
   "id": 1,
   "active": true,
   "name": "Антон Титовец",
   "first_name": "Антон",
   "last_name": "Титовец",
   "work_position": null,
   "color": "#df532d",
   "avatar": "https://cdn-ru.bitrix24.by/b28528874/resize_cache/30/ff58db95aecdfa09ae61b51b5fd8f63f/main/d7e/d7e99...",
   "avatar_hr": "https://cdn-ru.bitrix24.by/b28528874/resize_cache/30/ff58db95aecdfa09ae61b51b5fd8f63f/main/d7e/d7e99...",
   "gender": "M",
   "birthday": "",
   "extranet": false,
   "network": false,
   "bot": false,
   "connector": false,
   "external_auth_id": "socservices",
   "status": "online",
   "idle": false,
   "last_activity_date": "2026-05-17T20:27:04+00:00",
   "mobile_last_date": false,
   "desktop_last_date": false,
   "absent": false,
   "departments": [
    1,
    638
   ],
   "phones": "***",
   "bot_data": null,
   "type": "user",
   "website": "",
   "email": "no-reply@bitrix24.com"
  }
 ],
 "total": 2,
 "time": {
  "start": 1779818161,
  "finish": 1779818161.1535,
  "duration": 0.153505086898804,
  "processing": 0,
  "date_start": "2026-05-26T17:56:01+00:00",
  "date_finish": "2026-05-26T17:56:01+00:00",
  "operating_reset_at": 1779818761,
  "operating": 0
 }
}