Для AI-агентов: markdown этой страницы — /docs-content/changelog/2026-11-18.md индекс документации — /llms.txt

Изменения API: 18 ноября 2026

← Журнал изменений · Ноябрь 2026

NEW-1118-1: список шаблонов бизнес-процессов читается личным ключом

GET /v1/bizproc-templates, POST /v1/bizproc-templates/search и GET /v1/bizproc-templates/fields теперь принимают API-ключ vibe_api_…, а не только ключ OAuth-приложения. Список содержит шаблоны, доступные владельцу ключа в Битрикс24. Действие list в пакетных вызовах POST /v1/batch и POST /v1/bizproc-templates/batch тоже работает с API-ключом. Загрузка, обновление и удаление шаблонов по-прежнему требуют ключа OAuth-приложения и отвечают API-ключу 403 OAUTH_REQUIRED.

В GET /v1/me для API-ключа поле api.entityApi.oauthOnlyEntities больше не содержит bizproc-templates, а новое поле api.entityApi.oauthOnlyOperations перечисляет операции, которые требуют ключа OAuth-приложения: {"bizproc-templates": ["create", "update", "delete"]}. В GET /v1/guide сущность bizproc-templates видна API-ключу, её поле oauthAppKeyRequiredFor называет те же операции.

FIX-1118-2: команды сервера раньше сообщают о потере соединения

Было

При переподключении агента ожидание ответа команды могло продолжаться до полного тайм-аута, хотя исходное соединение уже закрылось.

Стало

При переподключении агента запрос выполняющейся на сервере shell-команды сразу завершается с ошибкой соединения, без ожидания полного тайм-аута. Команда не отправляется повторно. Передача файлов на сервер (загрузка архива, запись .env) по-прежнему ждёт ответа до своего тайм-аута и может получить его по новому соединению агента; перечисленные ниже методы затронуты в тех шагах, где они выполняют shell-команды на сервере. Публикация сохраняет существующую проверку результата: подтверждает успех или сообщает о прерывании.

Если при синхронизации ключа (syncServerEnv: true) шлюз обрывает уже выполняющуюся на сервере команду, envSync.status — failed: окружение могло успеть измениться, проверьте сервер. Остальные исходы синхронизации ключа не изменились.

Влияние на интеграторов

При потере ответа проверьте результат операции перед повторным запуском изменяющей команды.

Затронутые эндпоинты:

NEW-1118-3: Инструкции обслуживания агента в ответе по коду

При получении ключа обслуживания агента по коду ответ GET /v1/me в состояниях issued и claimed содержит блок servicing: адреса запросов к серверу, сведения о среде агента и правила работы. Сначала агент только читает состояние и логи; любое изменение требует явного согласия владельца.

NEW-1118-4: список и чтение комментариев задачи называют хранилище строки

GET /v1/tasks/:taskId/comments теперь читает оба хранилища — чат задачи и блок комментариев старой карточки — и сводит их в один ряд по дате создания, поэтому комментарии, оставленные до перехода портала на новую карточку, снова попадают в выдачу. Каждая строка списка несёт поле source: chat — комментарий из чата, legacy — запись блока старой карточки. Номера комментариев в двух хранилищах независимы и пересекаются по числу, поэтому id значит комментарий только вместе с этим полем.

GET /v1/tasks/:taskId/comments/:id и скачивание вложения принимают необязательный параметр source со значением chat или legacy: он ограничивает поиск названным хранилищем. Без параметра поведение прежнее — чат-первым, со старым путём чтения при промахе, — поэтому существующие запросы отвечают HTTP 200, как и прежде. Поле source в ответе по комментарию называет хранилище, а downloadUrl каждого вложения уже несёт параметр ?source= с этим значением. Значение вне chat и legacy отклоняется с 400 INVALID_SOURCE, и обращения к Битрикс24 при этом не происходит.

Старое хранилище отдаёт за один раз не больше 50 записей, поэтому его полная страница отмечается meta.truncated: true, а meta.sources называет хранилища, содержимое которых узнал ответ. Если старое хранилище прочитать не удалось, ответ остаётся HTTP 200 и собирается из чата с meta.sources: ["chat"]. Сортировка по ID на задаче с обоими хранилищами сравнивает даты создания: номера чата и старой карточки лежат в разных пространствах и пересекаются по числу. По той же причине числовой ID не служит курсором инкрементальной синхронизации — для дочитывания новостей фильтруйте по POST_DATE.

BC-1118-5: Личные закрепы, избранное и однократное сохранение файлов на Диск

Поддержка старого формата до: не предусмотрена

Было

POST /v1/chats/files/save мог вернуть HTTP 200 после автоматического повтора запроса, если Битрикс24 сначала ответил 503, или после успешного перехода по перенаправлению. Повтор мог сохранить вторую копию, если первый вызов уже сохранил файл до сбоя.

Стало

Эндпоинт отправляет один запрос в Битрикс24. Ответ 503 от Битрикс24 теперь приводит к 502 BITRIX_UNAVAILABLE, а перенаправление — к 502 BITRIX_REDIRECT_REFUSED.

Что делать интеграторам

Обрабатывайте оба ответа 502. После ошибки результат сохранения может быть неизвестен. Проверьте папку сохранённых файлов на Диске и отправьте новый запрос, только если файла там нет.

Новые возможности

Добавлены личные закрепы сообщений и избранные сообщения: чтение по страницам, установка и снятие отметки текущего пользователя. У избранного есть отдельный счётчик. Новые списки принимают chat и реальный ID чата, включая личные диалоги.

GET /v1/chats/configuration передаёт доступность личных закрепов, ограничения закрепов, политику прав и признаки версии API. Отсутствующие данные остаются неизвестными. Признак версии не заменяет разрешение Битрикс24.

GET /v1/chats/:dialogId/load при полной загрузке передаёт начальный блок личных закрепов personalPins и флаг personalPinsHasNextPage, если возможность доступна.

FIX-1118-6: подсказка и сообщение WRONG_KEY для сервера с приложением ведут к замене ключа в карточке

Было

Для сервера, у которого есть живое приложение, ответ 403 WRONG_KEY на выкладке, команде, загрузке и чтении логов советовал (в том числе в error.message) перепривязать сервер и сменить ключ клиента.

Стало

Для такого сервера error.message и hint говорят, что ключ приложения заменён или не ваш: владелец приложения нажимает «Заменить ключ» в карточке приложения и передаёт новый ключ, а клиент подставляет его в X-Api-Key. Код и статус ответа прежние — 403 WRONG_KEY.

NEW-1118-7: Подпись сотрудников через API Вайбкод

В разделе /v1/sign-b2e доступны юридические поля и профили сотрудников, шаблоны и комплекты, отправка и чтение документов, личный и корпоративный сейф, документы HCM Link и внешние провайдеры подписи. Нужен скоуп sign.b2e; дополнительные скоупы и права указаны на страницах операций. Отправка имеет юридические последствия и автоматически не повторяется. Документация.

Шесть REST V3 операций юридических полей, профилей, шаблонов и комплектов находятся в процессе раскатки sign 26.1300.0. Пока обновление не пришло на портал, они возвращают 422 METHOD_NOT_YET_AVAILABLE с error.release: это признак раскатки, а не ошибка интеграции. Классические методы этой группы уже общедоступны.

FIX-1118-8: потерянная запись файла окружения при замене ключа больше не выдаётся за недоступный сервер

Было

При замене ключа с syncServerEnv: true в POST /v1/cowork/applications/{id}/key потерянный ответ на запись файла окружения сервера давал envSync.status: unreachable («окружение не тронуто»), хотя файл мог успеть измениться и остаться недоступным приложению.

Стало

Исходы ниже относятся к ответу запроса POST /v1/cowork/applications/{id}/key. Если ответ на запись файла окружения потерян, платформа возвращает файлу прежнего владельца и отвечает envSync.status: failed. Если вернуть владельца не удалось, ответ — envSync.status: owner_restore_failed. Если прежний владелец файла неизвестен, платформа его не меняет и отвечает envSync.status: failed. Если файл записан, а ответ на перезапуск приложения потерян, ответ — envSync.status: restart_failed. unreachable остаётся только тогда, когда окружение точно не тронуто: сервер недоступен до записи или команда записи до сервера не дошла. Успешный ответ замены ключа не меняется.