[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fmembers\u002Flist":3,"docs-tabs-chats\u002Fmembers\u002Flist":6},{"content":4,"lastmod":5},"\n## Список участников\n\n`GET \u002Fv1\u002Fchats\u002F:dialogId\u002Fusers`\n\nВозвращает список участников диалога.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|---------|\n| `dialogId` (path) | string | да | — | Идентификатор диалога (`chatXXX`) или алиас `me` для личного диалога с собой |\n| `limit` (query) | number | нет | `50` | Количество участников (1–200) |\n| `offset` (query) | number | нет | `0` | Смещение от начала списка |\n| `lastId` (query) | number | нет | — | ID последнего полученного участника — альтернатива `offset` для постраничного обхода |\n| `skipExternal` (query) | boolean | нет | — | `true` — исключить внешних пользователей (тип `extranet`, `network`) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fchat123\u002Fusers?limit=50\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fchat123\u002Fusers?limit=50\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\"\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fchat123\u002Fusers?limit=50', {\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Участников:', data.length)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002Fchat123\u002Fusers?limit=50', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\nconsole.log('Участников:', data.length)\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | array | Массив участников |\n| `data[].id` | number | ID пользователя |\n| `data[].active` | boolean | Активен ли аккаунт |\n| `data[].name` | string | Полное имя |\n| `data[].firstName` | string | Имя |\n| `data[].lastName` | string | Фамилия |\n| `data[].workPosition` | string | Должность |\n| `data[].color` | string | Цвет аватара |\n| `data[].avatar` | string | URL аватара (пустая строка, если аватар не задан) |\n| `data[].gender` | string | Пол (`M` — мужской, `F` — женский, пустая строка — не указан) |\n| `data[].birthday` | string | Дата рождения (пустая строка, если не указана) |\n| `data[].extranet` | boolean | Внешний пользователь (тип `extranet`) |\n| `data[].network` | boolean | Пользователь Bitrix24 Network |\n| `data[].bot` | boolean | Бот |\n| `data[].connector` | boolean | Пользователь открытых линий (Контакт-центр) |\n| `data[].status` | string | Статус (`online`, `away`, `dnd`) |\n| `data[].idle` | boolean | Неактивен |\n| `data[].lastActivityDate` | string | Дата последней активности (ISO 8601) |\n| `data[].absent` | boolean | Отсутствует по рабочему календарю |\n| `data[].departments` | number[] | Список ID отделов |\n| `data[].type` | string | Тип пользователя (`user`, `bot`, `extranet`) |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 42,\n      \"active\": true,\n      \"name\": \"Иван Петров\",\n      \"firstName\": \"Иван\",\n      \"lastName\": \"Петров\",\n      \"workPosition\": \"Менеджер\",\n      \"color\": \"#df532d\",\n      \"avatar\": \"\",\n      \"gender\": \"M\",\n      \"birthday\": \"\",\n      \"extranet\": false,\n      \"network\": false,\n      \"bot\": false,\n      \"connector\": false,\n      \"status\": \"online\",\n      \"idle\": false,\n      \"lastActivityDate\": \"2026-06-05T09:40:32+03:00\",\n      \"absent\": false,\n      \"departments\": [1, 47],\n      \"type\": \"user\"\n    },\n    {\n      \"id\": 53,\n      \"active\": true,\n      \"name\": \"Мария Сидорова\",\n      \"firstName\": \"Мария\",\n      \"lastName\": \"Сидорова\",\n      \"workPosition\": \"Аналитик\",\n      \"color\": \"#83c3f7\",\n      \"avatar\": \"\",\n      \"gender\": \"F\",\n      \"birthday\": \"\",\n      \"extranet\": false,\n      \"network\": false,\n      \"bot\": false,\n      \"connector\": false,\n      \"status\": \"away\",\n      \"idle\": false,\n      \"lastActivityDate\": \"2026-06-04T18:15:00+03:00\",\n      \"absent\": false,\n      \"departments\": [1],\n      \"type\": \"user\"\n    }\n  ]\n}\n```\n\n## Пример ответа при ошибке\n\n422 — ошибка Битрикс24 (нет доступа к диалогу):\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"Access denied\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов Битрикс24 |\n| 422 | `BITRIX_ERROR` | Битрикс24 вернул ошибку — текст в поле `message` (например, нет доступа к диалогу) |\n| 502 | `BITRIX_UNAVAILABLE` | Битрикс24 недоступен или вернул ошибку сервера |\n| 502 | `ME_ALIAS_RESOLUTION_FAILED` | Не удалось разрешить алиас `me` — токен истёк или недоступен Битрикс24 |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Пагинация через `lastId`.** При последовательном обходе больших чатов передавайте `lastId` из последнего элемента предыдущего ответа вместо `offset`. Этот способ работает стабильнее при одновременных изменениях состава чата.\n\n**Алиас `me`** возвращает участников личного диалога с собой — это вы один. Для состава группового чата передавайте `chatXXX`.\n\n## Смотрите также\n\n- [Участники чата](\u002Fdocs\u002Fchats\u002Fmembers)\n- [Добавить участников](\u002Fdocs\u002Fchats\u002Fmembers\u002Fadd)\n- [Удалить участника](\u002Fdocs\u002Fchats\u002Fmembers\u002Fremove)\n- [Управление чатами](\u002Fdocs\u002Fchats\u002Fmanagement)\n- [Чаты](\u002Fdocs\u002Fchats)\n","2026-06-19",{}]