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

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

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

BC-1106-1: CRM-формы сохраняют структуру и правила Битрикс24

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

Было

Список форм по умолчанию показывал только активные формы и сокращённый набор полей. Чтение формы пересобирало поля и соглашения, добавляло свойства title, result, agreementsSettings и варианты значений полей. Поля контракта формы не перечисляли описания analytics, integrations и spamProtection, а чтение поля контракта по этим именам отвечало 400 INVALID_PARAMS. Фильтр isCallback отбирал записи после получения страницы. Ошибка дополнительного чтения после записи выглядела как ошибка самой записи. Виджеты сайта и открытые линии отвечали UNKNOWN_FILTER_FIELD на неизвестный параметр строки запроса, отдавали сокращённый набор свойств элемента, применяли размер страницы 50 со смещением 0 и всегда возвращали meta с limit и offset. Коды встраивания пересобирались в отдельную структуру.

Стало

Список включает активные и неактивные формы, по умолчанию возвращает 11 базовых свойств. select выбирает секции и подпути, доступны фильтр по id и сортировка. В GET /v1/crm-forms параметры строки запроса, кроме управляющих, передаются условиями фильтра Битрикс24: прежнего локального отказа на неизвестное имя нет, допустимость решает портал. GET /v1/crm-forms/{id} принимает необязательный select. У списка форм, виджетов сайта и открытых линий сняты собственные умолчания limit=50, offset=0 и граница limit 1–1000: значения проверяет портал. Без limit и offset пагинация не передаётся. Поля пагинации meta.limit, meta.offset, meta.total больше не гарантируются: они возвращаются только из пагинации портала, а объект meta может отсутствовать. Форма возвращается в структуре Битрикс24 без пересборки полей и соглашений и без добавленных свойств. Поля контракта формы перечисляют все свойства, включая analytics, integrations и spamProtection, чтение поля контракта по этим именам возвращает описание, и оба пути принимают необязательный select. Дополнительного получения вариантов значений нет, фильтрация по isCallback после выборки тоже убрана. Обычное содержимое сохраняется, точные учётные данные текущего подключения заменяются с путями в meta.redacted.

Создание и изменение принимают плоское тело либо объект fields. В PATCH /v1/crm-forms/{id} собственные списки разрешённых и только читаемых свойств сняты: active и другие переданные свойства проверяет портал. Успешная запись со сбоем перечитывания сохраняет успешный статус и data.id, добавляя meta.warnings. CRM_FORM_PARTIALLY_CREATED остаётся ошибкой с error.id, b24Code и ошибками полей. Ошибки Битрикс24 содержат b24Code, недостаточный скоуп токена отличается кодом BITRIX_INSUFFICIENT_SCOPE. Только отсутствие метода даёт 409 CRM_FORM_REST_NOT_ENABLED. Локальные отказы формы запроса в описанных методах crm.form.* отвечают кодом INVALID_PARAMS: коды UNKNOWN_FILTER_FIELD, UNKNOWN_FIELD, READONLY_FIELD, INVALID_FILTER_OPERATOR и INVALID_FILTER_SHAPE здесь больше не возвращаются, а отсутствие updatedTime при изменении формы или встройки даёт INVALID_PARAMS вместо MISSING_REQUIRED_FIELDS. Отказ MISSING_REQUIRED_FIELDS при отсутствии entityName и контракт POST /v1/crm-forms/{id}/results не меняются. Встройка поддерживает link и code: null, удаление — confirmed наряду с confirm. На путях виджетов сайта и открытых линий неизвестный параметр строки запроса даёт INVALID_PARAMS вместо UNKNOWN_FILTER_FIELD, элементы возвращаются в структуре Битрикс24, появились order и sort, а без limit и offset пагинация не передаётся и meta содержит только то, что вернул Битрикс24. Коды встраивания тоже возвращаются в структуре Битрикс24. В GET /v1/crm-forms/{id}/embedding значения variant и delay больше не проверяются локально, а delay передаётся как значение строки запроса. В PATCH /v1/crm-forms/{id}/embedding снят собственный список настроек тела: разрешённость свойств решает портал. Прежний локальный отказ на этих входах больше не гарантируется; Битрикс24 может принять их или вернуть свой отказ. Проверки формы запроса сохраняются. В PATCH /v1/crm-forms/{id} и PATCH /v1/crm-forms/{id}/embedding наличие updatedTime по-прежнему обязательно, но тип значения больше не проверяется локально. В этих двух путях, а также в POST /v1/crm-forms/{id}/activate, POST /v1/crm-forms/{id}/deactivate и DELETE /v1/crm-forms/{id} с необязательным updatedTime вместо гарантированного 400 INVALID_PARAMS на нестроковое значение запрос принимает или отклоняет Битрикс24. В POST /v1/crm-forms отсутствие тела больше не вызывает локальный отказ: портал получает пустой fields и проверяет его сам.

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

Для прежнего отбора активных форм передавайте active=true. Используйте исходные секции формы вместо добавленных title, result, agreementsSettings и искусственных свойств полей. Целевые сущности и ответственных запрашивайте через select=crm.entityScheme,responsible.userIds, варианты CRM-полей — через справочник полей сущностей. После предупреждения о перечитывании выполните GET до следующего изменения. Ветвление по кодам UNKNOWN_FILTER_FIELD, UNKNOWN_FIELD, READONLY_FIELD, INVALID_FILTER_OPERATOR, INVALID_FILTER_SHAPE на описанных путях crm.form.* замените веткой INVALID_PARAMS; так же обработайте отсутствие updatedTime при изменении формы или встройки. При изменении формы или встройки продолжайте передавать updatedTime, а при нестроковом значении учитывайте ответ Битрикс24 вместо ожидания прежнего локального 400 INVALID_PARAMS. Для активации, деактивации, удаления и создания без тела тоже учитывайте ответ Битрикс24 вместо ожидания прежнего локального отказа. Уточнения читайте в error.message, error.b24Code и error.validation. У списка форм неизвестный параметр больше не вызывает локальный UNKNOWN_FILTER_FIELD: он становится условием фильтра, которое Битрикс24 принимает либо отклоняет. Не рассчитывайте на обязательный локальный отказ. Для списка форм также передавайте limit и offset явно, если нужна прежняя страница из 50 записей, и проверяйте наличие meta и её полей перед чтением. Для встройки учитывайте ответ портала и error.b24Code вместо ожидания прежнего локального отказа на значения variant, delay или состав настроек. При CRM_FORM_PARTIALLY_CREATED перечитайте форму по error.id, исправьте или удалите её, создание не повторяйте. Не сохраняйте замаскированную конфигурацию обратно без восстановления изменённых значений. На путях виджетов сайта и открытых линий тоже замените ветку UNKNOWN_FILTER_FIELD веткой INVALID_PARAMS, передавайте limit и offset явно, если нужен прежний размер страницы, и читайте свойства элементов и кодов встраивания из ответа Битрикс24.

NEW-1106-2: Настройки тредов и признаки чата

PATCH /v1/chats/{chatId}?format=v2 принимает threadsEnabled как boolean и manageThreadCreate, manageThreadPost со значениями MEMBER, MANAGER или OWNER. GET /v1/chats/configuration возвращает доступные признаки настроек чата; отсутствующий признак означает неизвестное значение.

FIX-1106-3: создание приложения: отказ Битрикс24 при непрочитанной подписке возвращает понятный код

Было

POST /v1/apps отвечал 502 CONNECTOR_REST_UNAVAILABLE, когда Битрикс24 отказал в выписке ключа, а подписку аккаунта прочитать не удалось.

Стало

Тот же случай возвращает 403 PORTAL_SUBSCRIPTION_UNREADABLE, и в error.details.remedy указано, как повторить проверку. Это не отказ B24_MARKET_SUBSCRIPTION_REQUIRED: покупку ответ не предлагает. Если подписка прочитана и действует, ответ остаётся 502 CONNECTOR_REST_UNAVAILABLE.

FIX-1106-4: создание приложения: отказ Битрикс24 при непрочитанном тарифе возвращает понятный код

Было

POST /v1/apps отвечал 502 CONNECTOR_REST_UNAVAILABLE, когда Битрикс24 отказал в выписке ключа, а тариф аккаунта прочитать не удалось.

Стало

Тот же случай возвращает 403 PORTAL_TARIFF_UNREADABLE, и в error.details.remedy указано, как повторить проверку. Если тариф и доступ подтверждены, ответ остаётся 502 CONNECTOR_REST_UNAVAILABLE.

NEW-1106-5: отказ длительной команды из-за расхождения часов сервера получил отдельный код

POST /v1/infra/servers/{id}/exec в длительном режиме (async=true) теперь отвечает HTTP 502 с кодом EXEC_JOB_START_WINDOW, когда сервер отклонил запуск из-за собственных часов: они опережают часы платформы больше чем на минуту или отстают больше чем на тридцать секунд. Отказ приходит до запуска команды, поэтому после сверки времени на сервере ту же команду можно отправить заново. Раньше такой случай приходил с общим кодом EXEC_JOB_INVALID, который не отделял расхождение часов от прочих отказов. Новый код виден и в исходе операции в GET /v1/infra/operations/{operationId}. Остальные отказы сохраняют прежние коды.

FIX-1106-6: выкладка больше не срывается из-за расхождения часов сервера

Было

В течение часа после создания сервера или его пробуждения шаг runtime у POST /v1/infra/servers/{id}/deploy уходил на сервер отложенной задачей с ограниченным окном запуска. Если часы сервера опережали часы платформы больше чем на минуту или отставали больше чем на тридцать секунд, задача отклонялась, и выкладка завершалась ошибкой на этом шаге, хотя запрос и код приложения были корректны.

Стало

Такой отказ распознаётся отдельно от остальных отказов сервера, и шаг runtime выполняется напрямую, без отложенной задачи. Выкладка проходит и при опережающих, и при отстающих часах сервера. Поля запроса и формат ответа не менялись.

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

Действий не требуется. Отказ шага runtime по другим причинам приходит с прежними кодами.

FIX-1106-7: `categoryId` стал обязательным в контракте обязательных полей CRM для всех типов, кроме лидов и предложений

Было

Схема PUT в GET /v1/openapi.json объявляла categoryId необязательным для всех типов, а пример ответа подставлял 0 даже для лидов и предложений. Интегратор, собиравший запрос по схеме, мог не передать categoryId для сделки и получить отказ Битрикс24.

Стало

PUT /v1/deals/fields/required, а также PUT /v1/{contacts,companies,invoices}/fields/required и PUT /v1/items/{entityTypeId}/fields/required перечисляют categoryId среди обязательных полей. У лидов и предложений поля нет в схеме вовсе: эти типы его не принимают. Пример ответа показывает categoryId: null, когда настройка глобальная. Поведение метода не менялось: правила по-прежнему проверяет Битрикс24.

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

Действий не требуется: запросы, которые работали, работают как прежде. Сверьтесь со схемой, если валидация на вашей стороне считала categoryId необязательным для сделок, контактов, компаний, счетов и смарт-процессов.

NEW-1106-8: агрегация предупреждает о смешанных валютах

POST /v1/deals/aggregate теперь добавляет в data.meta.warnings предупреждение с кодом AGGREGATE_MIXED_CURRENCIES, когда sum, avg, min или max считаются по полю, которое хранится в валюте самой записи (deals.amount, deals.taxValue, leads.opportunity, leads.amount, quotes.amount, invoices.opportunity, companies.revenue), прочитанные записи пришли в разных валютах, а groupBy не содержит поля валюты. Валюты не пересчитываются, поэтому такое число складывает разные валюты. Предупреждение приходит независимо от усечения ответа и может прийти вместе с AGGREGATE_TRUNCATED. Устаревший GET /v1/{entity}/aggregate предупреждает так же. Поля учётной валюты Битрикс24 (deals.receivedAmount, deals.lostAmount) предупреждение не вызывают.

NEW-1106-9: MCP-пакет 3.4.1: администратор приложения в сценарии входа

В @bitrix24/mcp-vibecode-api 3.4.1 сценарий add-user-login знает шаг create-admin из ответа настройки входа: агент выполняет его синхронно, показывает автору выданную ссылку один раз и не сохраняет её. Флаг --reset агент добавляет только для переданного приложения и только с согласия автора. Если в настройке входа два шага, это режим восстановления: агент выполняет только create-admin, ничего не устанавливает и не деплоит.

Когда в env настройки нет политики обработки данных, политику и способы входа автор задаёт в мастере админки приложения, и агент не запрашивает ссылку на политику. Переменные, которые уже есть в деплое, остаются до прохождения мастера. Проверка входа объясняет два новых состояния: setup_pending — владельцу нужно войти по ссылке установки и пройти мастер, not_configured — в переменных деплоя нет способа входа или политики. Инструкции сервера направляют просьбы создать администратора, вернуть доступ к админке или принять переданное приложение к шагу create-admin. Обновите пакет и перезапустите MCP-сессию, чтобы загрузить новые подсказки.

FIX-1106-10: статус входа пользователей больше не называет закрытый вход работающим

Было

GET /v1/app-user-signin/servers/{serverId}/status отвечал working, когда в приложении стоит SDK входа 0.4 и вход посетителей ещё закрыт: мастер в админке не пройден или в переменных деплоя нет способа входа либо политики обработки данных. Без способов входа тот же случай читался как not_installed.

Стало

Для такого приложения поле state и lastKnown.outcome принимают одно из двух новых значений. setup_pending — в приложении SDK входа 0.4.1 или новее, вход откроется, когда владелец войдёт по ссылке установки и пройдёт мастер в админке приложения. not_configured — в приложении SDK входа 0.4.0, вход откроется после деплоя со способом входа и политикой. Ответ для приложений на более ранних версиях SDK и для работающего входа прежний.

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

Менять ничего не нужно: working по-прежнему означает, что посетители могут войти. Если код сравнивает state со списком известных значений, добавьте в него setup_pending и not_configured — оба значат, что вход установлен, но пока закрыт.