Обновление полей лида

В версии 2.15.0 кастомизация get_updated_lead_fields перенесена в get_updated_entity_fields и вызывается не только для лидов, но и для контактов. Новая статья: Обновление полей сущности.

По умолчанию мы передаем в Битрикс24 стандартную информацию о звонке:

  • номер телефона клиента;

  • номер ответившего –> определяет того, кто станет ответственным за дело/звонок;

  • направление звонка (входящий/исходящий) – подпадает в название дела;

  • источник звонка;

  • комментарий нового лида, в котором будет указано, что он создан модулем.

Но возникают ситуации, когда требуется подкорректировать эти данные. Например, можно:

  • убрать комментарий из лида, так как это поле используется операторами для заметок;

  • указать в поле "дополнительно об источнике", на какой транк поступил звонок.

По завершению звонка появилась возможность изменить/обновить поля в лиде CRM Битрикс24. Это возможно сделать один раз, если лид создан модулем. То есть это должен быть звонок с неизвестного номера. Доступно с версии 2.7.119 модуля.

Как реализовать:

  1. В веб-интерфейсе в настройках модуля (https://ip-asterisk:8078/config) установите галочку на пункте "Включить кастомизацию полей лида";

  2. Отредактируйте файл /opt/bx24asterisk/custom/get_updated_lead_fields.php. Если папки /opt/bx24asterisk/custom нет, редактируем файл /opt/bx24asterisk/customizer.php после строки case 'get_updated_lead_fields':

Подробно параметры описаны в статье.

Ниже приведен скрипт, который в название лида пишет номер клиента, направление звонка либо статус пропущенного звонка, а в поле "Дополнительно об источнике" будет записан транк, через который прошел звонок:

// Нужно вернуть массив [обновляемое_поле = значение]

$leadFields = array();
$direction = 'Входящий ';
$number = $params['from'];
$trunk=$params['trunk'];

// 2 - входящий, 3 - исходящий
if ($params['type'] == 3) {
    $direction = 'Исходящий ';
    $number = $params['to'];
}

if (empty($params['answered_at'])) { // пропущенный звонок
    $direction .= 'пропущенный ';
}

$leadFields = array(
    'NAME' => $number . ' ' . $direction . 'звонок',
    'SOURCE_DESCRIPTION'=>$trunk,
);

return array(
    'state' => 'success',
    'data' => $leadFields
);

Описание полей в API Битрикса

Last updated