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

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

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

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

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

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

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

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

• добавить комментарий в лид/контакт;

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

По завершению звонка есть возможность изменить/обновить поля в сущности CRM.

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

В веб-интерфейсе настройки модуля (http://<Asterisk IP>:8077/config):

1. Установите галочку "Включить кастомизацию".

2. Установите галочку на пункте "полей сущности".

2. Отредактируйте файл кастомизации.

Параметры сущности, которые можно изменять, описаны в статье.

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

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

// Нужно вернуть массив [обновляемое_поле = значение]
​
$newFields = array();
​
// Пример: изменяем имя лида
$type = 'Входящий ';
$number = $params['from'];
$trunk = $params['trunk'];
​
// 2 - incoming, 3 - outgoing
if ($params['type'] == 3) {
    $type = 'Исходящий ';
    $number = $params['to'];
}
​
if (!$params['was_answered']) { // пропущенный звонок
    $type .= 'пропущенный ';
}
​
$newFields = array(
    'NAME' => $number . ' - ' . $type . 'звонок', //изменяем название
    'SOURCE_DESCRIPTION' => $trunk, //изменяем поле Дополнительно об источнике
);
​
return array(
    'state' => 'success',
    'data'  => $newFields,
);

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