Документация ПрофиCRM: AI-контроль качества звонков. Техническая структура полей чек-листа
Техническая структура полей чек-листа
Этот урок предназначен для администраторов и интеграторов. Он описывает техническую структуру пользовательских полей, которые решение создаёт для чек-листа в выбранном смарт-процессе.
В обычной работе создавайте и изменяйте чек-листы через форму решения. Ручная работа с полями нужна только для интеграции, диагностики или восстановления конфигурации.
Название чек-листа и секция карточки
Название чек-листа не создаётся отдельным пользовательским полем. Оно используется как заголовок секции в карточке смарт-процесса.
Внутреннее имя секции формируется из кода чек-листа по шаблону checklist_<код в нижнем регистре>. Например, для базового чек-листа с кодом BASICCALL используется имя checklist_basiccall.
На скриншоте секция «БАЗОВЫЙ ЧЕК-ЛИСТ КАЧЕСТВА ЗВОНКА» соответствует одноимённому чек-листу. Пользователь видит название секции, а внутреннее имя checklist_basiccall используется решением технически и в интерфейсе не отображается.
Пользовательские поля чек-листа
Префикс пользовательского поля зависит от смарт-процесса. Например, для сущности CRM_308 поля начинаются с UF_CRM_308.
| Элемент | Тип поля | Шаблон имени | Назначение |
| Критерий | Список | UF_<сущность>_CHECKLIST_<КОД>_<номер> | Отдельное поле для каждого критерия. Значениями списка являются варианты оценки. |
| Итоговая оценка | Число, точность до двух знаков | UF_<сущность>_CHECKLIST_<КОД>_RESULT | Хранит рассчитанную итоговую оценку чек-листа. |
| Комментарий проверяющего | Многострочная строка | UF_<сущность>_CHECKLIST_<КОД>_COMMENT | Хранит комментарий ручной или AI-оценки. |
Описание критерия сохраняется как подсказка его пользовательского поля. Если включён флажок добавления названия чек-листа к критериям, название чек-листа добавляется к подписи каждого критерия.
Поля критериев, итоговой оценки и комментария одного чек-листа.
Значения поля критерия и XML_ID
Вес варианта оценки хранится в XML_ID значения списка между символами #. Текст варианта нужен для отображения пользователю и сам по себе в расчёте не участвует.
| XML_ID | Пример названия | Вес |
#0# | плохо | 0 |
#0.5# | хорошо | 0.5 |
#1# | отлично | 1 |
В XML_ID дробная часть записывается через точку. При импорте CSV допустимы точка и запятая: решение нормализует значение перед сохранением.
Пример значений поля типа «Список» и их весов в XML_ID.
Расчёт итоговой оценки
В расчёт входят только заполненные поля критериев. Решение складывает их веса, делит сумму на количество заполненных критериев и умножает результат на коэффициент подсчёта оценки чек-листов.
При коэффициенте 100 среднее значение 0.75 записывается в поле результата как 75 и отображается как процентная оценка. Автоматический пересчёт выполняется при добавлении и изменении карточки, если включена настройка «Считать суммарную оценку по каждому чек-листу».
Размещение полей в карточке
Если в общей конфигурации карточки есть секция с точным названием «Оценка», поле результата и комментарий проверяющего добавляются в неё. Поля критериев размещаются в отдельной секции с названием чек-листа.
Если секции «Оценка» нет, результат и комментарий добавляются в секцию чек-листа перед критериями.
Воронки, поля и сохранённые данные
Выбранные воронки определяют, в каких карточках решение автоматически размещает поля чек-листа. При исключении воронки поля удаляются из общей конфигурации карточки этой воронки, но сами пользовательские поля и сохранённые в них данные не удаляются. При необходимости поля можно вручную вернуть в форму карточки и расположить удобным образом.
Важно. Удаление критерия удаляет соответствующее пользовательское поле. Удаление чек-листа удаляет его поля критериев, результата и комментария. Вместе с полями становятся недоступны сохранённые в них значения, поэтому перед удалением проверьте существующие карточки и при необходимости сохраните данные.
