Добавить комментарий

POST /v1/feedback/:id/comments

Добавляет комментарий к обращению. К комментарию можно приложить вложения.

Параметры

Поля запроса (body)

Примеры

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

curl -X POST https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments \
  -H "X-Api-Key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Воспроизвёл на пустом filter, приложил лог запроса." }'

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

curl -X POST https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments \
  -H "X-Api-Key: YOUR_APP_KEY" \
  -H "Authorization: Bearer USER_SESSION_TOKEN" \
  -H "Content-Type: application/json" \
  -d '{ "body": "Воспроизвёл на пустом filter, приложил лог запроса." }'

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

const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments',
  {
    method: 'POST',
    headers: { 'X-Api-Key': 'YOUR_API_KEY', 'Content-Type': 'application/json' },
    body: JSON.stringify({ body: 'Воспроизвёл на пустом filter, приложил лог запроса.' }),
  },
)
const { data } = await res.json()

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

const res = await fetch(
  'https://vibecode.bitrix24.tech/v1/feedback/a1b2c3d4-1111-2222-3333-444455556666/comments',
  {
    method: 'POST',
    headers: {
      'X-Api-Key': 'YOUR_APP_KEY',
      'Authorization': 'Bearer USER_SESSION_TOKEN',
      'Content-Type': 'application/json',
    },
    body: JSON.stringify({ body: 'Воспроизвёл на пустом filter, приложил лог запроса.' }),
  },
)
const { data } = await res.json()

Поля ответа

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

{
  "success": true,
  "data": {
    "id": "61ae2a00-a7ac-416f-85cc-99873c767d3b",
    "authorType": "USER",
    "body": "Воспроизвёл на пустом filter, приложил лог запроса.",
    "createdAt": "2026-04-19T11:00:00.000Z",
    "feedbackStatus": "NEW",
    "previousStatus": "NEW"
  }
}

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

403 — комментарий без скоупа vibe:feedback:

{
  "success": false,
  "error": {
    "code": "FEEDBACK_SCOPE_REQUIRED",
    "message": "Requires management key or vibe:feedback scope"
  }
}

Ошибки

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

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

Комментарий к чужому обращению меняет статус. Такой комментарий записывается как ответ платформы (authorType: PLATFORM) и по умолчанию переводит обращение в AWAITING_USER. Другой статус задаётся полем status в теле — значения как в обновлении. Поля feedbackStatus и previousStatus в ответе показывают статус после и до комментария.

Автор комментирует своё обращение без скоупа. Если запрос идёт тем же ключом, которым создано обращение, комментарий проходит без скоупа vibe:feedback: проверка на автора выполняется до проверки скоупа. Скоуп нужен только для комментариев к чужим обращениям.

Автором считается человек, а не ключ. Обращение, созданное другим вашим ключом или заведённое из кабинета, для вас тоже своё: комментарий записывается как сообщение пользователя (authorType: USER), поле resolution не переписывается, а переданный status игнорируется — статус меняют через обновление. Одно условие: такому ключу нужен скоуп vibe:feedback — без скоупа своим считается только тот ключ, которым обращение и создано. Ключ приложения и управляющий ключ под это правило не подпадают вовсе: у них владелец ключа и тот, кто пишет, — разные лица.

Комментарий автора возвращает решённое обращение в работу. Если обращение в статусе RESOLVED, ваш комментарий переводит его в NEEDS_REVIEW и снимает отметку о закрытии (resolvedAt, resolvedBy). Текст решения при этом сохраняется. Статусы ARCHIVED и WITHDRAWN остаются закрытыми — на них по-прежнему приходит 409 FEEDBACK_CLOSED.

Комментарий автора меняет статус только там, где ждали ответа. Из AWAITING_USER обращение переходит в NEEDS_REVIEW. На остальных открытых статусах — NEW, REVIEWING, NEEDS_REVIEW — статус сохраняется: разбор и так за командой. Поле updatedAt обновляется в любом случае, поэтому очередь, отсортированная по нему, покажет свежий ответ независимо от статуса.

Поле resolution заполняет только закрывающий комментарий. Комментарий с целевым статусом RESOLVED или ARCHIVED записывает своё тело в resolution. При любом другом статусе поле не меняется. Текст такого комментария всё равно доходит до автора письмом и виден в ленте.

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

• Получить обращение
• Обновить обращение
• Загрузить вложение
• Обратная связь