Обновление полей сущности
Кастомизация полей сущности (лида/контакта) доступна начиная с версии 2.15.0 (в предыдущих версиях была кастомизация только для лидов).
По умолчанию мы передаем в CRM стандартную информацию о звонке:
  • номер телефона клиента;
  • номер ответившего –> определяет того, кто станет ответственным за дело/звонок;
  • направление звонка (входящий/исходящий) – подпадает в название дела;
  • источник звонка.
Но возникают ситуации, когда требуется подкорректировать эти данные. Например, можно:
  • добавить комментарий в лид/контакт;
  • указать в поле "дополнительно об источнике", на какой транк поступил звонок.
По завершению звонка есть возможность изменить/обновить поля в сущности CRM.
Это возможно сделать один раз и только для вновь созданных лидов/контактов.

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

В веб-интерфейсе настройки модуля (http://<Asterisk IP>:8077/config):
  1. 1.
    Установите галочку "Включить кастомизацию".
  2. 2.
    Установите галочку на пункте "полей сущности".
2. Отредактируйте файл кастомизации.
Кастомизация настраивается в файле /opt/itgrix_bx/customizer/actions/customize_entity.php.
Для версий ДО 3.4.0 этот файл находится в каталоге /opt/itgrix_bx/custom/
Параметры сущности, которые можно изменять, описаны в статье.

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

Пишем в название номер клиента, направление звонка (исходящий/входящий), если он пропущен – дополнительно напишем это. И в поле "Дополнительно об источнике" укажем транк, на который звонили.
1
// Нужно вернуть массив [обновляемое_поле = значение]
2
3
$newFields = array();
4
5
// Пример: изменяем имя лида
6
$type = 'Входящий ';
7
$number = $params['from'];
8
$trunk = $params['trunk'];
9
10
// 2 - incoming, 3 - outgoing
11
if ($params['type'] == 3) {
12
$type = 'Исходящий ';
13
$number = $params['to'];
14
}
15
16
if (!$params['was_answered']) { // пропущенный звонок
17
$type .= 'пропущенный ';
18
}
19
20
$newFields = array(
21
'NAME' => $number . ' - ' . $type . 'звонок', //изменяем название
22
'SOURCE_DESCRIPTION' => $trunk, //изменяем поле Дополнительно об источнике
23
);
24
25
return array(
26
'state' => 'success',
27
'data' => $newFields,
28
);
Copied!
Описание полей лида в API Битрикс24. Описание полей контакта в API Битрикс24.
Copy link
Contents