Приблизительное время чтения: 2 минуты
Функционал модуля #
Модуль может определять ответственного за клиента сотрудника и переводить звонок на него. Для автоматического направления входящего звонка на менеджера, ответственного за сущность (контакт/компания/лид) в CRM, нужно настроить сценарий для входящего звонка, где выбрать модуль “REST API – Контакт в CRM“.
Команда contact (POST) #
С помощью команды contact CRM получает информацию о названии клиента и ответственном за него сотруднике по номеру его телефона. Команда вызывается при поступлении входящего звонка.
Команда contact используется для отображения на экране IP-телефона или в софтфоне на ПК сотрудника названия клиента.
В АТС функция автоматического перевода каждого звонка от клиента на ответственного за него менеджера, работает либо для всех внутренних номеров АТС, либо их можно указать в списке модуля “REST API – Контакт в CRM“. Если внутренний номер не найден, то входящий вызов проходит далее по сценарию.
Параметры запроса от АТС к CRM
Имя | Описание | Тип данных | Обязательный параметр |
---|---|---|---|
cmd | тип операции, в данном случае contact | string | да |
phone | номер телефона клиента с которого поступил входящий звонок | string | да |
callid | уникальный id звонка – Asterisk (uniqueid) | string | да |
crm_token | ключ (token) от CRM, установленный в настройках | string | да |
Пример запроса
{
"cmd": "contact",
"phone": "79161112233",
"crm_token": "28mh-bkgfbku-ra3jd",
"callid": "1707376751.3033"
}
Параметры ответа в модуль АТС
Код ответа | Возвращаемое значение | Описание |
---|---|---|
200 | { “contact_name”: “Василий Иванов – Директор ООО Звезда”, “ext”: “603” } | OK |
400 | { “error”: “Invalid parameters” } | Переданы некорректные параметры |
401 | { “error”: “Invalid token” } | Передан неверный ключ (token) |
Разместите код PHP на вашем веб сервере для тестирования запроса
<?php
$jsonData = file_get_contents('php://input');
$data = json_decode($jsonData);
$cmd = $data->cmd; $phone = $data->phone; $crm_token = $data->crm_token; $callid = $data->callid;
if($crm_token == '28mh-bkgfbku-ra3jd' and $phone == '79161112233'){
http_response_code(200);
echo '{"contact_name": "Василий Иванов - Директор ООО Звезда", "ext": "603"}';
} else {
http_response_code(401);
echo '{ "error": "Invalid token" }';
}
//
$log = json_decode($jsonData, true);
if ($log !== null) {
$fp = fopen('results_'.microtime(true).'.json', 'a+');
fwrite($fp, json_encode($log, JSON_UNESCAPED_UNICODE));
fclose($fp);
} else {
http_response_code(400);
echo '{ "error": "Invalid parameters" }';
}
?>