Links
Comment on page

Добавление данных о звонке в тег новой сделки

При обработке звонков модулем Itgrix могут быть созданы новый контакт и новая сделка. По умолчанию сущности получают один тег - Itgrix.
С помощью кастомизации можно добавить теги с информацией о звонке, например, направление (Входящий или Исходящий) и статус (Отвеченный или Пропущенный).
Т.к. статус звонка будет известен только в конце звонка, то и добавление тегов нужно добавить в кастомизацию параметров регистрации звонка (process_call_params).
В этой кастомизации известно:
  • Является ли сущность (контакт/сделка) новой (т.е. создана ли в процессе обработки этого звонка) - $params['entity_new']. Значение true, если новая, иначе false.
  • Какой тип у созданной сущности - $params['entity_type']. Для контакта значение 1, для сделки значение 3.
  • ID сущности - $params['entity_id'].
Исходя из этих данных реализуем такой алгоритм:
  • Теги будем устанавливать только для новых сущностей (которые созданы модулем Itgrix).
  • Нужно получить ID сделки, у которой нужно обновить теги.
    • Если в кастомизацию пришла сущность типа сделка, то возьмем её ID из параметров.
    • Если же это контакт, тогда нужно получить данные этого контакта и взять ID первой связанной с ним сделки (у нового контакта может быть только одна сделка). Для этого воспользуемся функцией Amo::getContact (поставляется вместе с модулем в файле /opt/itgrix_amo/customizer/lib/crm.php). Формат возвращаемых данных описан в документации amoCRM по работе с контактами.
  • Осталось обновить теги у найденной сделки. Для этого воспользуемся функцией Amo::updateLead (поставляется вместе с модулем в файле /opt/itgrix_amo/customizer/lib/crm.php). Формат данных описан в документации amoCRM по работе со сделками.
В результате у сделки будут теги Itgrix, Входящий и Отвеченный:

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

Пример кода для добавления тегов в созданную сделку (файл /opt/itgrix_amo/customizer/actions/process_call_params.php):
$this->logDebug('params: '.json_encode($params));
//
// Получить созданную сделку и добавить в нее теги
//
if ($params['call_full']['entity']['is_new'] === true) {
$this->logInfo('Get created lead and modify its tag...');
$entityId = $params['call_full']['entity']['id'];
$leadId = '';
if ($params['call_full']['entity']['type'] === 'lead') { // сделка (lead)
$leadId = $entityId;
} else if ($params['call_full']['entity']['type'] === 'contact') { // контакт
$entityData = Amo::getContact($entityId);
if ($entityData === false) {
return array(
'state' => 'error',
'data' => 'failed to get contact ID '.$entityId,
);
}
if (empty($entityData['_embedded']['items'])) {
return array(
'state' => 'error',
'data' => 'found no contact with ID '.$entityId,
);
}
$leads = $entityData['_embedded']['items'][0]['leads'];
if (!empty($leads)) {
$leadId = $leads['id'][0];
}
}
if ($leadId === '') {
$this->logInfo('Lead was not created, do nothing');
} else {
$tags = array('Itgrix');
if ($params['call_full']['channel']['type'] === 'incoming') {
array_push($tags, 'Входящий');
} else {
array_push($tags, 'Исходящий');
}
if ($params['call_full']['channel']["was_answered"] === true) { // true - отвеченный
array_push($tags, 'Отвеченный');
} else {
array_push($tags, 'Пропущенный');
}
$this->logInfo(sprintf("Set tags %s to lead ID '%s'...",
json_encode($tags, JSON_UNESCAPED_UNICODE), $leadId));
$updateResult = updateLead($leadId, array('tags' => $tags));
if ($updateResult === false) {
return array(
'state' => 'error',
'data' => 'failed to update lead ID '.$leadId,
);
}
}
}
$this->logDebug('return params: '.json_encode($params));
return array(
'state' => 'success',
'data' => $params,
);