← Назад к заметкам

Заметки

Как автозапускать БП при создании дела в таймлайне

Как автозапускать БП при создании дела в таймлайне: письмо, звонок, комментарий, события CRM Activity.

Дело в таймлайне — отдельная сущность. Его создание не обязано запускать БП по сделке как обычное изменение поля.

Задача

Сначала нужно отделить бизнес-сценарий от технического механизма.

Задача — как автозапускать БП при создании дела в таймлайне. В этой теме важны: Письмо, звонок, комментарий, события CRM Activity.

Перед правкой лучше воспроизвести сценарий на тестовой карточке и записать фактические ID, типы полей, пользователя запуска и текст ошибки.

Как это устроено

Большинство ошибок появляется из-за неверного формата данных или точки запуска.

  • ловите событие CRM Activity;
  • проверяйте тип дела: письмо, звонок, комментарий;
  • определяйте привязанную CRM-сущность;
  • защищайтесь от повторной обработки.

Рабочий подход

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

Для облака используйте REST и проверяйте права приложения. Для коробки, если код выполняется внутри портала, чаще удобнее PHP/D7 и штатные классы модуля.

Если действие меняет CRM-карточку, учитывайте роботов, бизнес-процессы, события и повторные вызовы обработчиков. Любая запись в карточку может стать новым триггером.

Частые ошибки

Ошибки лучше ловить на минимальном примере, а не в большом процессе.

  • не проверили права пользователя или приложения;
  • перепутали ID, текстовое значение и XML_ID;
  • передали строку вместо массива для множественного поля;
  • запустили процесс повторно и получили дубли;
  • обошли штатную операцию CRM и не запустили роботов или события.

Минимальный пример

Пример показывает только базовую форму. На реальном портале замените ID, поля и права на свои.

use Bitrix\Main\EventManager;

EventManager::getInstance()->addEventHandler(
    'crm',
    'OnAfterCrmActivityAdd',
    static function (&$activity_fields): void {
        AddMessage2Log($activity_fields, 'crm_activity_created');
    }
);