К списку статей

Обновление полей сущности

Кастомизация полей сущности (лида/контакта) доступна начиная с версии 2.15.0 (в предыдущих версиях была кастомизация только для лидов: Обновление полей лида)

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

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

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

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

По завершению звонка есть возможность изменить/обновить поля в лиде/контакте CRM Битрикс24. Это возможно сделать один раз и только для новых лидов/контактов (если лид/контакт создан в результате регистрации звонка модулем).

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

  1. В веб-интерфейсе настройки модуля установите галочку на пункте "Включить кастомизацию полей сущности". Image
  2. Редактируем файл /opt/bx24asterisk/custom/get_updated_entity_fields.php.

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

Пример кастомизации:

Пишем в название номер клиента, направление звонка(исходящий/входящий), если он пропущен, дополнительно напишем это. В поле "Дополнительно об источнике" укажем транк.

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

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

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

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

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

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

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

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