Запись информации о клиенте в базу, при поднятии трубки оператором

В данной статье рассмотрим возможность получение информации о клиенте из Яндекс при входящем звонке и запись этой информации в базу. Это может быть необходимо фирмам, часто работающим с различными поставщиками, чтобы не искать информацию о клиенте самостоятельно. Опираться будем на Yandex API поиска по организациям.

Для начала попробуем получить информацию об организации по номеру телефона из браузера. Для этого используем следующую строку:

В результирующей строке указано множество данных, которые нам не пригодятся, их нужно отфильтровать. Для начала используем скрипт, чтобы из полученных данных вырезать нужные части. Поскольку данные получаем в JSON-массиве, используем функцию

json_decode:
$name=`/usr/bin/curl "https://search-maps.yandex.ru/v1/?apikey=<apikey>&text=$num&lang=ru_RU&type=biz&results=1"`;
$jarr=json_decode($name, TRUE);

Поскольку использовали структуру с TRUE, то функция вернет массив. Чтобы получить нужные данные, выводим массив для отображения:

var_dump($jarr);

Из полученных данных, нам сейчас интересно поле name, которое мы должны отдать в вывод. Это позволит использовать его в стороннем приложении, которым в нашем случае выступает Asterisk.

print_r($jarr['features'][0]['properties']['name']);

Выводим название компании.

Важно, вывод из скрипта должен быть только один, иначе к переменной в диалплане, присваивается все, что выводится в скрипте, следовательно все тестовые выводы удаляются/комментируются.

Проверяем простым звонком на custom номер (чтобы не дергать каждый раз API, можно на время тестов текст просто внести в переменную).

exten => 0101,1,Set(name=${SHELL(/usr/bin/php -f /opt/get_name.php 74959898533)})
same => n,NoOp(${name})
same => n,Macro(hangupcall,)

Тесты проведены, теперь необходимо доработать скрипт, для отображения названия клиента оператору, при вызове. И при ответе оператором на звонок, записывать данные в базу (используем для этих целей поле userfield).

Вызывать скрипт будем при входящем вызове от провайдера, создав свой контекст, переменную имени клиента необходимо делать наследуемой, для доступа к ней от наследуемых каналов.

[from-trunk-pre]
exten => _XXXX.,1,Set(__name=${SHELL(/usr/bin/php -f /opt/get_name.php ${CALLERID(num)})})
same => n,Set(CALLERID(name)=${name}: ${CALLERID(num)})
same => n,Goto(from-trunk,${EXTEN},1)

Направление вызова может быть любым, однако, чтобы запустить запись в базу именно при поднятии трубки оператором,  Необходимо в Dial при вызове оператора добавить опцию M, в которой указать необходимый контекст макроса, например macro-call-answered. Это необходимо, если вы хотите записать в базу также того, кто поднял трубку первым.

Возможно в вашей системе уже будет нечто подобное, если вы используете FreePBX (macro-auto-blkvm), но следует помнить, что срабатывает он, только если вызов до оператора дошел через очередь, либо ринг-группу.

В сам макрос необходимо поместить строку вида:

exten => s,1,ExecIf($["${name}" != ""]?Set(CDR(userfield)=Компания: ${name}| Оператор: ${EXTTOCALL}))

Либо дополнить ее нужной вам информацией из запроса, в таком случае в скрипте нужно будет их возвращать в одну строку (можно также записывать в базу всю строку, а затем ее обрабатывать далее).

Также скрипт необходимо дополнить проверкой на наличие результата:

$num=$argv[1];

$name=`/usr/bin/curl "https://search-maps.yandex.ru/v1/?apikey=<apikey>&text=$num&lang=ru_RU&type=biz&results=1"`;
	if ($jarr['properties']['ResponseMetaData']['SearchResponse']['found'] != 0) {
	print_r($jarr['features'][0]['properties']['name']);
};

Если название не получено, переменная в диалплане будет пустой.