Чат задачи

GET /v1/tasks/:taskId/chat/messages

Читает ленту чата задачи — новые сообщения первыми. У каждой задачи в Битрикс24 есть групповой чат, и эндпоинт сам определяет чат по ID задачи — знать ID чата не нужно. Типичный сценарий — выгрузка финальных сообщений по закрытой задаче.

Общий параметр filter этим эндпоинтом не применяется. По умолчанию API сохраняет прежний ответ HTTP 200 и прежние данные, добавляет заголовок Warning: 299 - "filter is not supported on this endpoint and was ignored", а сервер фиксирует использование неподдерживаемого фильтра в журнале.

Параметры

Примеры

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

curl 'https://vibecode.bitrix24.tech/v1/tasks/289/chat/messages?limit=50' \
  -H 'X-Api-Key: YOUR_API_KEY'

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

curl 'https://vibecode.bitrix24.tech/v1/tasks/289/chat/messages?limit=50' \
  -H 'X-Api-Key: YOUR_APP_KEY' \
  -H 'Authorization: Bearer USER_SESSION_TOKEN'

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

const response = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289/chat/messages?limit=50', {
  headers: {
    'X-Api-Key': 'YOUR_API_KEY',
  },
})
const result = await response.json()
console.log(result.data.messages)

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

const response = await fetch('https://vibecode.bitrix24.tech/v1/tasks/289/chat/messages?limit=50', {
  headers: {
    'X-Api-Key': 'YOUR_APP_KEY',
    'Authorization': 'Bearer USER_SESSION_TOKEN',
  },
})
const result = await response.json()
console.log(result.data.messages)

Поля ответа

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

{
  "success": true,
  "data": {
    "messages": [
      {
        "id": 43247,
        "authorId": 0,
        "text": "[USER=1]Иван Петров[/USER] начал выполнять задачу",
        "createdAt": "2026-10-19T18:20:03+03:00",
        "isSystem": true
      },
      {
        "id": 43241,
        "authorId": 0,
        "text": "[USER=1]Иван Петров[/USER] создал [URL=/company/personal/user/1/tasks/task/view/289/]задачу[/URL]",
        "createdAt": "2026-10-19T18:20:00+03:00",
        "isSystem": true
      }
    ],
    "hasNextPage": false
  }
}

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

404 — у задачи нет чата или задачи не существует:

{
  "success": false,
  "error": {
    "code": "TASK_CHAT_NOT_FOUND",
    "message": "Task 289 has no chat yet (B24 allocates the chat lazily) or the task does not exist."
  }
}

Ошибки

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

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

• Нужен скоуп im на стороне Битрикс24. Эндпоинт читает чат через im.*-методы Битрикс24 — вебхук или OAuth-грант ключа должен включать скоуп im помимо task, иначе портал вернёт insufficient_scope.
• Доступ — по членству в чате. Битрикс24 отдаёт сообщения, только если пользователь, от имени которого работает ключ, — участник чата задачи (постановщик, исполнитель, наблюдатель) или администратор портала. Ключ только для чтения читает ленту другим способом, который не делает пользователя участником чата, поэтому его страница — не больше 50 сообщений при любом limit. hasNextPage у такого ключа означает, что страница заполнена целиком: если на последней странице ровно столько сообщений, сколько на неё помещается, придёт true, а следующий запрос вернёт пустую страницу с false. Листайте курсором lastId до hasNextPage: false. До 200 сообщений на страницу отдаётся ключу с правом записи, см. права доступа.
• Сообщения идут от новых к старым. Первый элемент — самое свежее сообщение. Пагинация курсором lastId уходит вглубь истории.
• 404, если чата ещё нет. Битрикс24 создаёт чат задачи не сразу — у задачи без единого сообщения чата может не быть (TASK_CHAT_NOT_FOUND).
• Старые порталы. На порталах без современной im.v2-поверхности API прозрачно переключается на устаревший метод: страница там ограничена 50 сообщениями, а hasNextPage вычисляется по заполненности страницы.
• Комментарии и чат. GET /v1/tasks/:taskId/comments возвращает только пользовательские комментарии. Этот эндпоинт — сырую ленту чата целиком, включая системные сообщения.

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

• Задачи
• Комментарии задач
• Scrum