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.
- Склад с активным резервом незавершённой сделки удалить нельзя. Удаление старого счёта из карточки требует только права удаления.