Комментарии

Эндпойнты комментариев доступны только с bot token и только для задач в формах, к которым у бота есть доступ.

Получить комментарии задачи

GET /bot/tasks/{task_id}/comments?limit=50&cursor=<next_cursor>
Authorization: Bearer <BOT_TOKEN>

Комментарии возвращаются от новых к старым. Используется cursor pagination без загрузки всей истории.

Параметр	Обязательный	Описание
limit	Нет	Количество комментариев. По умолчанию и максимум — 50.
cursor	Нет	Значение pagination.next_cursor из предыдущего ответа. Максимум 512 символов.

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

{
  "success": true,
  "error_message": null,
  "data": {
    "comments": [
      {
        "id": 501,
        "date": "2026-08-12T10:30:00+00:00",
        "task_id": 123,
        "author_id": 17,
        "value": "Проверьте эту задачу",
        "parent_comment_id": null,
        "files": [],
        "is_system": false,
        "system_data": []
      }
    ],
    "pagination": {
      "limit": 50,
      "returned_count": 1,
      "has_more": false,
      "next_cursor": null
    }
  }
}

Если has_more равен true, передайте next_cursor без изменений в следующем запросе.

Создать комментарий

POST /bot/tasks/{task_id}/comments
Authorization: Bearer <BOT_TOKEN>
Content-Type: application/json

{
  "value": "Проверьте эту задачу",
  "parent_comment_id": null,
  "recipients": [12, 34]
}

Поле	Обязательное	Описание
value	Да	Непустой текст до 10 000 символов.
parent_comment_id	Нет	ID родительского комментария из этой же задачи.
recipients	Нет	ID пользователей для уведомления. Максимум 50 уникальных пользователей с доступом к форме.

Максимальный размер JSON body — 16 KB.

Уведомление получают ответственный задачи и пользователи из recipients. Для них создаются inbox notifications и jobs в очереди внешних каналов. Дубликаты удаляются, сам бот исключается.

Комментарий, notifications и queue jobs сохраняются одной транзакцией.

Rate limits

• получение комментариев: 60/min
• создание комментариев: 20/min

Лимит считается суммарно по всем задачам отдельно для bot user, IP и операции. При превышении API возвращает 429.

Ошибки

Статус	Причина
400	Невалидный cursor или родительский комментарий относится к другой задаче.
401	Bot token отсутствует, невалиден или истёк.
403	Нет доступа к форме у бота или получателя.
404	Задача не найдена.
413	JSON body превышает 16 KB.
422	Ошибка валидации request body.
429	Превышен rate limit.