search string side menu

Задачи CRM / Обработка событий в задачах CRM

Обработка событий в задачах CRM

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

начало внимание

Обработчик событий для задач CRM доступен при активации одного из платных решений CRM, в котором включено использование задач этого типа. Создавать модуль и настраивать в нём обработчики событий могут только администраторы системы.

конец внимание 

Пример обработчика с отслеживанием создания задачи CRM

Данные о задаче и элементе, по которому она поставлена, поступают в обработчик в виде JSON-файла. Вы можете получить из него отдельные значения свойств из контекста задачи. Затем их можно передать в настроенный бизнес-процесс или скрипт, с которым связан обработчик событий. Например, так можно использовать ID задачи, дату её создания и окончания, ответственного за выполнение пользователя и т. д.

Рассмотрим пример обработчика событий, в котором при создании задачи CRM типа Письмо с помощью скрипта обрабатывается JSON‑файл с данными об этой задаче. Затем они передаются в бизнес-процесс и записываются в отдельные переменные. В ходе процесса руководитель отдела продаж получает задачу ознакомления с деталями добавленного письма.

Для настройки обработчика, выполните следующие действия:

  1. Перейдите в раздел Администрирование > Модули и создайте пользовательский модуль.
  2. В настройках модуля перейдите на вкладку Процессы и добавьте бизнес-процесс, который будет выполняться каждый раз после создания задачи CRM. 

Для нашего примера добавим простой процесс Уведомление о новой задаче CRM. Его схема будет выглядеть следующим образом:

crm-events-processing-1

  1. В дизайнере бизнес-процессов перейдите на вкладку Контекст и добавьте переменные, в которые обработчик в результате создания задачи передаст данные о ней. При создании каждой переменной выберите код, тип и подтипы приведённые ниже:

crm-events-processing-2

  • Строковое представление события — в переменную запишется строковое представление json-объекта, содержащего данные о задаче CRM;
  • Название задачи, Контакты по задаче, Описание задачи, Дата начала задачи, Дата окончания задачи, Исполнитель — свойства, в которые с помощью скрипта в процессе передаются полученные данные из созданной задачи.
  1. Перейдите на вкладку Схема. В зоне ответственности Инициатор сразу после стартового события разместите блок Скрипт и задайте в нём функцию afterInit. С помощью скрипта в функции из полученного от обработчика JSON-файла формируется строковое представление данных о задаче, а затем информация записывается в отдельные свойства.

Пример скрипта для получения данных о задаче CRM из JSON-файла

async function afterInit(): Promise<void> {
    // Из полученной в виде JSON-файла константы task формируем строковое представление:
    const task = JSON.parse(Context.data.event_string!);
    // Теперь полученные данные можно записать в отдельные свойства
    //Получаем название задачи CRM:
    Context.data.task_name = task.__name;
    //Получаем описание задачи CRM:
    Context.data.task_description = task.description;
    // С помощью цикла получаем список контактов, указанных в задаче CRM
    Context.data.task_contact = [];
    for (const contact_id of task.instance.contacts) {
        const contact = await Context.fields.task_contact.app.search()
            .where(
                f => f.__id.eq(contact_id)
            ).first();
        Context.data.task_contact.push(contact!);
    }
    // Получаем дату и время создания задачи CRM
    Context.data.task_start_date = new Datetime(new Date(task.planStart));
    // Получаем дату и время завершения задачи CRM
    Context.data.task_end_date = new Datetime(new Date(task.planEnd));
    //Получаем ответственного за выполнение задачи по ID пользователя
    const performer_id = task.originalPerformers[0];
    Context.data.task_executor = await System.users.search().where(
        f => f.__id.eq(performer_id)
    ).first();
}
  1. Перейдите на схему процесса и создайте статистическую зону ответственности, поскольку задача назначается руководителю отдела продаж, записанному в элемент оргструктуры.
  2. Чтобы руководитель мог ознакомиться с данными о созданном письме, полученными из обработчика событий, разместите в дополнительной зоне ответственности блок Задача. На форму задачи вынесите свойства, в которые в процессе записывается информация о письме: Название задачи, Контакты по задаче, Описание задачи, Дата начала задачи, Дата окончания задачи, Исполнитель.
  3. Сохраните и опубликуйте процесс.
  4. В настройках модуля перейдите на вкладку Обработка событий. Добавьте обработчик, указав: название обработчика, домен — Задачи, событие — Создание задачи CRM, тип задачи — Письмо, тип обработчика — Запуск скрипта.

crm-events-processing-3

  1. На открывшейся странице настроек обработчика событий перейдите на вкладку Скрипты. В функции action укажите скрипт, который будет преобразовывать JSON-файл в строковое представление и запускать настроенный ранее процесс Уведомление о новой задаче CRM:

async function action(): Promise<void> {
    // Получаем строковое представление данных о задаче, создание которой запустило обработчик, и сохраняем их в константу task_json_string:
    const task_json_string = JSON.stringify(Context.data.task);
    // Запускаем раннее созданный бизнес-процесс, передав task_json_string в переменную Строковое представление события из контекста процесса:
    await Namespace.processes.uvedomlenie_o_novoi_zadache_crm.run({
        event_string: task_json_string,
    })
}

  1. На верхней панели страницы нажмите Сохранить, а затем Опубликовать, чтобы активировать обработчик событий.
  2. Вернитесь на основную страницу модуля и включите его.

Теперь при включённом модуле, когда пользователь создаст задачу CRM — Письмо, в системе сработает обработчик событий. C помощью скрипта он запустит настроенный бизнес-процесс. Руководитель отдела продаж получит задачу, в которой сможет ознакомиться со всеми данными о задаче.

configure-crm-task-page.html assign-nurturing-stage.html