← К документации

CRM

Таймлайн CRM и комментарии

Добавление комментария и границы работы с системной историей карточки.

Таймлайн собирает несколько видов данных

Лента карточки содержит комментарии, дела, сообщения об изменениях и другие события. Чтение одной внутренней таблицы не гарантирует точную копию того, что показывает интерфейс. События могут иметь несколько привязок.

Для своей текстовой записи используйте API комментариев. Для звонка или задачи подходит соответствующее дело; текст «был звонок» не создаёт настоящую активность.

Добавить комментарий к сделке

BX24.init(function () {
    BX24.callMethod('crm.timeline.comment.add', {
        fields: {
            ENTITY_TYPE: 'deal',
            ENTITY_ID: 123,
            COMMENT: 'Получено подтверждение из внешней системы'
        }
    }, function (result) {
        if (result.error()) {
            console.error(result.error());
            return;
        }
        console.log('ID комментария:', result.data());
    });
});

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

Системную историю не редактируют как свою таблицу

Прямые TimelineTable::update и delete обходят логику привязок и связанных данных. Изменение даты первой найденной записи не является корректным способом поменять дату создания карточки.

Если нужен архив прошлой системы, храните исходное время и автора как атрибуты импорта. Не выдавайте новую запись за оригинальное системное событие. Обновление и удаление комментариев выполняйте через API комментариев с проверкой результата.

Источники