[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-bots\u002Fchats\u002Fuser-list":3,"docs-tabs-bots\u002Fchats\u002Fuser-list":6},{"content":4,"lastmod":5},"\n## Список участников\n\n`GET \u002Fv1\u002Fbots\u002F:botId\u002Fchats\u002F:dialogId\u002Fusers`\n\nВозвращает список участников чата. Бот должен быть участником чата.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | По умолч. | Описание |\n|----------|-----|:-----:|-----------|---------|\n| `botId` (path) | number | да | — | ID бота |\n| `dialogId` (path) | string | да | — | ID диалога (`chatXXX`) |\n| `limit` (query) | number | нет | `50` | Количество записей (1-200) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots\u002F42\u002Fchats\u002Fchat456\u002Fusers?limit=100\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fbots\u002F42\u002Fchats\u002Fchat456\u002Fusers?limit=100\" \\\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\u002Fbots\u002F42\u002Fchats\u002Fchat456\u002Fusers?limit=100', {\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\u002Fbots\u002F42\u002Fchats\u002Fchat456\u002Fusers?limit=100', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `data` | array | Массив участников |\n| `data[].id` | number | ID пользователя |\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 | Пол |\n| `data[].active` | boolean | Активен ли аккаунт |\n| `data[].bot` | boolean | Является ли ботом |\n| `data[].status` | string | Статус пользователя |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": [\n    {\n      \"id\": 1,\n      \"name\": \"Иван Петров\",\n      \"firstName\": \"Иван\",\n      \"lastName\": \"Петров\",\n      \"workPosition\": \"Менеджер\",\n      \"color\": \"AZURE\",\n      \"avatar\": \"\",\n      \"gender\": \"M\",\n      \"active\": true,\n      \"bot\": false,\n      \"status\": \"online\"\n    },\n    {\n      \"id\": 42,\n      \"name\": \"Техподдержка\",\n      \"firstName\": \"Техподдержка\",\n      \"lastName\": \"\",\n      \"workPosition\": \"Помощник\",\n      \"color\": \"AZURE\",\n      \"avatar\": \"\",\n      \"gender\": \"\",\n      \"active\": true,\n      \"bot\": true,\n      \"status\": \"online\"\n    }\n  ]\n}\n```\n\n## Пример ответа при ошибке\n\n502 — бот не является участником чата:\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| 400 | `INVALID_BOT_ID` | `botId` не является числом |\n| 404 | `BOT_NOT_FOUND` | Бот с таким ID не найден |\n| 403 | `BOT_ACCESS_DENIED` | Бот принадлежит другому API-ключу |\n| 502 | `BITRIX_ERROR` | Ошибка Битрикс24 (текст ошибки в `message`) |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `imbot` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Смотрите также\n\n- [Добавить участников](\u002Fdocs\u002Fbots\u002Fchats\u002Fuser-add)\n- [Удалить участника](\u002Fdocs\u002Fbots\u002Fchats\u002Fuser-delete)\n- [Добавить менеджеров](\u002Fdocs\u002Fbots\u002Fchats\u002Fmanager-add)\n- [Бот-платформа](\u002Fdocs\u002Fbots)\n- [Лимиты и оптимизация](\u002Fdocs\u002Foptimization)\n","2026-06-16",{}]