# Сообщения

Отправляйте сообщения от имени бота, редактируйте и удаляйте их, читайте отдельные сообщения и отмечайте переписку прочитанной.

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

## Операции

- [Отправить сообщение](./messages/send.md) — `POST /v1/bots/:botId/messages`
- [Обновить сообщение](./messages/update.md) — `PATCH /v1/bots/:botId/messages/:messageId`
- [Удалить сообщение](./messages/delete.md) — `DELETE /v1/bots/:botId/messages/:messageId`
- [Прочитать сообщения](./messages/read.md) — `POST /v1/bots/:botId/chats/:dialogId/read`
- [Получить сообщение](./messages/get.md) — `GET /v1/bots/:botId/messages/:messageId`
- [Контекст сообщения](./messages/context.md) — `GET /v1/bots/:botId/messages/:messageId/context`

## Ограничение по типу бота

Получить сообщение (`GET /v1/bots/:botId/messages/:messageId`) и его контекст (`GET /v1/bots/:botId/messages/:messageId/context`) доступны только ботам с `type` ∈ {`personal`, `supervisor`}. Для остальных типов — `bot` и `openline` — ответ 422 с кодом `BITRIX_ERROR`, в поле `error.b24Code` приходит `BOT_TYPE_NOT_ALLOWED`. Тип задаётся при регистрации через [POST /v1/bots](/docs/bots/management/create) и не меняется без перерегистрации.