[{"data":1,"prerenderedAt":-1},["ShallowReactive",2],{"docs-chats\u002Fdiscovery\u002Fget":3,"docs-tabs-chats\u002Fdiscovery\u002Fget":6},{"content":4,"lastmod":5},"## Информация о диалоге\n\n`GET \u002Fv1\u002Fchats\u002F:dialogId`\n\nВозвращает данные о диалоге: название, тип, счётчик непрочитанных, настройки доступа и связанную CRM-сущность (если есть). Принимает числовой `dialogId` для личного чата или `chatN` для группового.\n\n## Параметры\n\n| Параметр | Тип | Обяз. | Описание |\n|----------|-----|:-----:|---------|\n| `dialogId` (path) | string | да | Идентификатор диалога. Числовой ID для личного чата (`1`), `chatN` для группового чата (`chat42`), или литерал `me` — текущий пользователь (см. [Обзор раздела](\u002Fdocs\u002Fchats)) |\n\n## Примеры\n\n### curl — личный ключ\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F1 \\\n  -H \"X-Api-Key: YOUR_API_KEY\"\n```\n\n### curl — OAuth-приложение\n\n```bash\ncurl https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F1 \\\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\u002F1', {\n  headers: { 'X-Api-Key': 'YOUR_API_KEY' },\n})\nconst { data } = await res.json()\nconsole.log('Диалог:', data.name, 'тип:', data.type)\n```\n\n### JavaScript — OAuth-приложение\n\n```javascript\nconst res = await fetch('https:\u002F\u002Fvibecode.bitrix24.tech\u002Fv1\u002Fchats\u002F1', {\n  headers: {\n    'X-Api-Key': 'YOUR_APP_KEY',\n    'Authorization': 'Bearer USER_SESSION_TOKEN',\n  },\n})\nconst { data } = await res.json()\n```\n\n## Поля ответа\n\nПоказаны основные поля. Ответ содержит полный объект диалога.\n\n| Поле | Тип | Описание |\n|------|-----|---------|\n| `success` | boolean | Всегда `true` при успехе |\n| `data` | object | Объект диалога |\n| `data.id` | number | Идентификатор диалога |\n| `data.name` | string | Название чата |\n| `data.description` | string | Описание чата |\n| `data.type` | string | Тип диалога: `private` — личный, `chat` — групповой, `open` — открытый канал |\n| `data.owner` | number | ID владельца. Источник: `GET \u002Fv1\u002Fusers` |\n| `data.color` | string | Цвет чата в формате `#rrggbb` |\n| `data.avatar` | string | URL аватара чата |\n| `data.counter` | number | Количество непрочитанных сообщений для текущего пользователя |\n| `data.userCounter` | number | Количество участников |\n| `data.messageCount` | number | Общее количество сообщений в чате |\n| `data.lastId` | number | ID последнего сообщения. Используется как курсор в `GET \u002Fv1\u002Fchats\u002F:dialogId\u002Fmessages` |\n| `data.dialogId` | string | Идентификатор диалога в формате, принятом Битрикс24 |\n| `data.dateCreate` | string | Дата создания (ISO 8601) |\n| `data.role` | string | Роль текущего пользователя: `owner`, `manager`, `member` |\n| `data.entityType` | string | Тип привязанной CRM-сущности (`CRM`, `FAVORITE`, и др.) или пустая строка |\n| `data.entityId` | string | Идентификатор привязанной CRM-сущности или пустая строка |\n| `data.restrictions` | object | Ограничения действий в чате (см. ниже) |\n| `data.permissions` | object | Права управления чатом (см. ниже) |\n| `data.restrictions.avatar` | boolean | Текущий пользователь может сменить аватар |\n| `data.restrictions.rename` | boolean | Текущий пользователь может переименовать чат |\n| `data.restrictions.extend` | boolean | Текущий пользователь может приглашать участников |\n| `data.restrictions.call` | boolean | Текущий пользователь может инициировать звонок |\n| `data.restrictions.leave` | boolean | Текущий пользователь может покинуть чат |\n| `data.restrictions.send` | boolean | Текущий пользователь может отправлять сообщения |\n| `data.permissions.manageUsersAdd` | string | Кто может добавлять участников: `owner`, `manager`, `member` |\n| `data.permissions.manageUsersDelete` | string | Кто может удалять участников |\n| `data.permissions.manageSettings` | string | Кто может изменять настройки чата |\n| `data.permissions.canPost` | string | Кто может отправлять сообщения |\n\n## Пример ответа\n\n```json\n{\n  \"success\": true,\n  \"data\": {\n    \"id\": 253,\n    \"name\": \"Обсуждение проекта\",\n    \"description\": \"\",\n    \"owner\": 1,\n    \"type\": \"private\",\n    \"color\": \"#4ba984\",\n    \"avatar\": \"\",\n    \"counter\": 0,\n    \"userCounter\": 1,\n    \"messageCount\": 1,\n    \"lastId\": 9357,\n    \"dialogId\": \"1\",\n    \"dateCreate\": \"2024-03-15T10:30:00+03:00\",\n    \"role\": \"owner\",\n    \"entityType\": \"\",\n    \"entityId\": \"\",\n    \"restrictions\": {\n      \"avatar\": true,\n      \"rename\": true,\n      \"extend\": true,\n      \"call\": true,\n      \"mute\": true,\n      \"leave\": true,\n      \"leaveOwner\": true,\n      \"send\": true,\n      \"userList\": true\n    },\n    \"permissions\": {\n      \"manageUsersAdd\": \"member\",\n      \"manageUsersDelete\": \"manager\",\n      \"manageUi\": \"member\",\n      \"manageSettings\": \"owner\",\n      \"manageMessages\": \"member\",\n      \"canPost\": \"member\"\n    }\n  }\n}\n```\n\n## Пример ответа при ошибке\n\n422 — диалог недоступен или не существует:\n\n```json\n{\n  \"success\": false,\n  \"error\": {\n    \"code\": \"BITRIX_ERROR\",\n    \"message\": \"You do not have access to the specified dialog\"\n  }\n}\n```\n\n## Ошибки\n\n| HTTP | Код | Описание |\n|------|-----|---------|\n| 422 | `BITRIX_ERROR` | Диалог недоступен или не существует — Битрикс24 вернул ошибку доступа |\n| 502 | `ME_ALIAS_RESOLUTION_FAILED` | Не удалось определить ID текущего пользователя при использовании алиаса `me` |\n| 403 | `SCOPE_DENIED` | API-ключ не имеет скоупа `im` |\n| 401 | `TOKEN_MISSING` | API-ключ не имеет настроенных токенов |\n\nПолный список общих ошибок API — [Ошибки](\u002Fdocs\u002Ferrors).\n\n## Известные особенности\n\n- Числовой `dialogId` открывает личный чат с пользователем (или диалог «Избранное» при `dialogId` равном ID текущего пользователя). Групповой чат адресуется строкой `chatN`, где `N` — числовой ID группы.\n- Недоступный или несуществующий диалог возвращает `422 BITRIX_ERROR`, а не `404`. Это наблюдаемое поведение эндпоинта.\n\n## Смотрите также\n\n- [Поиск чатов](\u002Fdocs\u002Fchats\u002Fdiscovery)\n- [Найти чат CRM-сущности](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Ffind)\n- [Последние диалоги](\u002Fdocs\u002Fchats\u002Fdiscovery\u002Frecent)\n- [Сообщения](\u002Fdocs\u002Fchats\u002Fmessages\u002Flist)\n","2026-06-19",{}]