Поиск по сайту

Найдите нужный материал

Статьи, советы, уроки и обновления Битрикса. Введите хотя бы два символа.

Ищем…

Ничего не найдено

Попробуйте другой запрос или уберите лишние слова.

Показано результатов:

Все результаты Поиск по материалам BXMax
Telegram VK YouTube
crm 26.2000.0 Ломающее

Crm 26.2000.0: формы для смарт-процессов, новые REST API и удаление расписаний оценки звонков

6 мин чтения Устаревших API: 10
Узнавайте о ломающих изменениях Битрикса раньше, чем они доедут до прода: свежие разборы — в канале @bxmax_updates

Ломающее обновление

Удалены или изменены публичные API — прикладной код может перестать работать.

CRM 26.2000.0 большой: REST V3 для настроек, дел и сквозной аналитики, смарт-процессы, которые создаются через CRM-форму, поиск по таймлайну и AI-сводка клиента. Почти всё новое спрятано за флагами, так что на портале после обновления вы его не увидите. Зато три изменения заденут код сразу: удалены расписания оценки звонков, у команды настроек переименован аргумент, а SEARCH_CONTENT строится в фоне.

Новое

Читайте дела и настройки через REST V3

crm.settings.get и crm.settings.list отдают доступные пользователю настройки вместе со схемой значения, crm.settings.set меняет значение с отдельной проверкой прав. Неизвестная и недоступная настройка дают одинаковый 404, так что перебором названий нельзя выяснить, какие настройки есть. Если запись прошла, а чтение после неё упало, запись не откатывается: при ошибке перечитайте значение, прежде чем повторять set.

Чтение дел включает флаг RestV3CrudDeal. Для интеграций полезнее crm.{entity}.activity.list: он отдаёт дела одной карточки по всем привязкам и проверяет доступ к владельцу и провайдеру. В фильтре должно быть ровно одно условие верхнего уровня ownerId = N. Общий crm.activity.list отвечает только администратору группы 1 и права провайдера на каждое дело не проверяет. Обе выборки отдают страницы без общего количества, по 50 записей, максимум 200. В PHP то же самое делают ActivityProvider::getList() и getListInContext() из Bitrix\Crm\V2\Public\Provider\Activity.

Тот же RestV3CrudDeal открывает административный crm.address.list, методы requisite.getMyCompanyRequisite и requisite.setMyCompanyRequisite для сделок и смарт-счетов и setPrimaryContact для лидов, сделок и предложений. Под флагом RestV3Tracking появились методы сквозной аналитики: каналы и источники, архивирование, ручные расходы, подключение рекламных кабинетов, импорт расходов со статусом, дерево рекламы.

Создавайте элементы смарт-процесса через форму

Смарт-процесс теперь можно вывести в каталог запуска и связать с CRM-формой: её выбирают или создают в настройках типа, а кнопка добавления в списке открывает форму с нужной категорией и родителем. Флаг SmartProcessStartForms по умолчанию выключен. Для своих точек входа есть BX.Crm.StartCatalog.open() и AJAX-действия StartCatalog::getFormEmbedAction() и createFormAction(). Смарт-процессы попадают в каталог через обработчик CRM на событие onCollectStartableProcesses модуля bizproc.

С флагом LegalRegistry формы научились показывать юридические документы: каталог, карточка, выбор опубликованной версии и история использования. Форма не отправится, если показанная версия документов недоступна или изменилась. Повторная отправка с тем же идентификатором попытки и теми же данными вернёт сохранённый результат, с изменёнными данными получит IDEMPOTENCY_CONFLICT. Из PHP с этим работают FormBindingsCommand, FormSubmissionCommand, SubmissionRecoveryCommand и PresentationProvider::issueForPublicForm().

Привязывайте клиентов прямо из вкладки

На вкладке клиентов можно создать, привязать и отвязать контакт или компанию и назначить основную связь. Для кода добавлены команды в Bitrix\Crm\V2\Public\Command\Item\ClientBinding: BindContactsCommand, BindCompaniesCommand, UnbindContactsCommand, UnbindCompaniesCommand, SetPrimaryContactCommand, SetPrimaryCompanyCommand. Реквизиты своей компании обслуживают SetMyCompanyRequisiteCommand и MyCompanyRequisiteProvider.

Ищите по таймлайну и закрепляйте комментарии

Флаг TimelineNavigation добавляет в карточку поиск по истории, выбор типов записей и постраничную загрузку. Комментарий получил редактор RichTextArea и переключатель закрепления. У Bitrix\Crm\Controller\Timeline\Comment::addAction() появился необязательный $pin, при исчерпанном лимите закреплений он вернёт PINNED_LIMIT_EXCEEDED.

Попросите AI собрать сводку по клиенту

Сводка работает при включённом флаге AiSummary (по умолчанию выключен), настройке сводки клиента на портале и доступе пользователя к AI. Её можно запросить из карточки контакта или компании с доставкой в чат, в окне звонка для неё есть отдельная вкладка. MCP-инструменты get_crm_summary и get_crm_communications работают с контактом, компанией и сделкой и проверяют права пользователя. В истории коммуникаций лежат краткие итоги, тема и намерение, полного текста разговора там нет.

Что сломается

Расписаний оценки звонков больше нет

Удалены редактор периодов и весь API расписаний: методы CallAssessmentItem::getAvailabilityType(), setAvailabilityType(), getAvailabilityData(), CopilotCallAssessmentController::getCurrentAvailableAssessmentFilter(), контроллер CopilotCallAssessmentAvailabilityController, таблица CopilotCallAssessmentAvailabilityTable, enum AvailabilityType и AvailabilityWeekdayType. Из CopilotCallAssessmentTable убраны ORM-поля AVAILABILITY_TYPE и AVAILABILITY_DATA. Сценарий оценки теперь просто включён или выключен:

        use Bitrix\Crm\Copilot\CallAssessment\Controller\CopilotCallAssessmentController;

$result = CopilotCallAssessmentController::getInstance()->updateEnabled($assessmentId, false);

    

Читать состояние — через CallAssessmentItem::isEnabled(). AJAX-контроллер ещё понимает старое availabilityType = inactive как выключение, но расписания не сохраняет.

Переименуйте аргумент команды настроек

У Bitrix\Crm\V2\Public\Command\Settings\UpdateSettingCommand аргумент code стал id, а getCode() заменён на getId(). Позиционные вызовы работают, именованные упадут:

        $command = new UpdateSettingCommand(id: $settingId, value: $value, userId: $userId);

    

Не ждите SEARCH_CONTENT сразу после сохранения

Service\Operation::updateSearchIndexes() теперь откладывает сборку SEARCH_CONTENT в фоновую работу. Если сразу после launch() вы ищете элемент по этому полю или читаете его, его там ещё может не быть. Собрать индекс принудительно можно так:

        use Bitrix\Crm\Service\Container;

$result = $factory->getAddOperation($item)->launch();
if ($result->isSuccess()) {
    Container::getInstance()->getDeferredSearchIndexer()->flush();
}

    

CCrmSearch::UpdateSearch() по-прежнему синхронный. Переиндексация при обновлении запускается, только если изменились индексируемые поля, а несколько сохранений одной сущности склеиваются в одну сборку.

Групповое действие WhatsApp переехало

Класс WhatsAppMessageAction удалён, отправка WhatsApp теперь в выпадающем меню групповых действий через Item\Group\WhatsAppMessageChildAction. Если вы расширяли панель грида, замените идентификатор whatsapp-message на whatsapp_message.

БД

У b_crm_dynamic_type появились IS_START_CATALOG_ENABLED, START_CATALOG_FORM_ID и IS_CREATE_BY_FORM_ENABLED. У b_crm_legal_document добавлены REVISION и METADATA, у b_crm_legal_version — DRAFT_SETTINGS. Новая b_crm_webform_legal_receipt хранит результат отправки формы с уникальным SUBMISSION_ID, b_crm_tracking_ad_auth_ticket — билеты подключения рекламных кабинетов. На b_crm_timeline_bind добавлен индекс IX_B_CRM_TIMELINE_BIND_ENTITY_OWNER по ENTITY_ID, ENTITY_TYPE_ID, OWNER_ID.

Мелочи и находки

  • В crm.item.list ключи фильтра COMPILED_EXPRESSION_ больше не превращаются в сырой SQL. Копирование элемента проверяет canCopyItem() вместо canUpdateItem().
  • Канбан при частичном отказе групповой смены стадии возвращает отклонённые карточки и суммы колонок на место.
  • Центр настроек объясняет, почему действие недоступно, ведёт к ограничениям тарифа и ищет по настройкам.
  • Новый робот перехода в чат MAX. В роботе отправки письма можно приложить файлы Диска, а с флагом EmailNodeSenderTemplatesFlag выбрать почтовый шаблон. Файл прикладывается, если его может скачать автор шаблона или ответственный.
  • Панель AI-анализа звонка показывает историю резюме и размеченную расшифровку. В настройках AI доступ к сценариям учитывает пакет или доступность магазина BaaS.
  • Склад с активным резервом незавершённой сделки удалить нельзя. Удаление старого счёта из карточки требует только права удаления.

Устаревшие и удалённые API в этой версии

Символ Статус Чем заменять
Bitrix\Crm\Copilot\CallAssessment\CallAssessmentItem::getAvailabilityType() Удалено Bitrix\Crm\Copilot\CallAssessment\CallAssessmentItem::isEnabled()
Bitrix\Crm\Copilot\CallAssessment\CallAssessmentItem::setAvailabilityType() Удалено Bitrix\Crm\Copilot\CallAssessment\Controller\CopilotCallAssessmentController::updateEnabled()
Bitrix\Crm\Copilot\CallAssessment\CallAssessmentItem::getAvailabilityData() Удалено —
Bitrix\Crm\Copilot\CallAssessment\Controller\CopilotCallAssessmentAvailabilityController Удалено —
Bitrix\Crm\Copilot\CallAssessment\Controller\CopilotCallAssessmentController::getCurrentAvailableAssessmentFilter() Удалено —
Bitrix\Crm\Copilot\CallAssessment\Entity\CopilotCallAssessmentAvailabilityTable Удалено —
Bitrix\Crm\Copilot\CallAssessment\Enum\AvailabilityType Удалено —
Bitrix\Crm\Copilot\CallAssessment\Enum\AvailabilityWeekdayType Удалено —
Bitrix\Crm\V2\Public\Command\Settings\UpdateSettingCommand::getCode() Удалено Bitrix\Crm\V2\Public\Command\Settings\UpdateSettingCommand::getId()
Bitrix\Crm\Component\EntityList\Grid\Panel\Action\WhatsAppMessageAction Удалено Bitrix\Crm\Component\EntityList\Grid\Panel\Action\Item\Group\WhatsAppMessageChildAction

Новая версия вышла — разбор уже в Telegram

В канале @bxmax_updates публикуем каждый свежий разбор: что сломается, что устарело и что появилось в API. Узнаете до того, как обновите прод.

Подписаться

Читайте дальше

crm 26.1900.0 Безопасность Свежее

Crm 26.1800.0–26.1900.0: описания стадий, обязательные поля и проверка согласий

В CRM 26.1800.0 и 26.1900.0 появились описания стадий, команды обязательности полей и новые методы REST 3.0. Обновления закрывают ошибки доступа и обработки фильтров; интеграторам придётся проверить веб-формы, документные дела и шаблоны БП.

1 мин
crm 26.1750.0 Рутинное

Crm 26.1750.0: маршруты превью ссылок регистрируются в InstallDB()

В Crm 26.1750.0 от 20 октября 2026 года API и схема БД не менялись, а в установщике вызов `\Bitrix\Crm\Preview\Route::setCrmRoutes()` переехал из конца `InstallFiles()` в `InstallDB()`, сразу после установки пользовательских полей. Этот метод регистрирует через `Bitrix\Main\UrlPreview\Router` обрабо…

1 мин
crm 26.1700.0 Ломающее

Crm 26.1450.0–26.1700.0: права на настройку без админства, белый список обработчиков печати и RequirementProvider

В коробочный Битрикс24 пришли четыре версии CRM: 26.1450.0, 26.1500.0, 26.1600.0 и 26.1700.0. Настройку CRM можно раздать по семи правам, а `RequirementProvider` возвращает стадии, на которых поле обязательно. Обновление закрывает дыры в правах, но сначала проверьте обработчики печати и оплаты, копи…

2 мин
crm 26.1400.0 Ломающее

Crm 26.900.0–26.1400.0: CRM V2 для PHP, CCrmDeal::Add только через Operation и белый список фильтра в crm.item.productrow.list

В коробочный Битрикс24 одним днём пришли шесть версий CRM: 26.900.0, 26.1000.0, 26.1100.0, 26.1200.0, 26.1300.0 и 26.1400.0. PHP-разработчику достался типизированный слой CRM V2, на котором строится и REST 3.0, а интеграции перед обновлением стоит проверить на `crm.item.productrow.list`, записи в та…

1 мин
Мы используем файлы cookie для улучшения работы сайта. Продолжая использовать сайт, вы соглашаетесь с нашей политикой конфиденциальности.
AI Домовой

AI Домовой История

на связи

пишет…

Можно закрыть чат и перейти на другую страницу. Когда ответ будет готов, на кнопке Домового появится отметка.

Нет истории чатов
AI Домовой

Нужна авторизация

Войдите, чтобы задавать вопросы AI Домовому.

Войти