Запросы в amoCRM из кастомизации

Общее описание

Запросы API amoCRM из кастомизации поддерживаются начиная с версии 2.6.0.
При обновлении (в т.ч. на 2.6.0) кастомизатор не изменяется, чтобы не нарушить настроенную клиентом работу интеграции. Поэтому, потребуется обновить кастомизатор вручную.
Из пользовательской кастомизации можно делать запросы в amoCRM (например, создать задачу или сделку) в тех случаях, когда стандартная логика обработки звонка не охватывает специфические случаи.
Для этого в API кастомизатора реализован класс Amo с соответствующими методами. Методы, их аргументы и возвращаемые значения подробно описаны в файле**/opt/itgrix_amo/customizer/README**.
Для работы HTTP-запросов в кастомизаторе нужно, чтобы в системе был установлен модуль php-curl (опционально, без php-curl кастомизатор будет выполнять всё кроме HTTP-запросов).
Проверить можно, выполнив в терминале команду: php -r 'echo curl_version()["version"];' Пример ответа:7.47.0

Создание задачи

В кастомизациях доступен метод Amo::createTask, которая делает запрос в amoCRM на создание задачи. Описание полей задачи в документации API amoCRM.

Пример создания задачи по любому входящему звонку

Добавим вызов функции Amo::createTask в кастомизацию process_call_params (настраивается в файле /opt/itgrix_amo/customizer/actions/process_call_params.php).
Логика модуля Itgrix по умолчанию предполагает создание задачи при регистрации пропущенного звонка. В данном примере будет создана новая задача для любого входящего звонка (в т.ч. отвеченного). Таким образом для пропущенных будет создано две задачи, если не отключить создание задачи по пропущенному в настройках модуля.
1
if ($params['call']['type'] === 2) { // 2 - входящий; 3 - исходящий
2
$phone = $params['call']['from'];
3
4
// Сделаем одного и того же постановщика и ответственного для задачи
5
$responsibleUserId = 5755858;
6
$createdByUserId = 5755858;
7
8
// Установим срок выполнения - 1 час после окончания звонка
9
$deadLine = date_create($params['call']['end_time']);
10
$deadLine->add(new DateInterval('PT1H'));
11
// Пример срока в 1 день:
12
//$deadLine->add(new DateInterval('P1D'));
13
$deadLine = intval($deadLine->format('U'));
14
15
$response = Amo::createTask(array(
16
'text' => 'Обработать звонок от '.$phone,
17
'complete_till' => $deadLine,
18
'created_by' => $createdByUserId,
19
'responsible_user_id' => $responsibleUserId,
20
));
21
22
if ($response === false) {
23
return array(
24
'state' => 'error',
25
'data' => 'Не удалось создать задачу',
26
);
27
}
28
29
// // Для отладки можно вывести ответ amoCRM в лог модуля Itgrix:
30
// $this->logDebug('response: ' . json_encode($response, JSON_UNESCAPED_UNICODE));
31
}
32
33
return array(
34
'state' => 'success',
35
'data' => $params,
36
);
Copied!

Создание сделки

В кастомизациях доступна функция Amo::createLead, которая делает запрос в amoCRM на создание сделки. Подробное описание полей сделки в документации API amoCRM.

Пример создания сделки на любой входящий звонок

Добавим вызов функции Amo::createLead в кастомизацию process_call_params (настраивается в файле /opt/itgrix_amo/customizer/actions/process_call_params.php).
В таком случае будет создана новая сделка (ещё одна), даже если сделка уже создана при регистрации звонка модулем Itgrix.
1
if ($params['call']['type'] === 2) { // 2 - входящий; 3 - исходящий
2
$phone = $params['call']['from'];
3
4
// Сделаем одного и того же постановщика и ответственного для задачи
5
$responsibleUserId = 5755858;
6
$createdByUserId = 5755858;
7
8
// Установим дату-время окончания звонка как дату-время создания сделки
9
$callEndTime = date_create($params['call']['end_time']);
10
$callEndTime = intval($callEndTime->format('U'));
11
12
$response = Amo::createLead(array(
13
'name' => 'Сделка с клиентом '.$phone,
14
'created_by' => $createdByUserId,
15
'responsible_user_id' => $responsibleUserId,
16
'created_at' => $callEndTime,
17
));
18
19
if ($response === false) {
20
return array(
21
'state' => 'error',
22
'data' => 'Не удалось создать сделку',
23
);
24
}
25
26
// // Для отладки можно вывести ответ amoCRM в лог модуля Itgrix:
27
// $this->logDebug('response: ' . json_encode($response, JSON_UNESCAPED_UNICODE));
28
}
29
30
return array(
31
'state' => 'success',
32
'data' => $params,
33
);
Copied!
Last modified 8h ago