Получить пользователей

Получает информацию о пользователях для диалога

Параметры

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

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

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

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

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

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

подсказка

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

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

    URL                 = "https://b24-ar17wx.bitrix24.by/rest/1/av5...";
    МассивПользователей = Новый Массив;

    МассивПользователей.Добавить(1);
    МассивПользователей.Добавить(10);

    Результат = OPI_Bitrix24.ПолучитьПользователей(URL, МассивПользователей);

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

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

Bash

    oint bitrix24 ПолучитьПользователей \
      --url "b24-ar17wx.bitrix24.by" \
      --users 10 \
      --token "***"

CMD/Bat

    oint bitrix24 ПолучитьПользователей ^
      --url "b24-ar17wx.bitrix24.by" ^
      --users 10 ^
      --token "***"

Результат

{
 "result": {
  "10": {
   "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"
  }
 },
 "time": {
  "start": 1779818087,
  "finish": 1779818087.11116,
  "duration": 0.111155033111572,
  "processing": 0,
  "date_start": "2026-05-26T17:54:47+00:00",
  "date_finish": "2026-05-26T17:54:47+00:00",
  "operating_reset_at": 1779818687,
  "operating": 0
 }
}