CRM
Дела CRM и их привязки
Планируемое дело, связь с карточкой и отличие активности от записи таймлайна.
Выбрать подходящий вид дела
Планируемое действие, звонок и письмо имеют разное назначение. Для обычного напоминания подходит crm.activity.todo.add. Не нужно имитировать телефонный звонок произвольным TYPE_ID или придумывать provider-поля для переписки.
Создать планируемое дело
Пример для приложения с BX24.js. Тип 2 обозначает сделку; ID и срок заменяются значениями вашей карточки.
BX24.init(function () {
BX24.callMethod('crm.activity.todo.add', {
ownerTypeId: 2,
ownerId: 123,
title: 'Уточнить состав поставки',
deadline: '2026-10-01T12:00:00+03:00'
}, function (result) {
if (result.error()) {
console.error(result.error());
return;
}
console.log(result.data());
});
});Добавить связь существующего дела
Одно дело может отображаться в нескольких карточках. Для новой связи используйте ID самого дела, тип и ID дополнительной карточки.
BX24.init(function () {
BX24.callMethod('crm.activity.binding.add', {
activityId: 456,
entityTypeId: 2,
entityId: 123
}, function (result) {
if (result.error()) {
console.error(result.error());
return;
}
console.log(result.data());
});
});Привязка дела не меняет автоматически все связи его источника. Например, у открытой линии остаётся собственный контекст клиента и сессии.
CCrmActivity в существующей коробке
Legacy-класс CCrmActivity нужен при сопровождении старых интеграций. Результат Update нужно проверять; отсутствие исключения не гарантирует сохранение. Внутренние методы изменения привязок могут отличаться по версии.
Прямой SQL и изменения таблиц таймлайна не заменяют API дел. Событие изменения активности тоже не обязательно содержит полную карточку дела: необходимые данные читаются отдельно с подходящим контекстом.