# CoPilot

Работайте с ИИ-ассистентом Битрикс24 в чатах: откройте черновой чат CoPilot, смените модель и роль ассистента, попросите переписать ответ и оцените его.

**Скоуп:** `im` | **Базовый URL:** `https://vibecode.bitrix24.tech/v1` | **Авторизация:** `X-Api-Key`

## Операции

- [Черновой чат CoPilot](./copilot/draft.md) — `POST /v1/chats/copilot/draft`
- [Сменить модель CoPilot](./copilot/engine.md) — `PUT /v1/chats/:dialogId/copilot/engine`
- [Сменить роль CoPilot](./copilot/role.md) — `PUT /v1/chats/:dialogId/copilot/role`
- [Переписать ответ CoPilot](./copilot/regenerate.md) — `POST /v1/chats/messages/:messageId/regenerate`
- [Оценить ответ](./copilot/vote.md) — `POST /v1/chats/messages/:messageId/vote`

## Известные особенности

**Все операции раздела изменяющие.** Ключ только для чтения получает `403 WRITE_BLOCKED_READONLY_KEY` до обращения к Битрикс24: смена модели и роли меняет чат, переписывание запускает генерацию, черновой чат создаётся при первом вызове, а любой вызов с чатом или сообщением может сделать владельца ключа участником чата, если чат разрешает автовступление.

**Чат CoPilot — отдельный тип чата.** Смена модели и роли работает только в чате CoPilot, в обычном чате Битрикс24 отвечает `WRONG_MESSAGE_TYPE`. Текущие модель и роль чата CoPilot приходят в блоке `data.copilot` [загрузки чата](/docs/chats/messages/load).

**ИИ доступен не на каждом портале.** Если CoPilot на портале выключен или недоступен по тарифу, Битрикс24 отказывает с кодом в `error.b24Code` — например, `DRAFT_CHAT_NOT_AVAILABLE` или `AI_NOT_AVAILABLE`.

## Смотрите также

- [Чаты и сообщения](/docs/chats)
- [Загрузка чата](/docs/chats/messages/load)
- [Расшифровать аудиофайл](/docs/chats/files/transcribe)