[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fmembers\u002Fadd":3,"docs-tabs-chats\u002Fmembers\u002Fadd":6},{"content":4,"lastmod":5},"\n## Добавить участников\n\n`POST \u002Fv1\u002Fchats\u002F:chatId\u002Fusers`\n\nДобавляет одного или нескольких пользователей в групповой чат.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `chatId` (path) | number | да | Числовой ID чата (без префикса `chat`) |\n\n## Поля запроса (body)\n\n| Поле | Тип | Обяз. | Описание |\n|------|-----|:-----:|---------|\n| `users` | number[] | да | Массив ID пользователей для добавления |\n| `hideHistory` | boolean | нет | `true` — новые участники не видят историю до вступления, по умолчанию `true`. `false` — история открыта с момента создания чата |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F123\u002Fusers\" \\\n  -H \"X-Api-Key: YOUR_API_KEY\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"users\": [42, 53] }'\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl -X POST \"https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F123\u002Fusers\" \\\n  -H \"X-Api-Key: YOUR_APP_KEY\" \\\n  -H \"Authorization: Bearer USER_SESSION_TOKEN\" \\\n  -H \"Content-Type: application\u002Fjson\" \\\n  -d '{ \"users\": [42, 53] }'\n```\n\n### JavaScript — личный ключ\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F123\u002Fusers', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_API_KEY',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({ users: [42, 53] }),\n})\n\nconst { success, data } = await res.json()\nconsole.log('Добавлено:', data)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F123\u002Fusers', {\n  method: 'POST',\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n    'Content-Type': 'application\u002Fjson',\n  },\n  body: JSON.stringify({ users: [42, 53] }),\n})\n\nconst { success, data } = await res.json()\n```\n\n## Поля ответа\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | boolean | `true` при успешном добавлении |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": true\n}\n```\n\n## Пример ответа при ошибке\n\n403 — API-ключ не имеет скоупа `im`:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"SCOPE_DENIED\",\n    \"message\": \"This endpoint requires 'im' scope\"\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\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n**Несуществующие пользователи пропускаются.** Если в массиве `users` есть ID несуществующих или неактивных пользователей, они игнорируются без ошибки. Операция для остальных участников выполняется.\n\n**По умолчанию история скрыта.** При добавлении без явного `hideHistory` новые участники не видят сообщения, отправленные до их вступления. Чтобы открыть доступ к истории с момента создания чата, передайте `hideHistory: false`.\n\n## Смотрите также\n\n- [Участники чата](\u002Fdocs\u002Fchats\u002Fmembers)\n- [Список участников](\u002Fdocs\u002Fchats\u002Fmembers\u002Flist)\n- [Удалить участника](\u002Fdocs\u002Fchats\u002Fmembers\u002Fremove)\n- [Управление чатами](\u002Fdocs\u002Fchats\u002Fmanagement)\n- [Чаты](\u002Fdocs\u002Fchats)\n","2026-06-23",{}]