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

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

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

номер телефона клиента;
номер ответившего –> определяет того, кто станет ответственным за дело/звонок;
направление звонка (входящий/исходящий) – подпадает в название дела;
источник звонка;
комментарий нового лида, в котором будет указано, что он создан модулем.

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

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

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

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

В веб-интерфейсе в настройках модуля (https://ip-asterisk:8078/config) установите галочку на пункте "Включить кастомизацию полей лида";
Отредактируйте файл /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 Битрикса

PreviousКастомизация поиска NextЧерно/белые списки для версии до 2.15.0

Last updated 2 years ago

// Нужно вернуть массив [обновляемое_поле = значение] $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 );