#Получить сообщение

GET /v1/bots/:botId/messages/:messageId

Возвращает сообщение по его ID. Доступно только для ботов типа personal и supervisor.

#Параметры

Параметр Тип Обяз. Описание
botId (path) number да ID бота
messageId (path) number да ID сообщения

#Примеры

#curl — личный ключ

Terminal 
curl https://vibecode.bitrix24.tech/v1/bots/42/messages/1501 \
  -H "X-Api-Key: YOUR_API_KEY"

#curl — OAuth-приложение

Terminal 
curl https://vibecode.bitrix24.tech/v1/bots/42/messages/1501 \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN"

#JavaScript — личный ключ

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/42/messages/1501', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})

const { success, data } = await res.json()
console.log('Сообщение:', data.text)

#JavaScript — OAuth-приложение

javascript 
const res = await fetch('https://vibecode.bitrix24.tech/v1/bots/42/messages/1501', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})

const { success, data } = await res.json()

#Поля ответа

Поле Тип Описание
id number ID сообщения
chatId number ID чата
authorId number ID автора
date string Дата отправки (ISO 8601)
text string Текст сообщения
isSystem boolean Системное сообщение
params object Дополнительные параметры сообщения

#Пример ответа

JSON 
{
  "success": true,
  "data": {
    "id": 1501,
    "chatId": 123,
    "authorId": 1,
    "date": "2026-03-31T10:00:00+03:00",
    "text": "Привет, бот!",
    "isSystem": false,
    "params": {}
  }
}

#Пример ответа при ошибке

502 — бот не имеет доступа к сообщению:

JSON 
{
  "success": false,
  "error": {
    "code": "BITRIX_ERROR",
    "message": "Access denied"
  }
}

#Ошибки

HTTP Код Описание
400 INVALID_BOT_ID botId не является числом
404 BOT_NOT_FOUND Бот с таким ID не найден
403 BOT_ACCESS_DENIED Бот принадлежит другому API-ключу
502 BITRIX_ERROR Ошибка Bitrix24 (бот не имеет доступа к сообщению)
403 SCOPE_DENIED API-ключ не имеет скоупа imbot
401 TOKEN_MISSING API-ключ не имеет настроенных токенов

Полный список общих ошибок API — Ошибки.

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

Только personal и supervisor: метод доступен только для ботов типа personal и supervisor. Для стандартных ботов (bot) Bitrix24 вернёт ошибку доступа.

Типичный сценарий: бот получил событие с replyId и хочет прочитать исходное сообщение, на которое ответил пользователь.

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