Дмитрий Барышников
29.05.2020
31867

Уведомление о пропущенных из карточки Битрикс24

В данной статье мы рассмотрим механизм парсинга карточки клиента в Битрикс24 для отправки уведомления о пропущенных вызовах в telegram, при помощи API Битрикс и входящих вебхуков. Данный процесс может работать даже без каких-либо модуль коннекторов, все делается только на основе API. Настройка. Для начала мы создадим входящий вебхук в самом Битрикс. Для этого перейдём в […]

В данной статье мы рассмотрим механизм парсинга карточки клиента в Битрикс24 для отправки уведомления о пропущенных вызовах в telegram, при помощи API Битрикс и входящих вебхуков.

Данный процесс может работать даже без каких-либо модуль коннекторов, все делается только на основе API.

Информер! Тестирование проводилось на системе FreePBX 13+ Asterisk 13 + Centos 7

Настройка.

Для начала мы создадим входящий вебхук в самом Битрикс. Для этого перейдём в раздел Приложения à Вебхуки и нажмём кнопку, добавить вебхук.

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

Также прочитать информация об интеграциях при помощи вебхуков, вы можете в статье Интеграция Bitrix CRM с Asterisk средствами модуль коннектора ViStep с открытым исходным кодом

Создание вебхука

Т.к. мы будем отправлять уведомления в telegram, создадим своего бота и добавим его в группу.

Ищем в телеграм бота @BotFather. Обратимся к боту командой /newbot. Таким образом мы запросим создать нам бота.

Сперва дадим ему название.

Потом username, только обязательно в конце должно быть bot. Например AsteriskBot.

В конце концов нам скажут, что бот создан и вышлют нам его api ключ:

Создание бота

Открываем диалог с ботом и пишем команду /start, чтобы он начал функционировать.

Теперь создаем отдельную группу, в которую добавляем нашего бота. После добавления, в чат пишем команду /join @AsteriskBot.

Выясняем чат ID нашей группы. Идём в браузер и вбиваем там следующую строку

https://api.telegram.org/botТокен_вашего_бота/getUpdates
Идентификация Чат-ID

Далее остается подключить скрипт, который будет парсить карточки клиента, на наличие контакта, и отсылать о нём информацию в телеграмм.

Для вызова скрипта будем использовать AGI. В директории /var/lib/asterisk/agi-bin/ создаем скрипт btx2400.php и вносим туда следующее

#!/usr/bin/php -q
<?php
require('phpagi.php');
$agi = new AGI();
$cid = $argv[1]; // ловим номер клиента
$phone = substr($cid, 1);
$phone = "7$phone";
$token = "Токен_Бота";
$chat_id = "ID_чата_телеграмм";
$crm_id = "ip_адрес_или_домен_битрикса";
$webhook = "ID_вебхука";
 
// обращаемся к API Битрикс по карточкам
$user_json = "https://$crm_id/rest/1/$webhook/crm.contact.list.json?filter[PHONE]=$phone&select[]=TITLE&select[]=NAME&select[]=LAST_NAME&select[]=SECOND_NAME&select[]=ASSIGNED_BY_ID";
$btx1 = curl_init();
curl_setopt ($btx1, CURLOPT_URL,$user_json);
curl_setopt ($btx1, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt ($btx1, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt ($btx1, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.6) Gecko/20070725 Firefox/2.0.0.6");
curl_setopt ($btx1, CURLOPT_TIMEOUT, 60);
curl_setopt ($btx1, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt ($btx1, CURLOPT_RETURNTRANSFER, 1);
$bitrix_contact = curl_exec ($btx1);
curl_close($btx1);
 
//Парсим массив данных
$user_arr = json_decode($bitrix_contact, true);
print_r($user_arr);
 
$name = $user_arr['result'][0]['NAME'];
//$email = $user_arr['result'][0]['EMAIL'];
// $title = $user_arr['result'][0]['TITLE'];
//$mobile = $user_arr['result'][0]['PERSONAL_MOBILE'];
$last_name = $user_arr['result'][0]['LAST_NAME'];
$second_name = $user_arr['result'][0]['SECOND_NAME'];
$assignedid = $user_arr['result'][0]['ASSIGNED_BY_ID'];
$id = $user_arr['result'][0]['ID'];
$tg_phone = 'Пропущенный звонок от - '.$phone.'';
$tg_fullname = 'Ф.И.О. - '.$name.' '.$second_name.' '.$last_name.' '.$assignedid.' '; //'.$email.' Контакт фио
 
###########END
 
####Start-2
 
//Парсим информацию ответственного менеджера из API Битрикс
 
$options=array("ssl"=>array("verify_peer"=>false,"verify_peer_name"=>false));
$manager_json = file_get_contents('https://'.$crm_id.'/rest/1/'.$webhook.'/user.get.json?filter[ID]='.$assignedid.'', false, stream_context_create($options));
 
$manager_arr = json_decode($manager_json, true);
print_r($manager_arr);
 
$mname = $manager_arr['result'][0]['NAME'];
//$email = $manager_arr['result'][0]['EMAIL'];
$mlast_name = $manager_arr['result'][0]['LAST_NAME'];
$msecond_name = $manager_arr['result'][0]['SECOND_NAME'];
$mid = $manager_arr['result'][0]['ID'];
 
$mtg_fullname = 'Ответственный менеджер - '.$mname.' '.$msecond_name.' '.$mlast_name.''; //'.$email.';
 
// Отправляем сообщение  в телеграмм
$btm = curl_init();
curl_setopt ($btm, CURLOPT_URL,'https://api.telegram.org/bot'.$token.'/sendMessage?chat_id='.$chat_id.'&parse_mode=html&text="'.$tg_phone.' %0A '.$tg_fullname.'%0A'.$mtg_fullname./*$tg_link.*/'"');
curl_setopt ($btm, CURLOPT_SSL_VERIFYHOST, 0);
curl_setopt ($btm, CURLOPT_SSL_VERIFYPEER, 0);
curl_setopt ($btm, CURLOPT_PROXY, "socks5://Ваш_прокси");
curl_setopt ($btm, CURLOPT_USERAGENT, "Mozilla/5.0 (Windows; U; Windows NT 5.1; en-US; rv:1.8.1.6) Gecko/20070725 Firefox/2.0.0.6");
curl_setopt ($btm, CURLOPT_TIMEOUT, 60);
curl_setopt ($btm, CURLOPT_FOLLOWLOCATION, 1);
curl_setopt ($btm, CURLOPT_RETURNTRANSFER, 1);
curl_setopt($btl, CURLOPT_VERBOSE, true); #дебаг курла
$bitrix_manager = curl_exec ($btm);
curl_close($btm);
 
?>
Информер! Обращаю ваше внимание, что для отправки в телеграмм я использовал прокси сервер, для надежной доставки сообщения

Отправку уведомлений, я буду проводить из очереди. Для этого перезапишем exten h для контекста ext-queues

[ext-queues]
exten => h,1,NoOp( ================== lost call in queues ================== )
same => n,ExecIf($["${FORWARD_CONTEXT}"!="from-internal"]?AGI(btx2400.php, ${CALLERID(num)} )

Т.е. в AGI мы передаем только значение номера звонящего. Результатом этого будет следующее сообщение в телеграм.

Сообщение о пропущенном

Разумеется применть данный скрипт можно не только в контексте ext-queues, но также например по неответу конкретных внутренних, например когда настроено определение ответственного менеджера и вызов сразу попадает на внутренний телефонный номер, в обход IVR и другой логики маршрутизации звонков.

На этом настройка отправки уведомлений завершена.

Подписаться
Уведомить о
guest
0 комментариев
Межтекстовые Отзывы
Посмотреть все комментарии

Остались вопросы?

Я - Виталий Шелест, менеджер компании Voxlink. Хотите уточнить детали или готовы оставить заявку? Укажите номер телефона, я перезвоню в течение 3-х секунд.

VoIP оборудование


ближайшие курсы

10 доводов в пользу Asterisk

Распространяется бесплатно.

Asterisk – программное обеспечение с открытым исходным кодом, распространяется по лицензии GPL. Следовательно, установив один раз Asterisk вам не придется дополнительно платить за новых абонентов, подключение новых транков, расширение функционала и прочие лицензии. Это приближает стоимость владения станцией к нулю.

Безопасен в использовании.

Любое программное обеспечение может стать объектом интереса злоумышленников, в том числе телефонная станция. Однако, сам Asterisk, а также операционная система, на которой он работает, дают множество инструментов защиты от любых атак. При грамотной настройке безопасности у злоумышленников нет никаких шансов попасть на станцию.

Надежен в эксплуатации.

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

Гибкий в настройке.

Зачастую возможности Asterisk ограничивает только фантазия пользователя. Ни один конструктор шаблонов не сравнится с Asterisk по гибкости настройки. Это позволяет решать с помощью Asterisk любые бизнес задачи, даже те, в которых выбор в его пользу не кажется изначально очевидным.

Имеет огромный функционал.

Во многом именно Asterisk показал какой должна быть современная телефонная станция. За многие годы развития функциональность Asterisk расширилась, а все основные возможности по-прежнему доступны бесплатно сразу после установки.

Интегрируется с любыми системами.

То, что Asterisk не умеет сам, он позволяет реализовать за счет интеграции. Это могут быть интеграции с коммерческими телефонными станциями, CRM, ERP системами, биллингом, сервисами колл-трекинга, колл-бэка и модулями статистики и аналитики.

Позволяет телефонизировать офис за считанные часы.

В нашей практике были проекты, реализованные за один рабочий день. Это значит, что утром к нам обращался клиент, а уже через несколько часов он пользовался новой IP-АТС. Безусловно, такая скорость редкость, ведь АТС – инструмент зарабатывания денег для многих компаний и спешка во внедрении не уместна. Но в случае острой необходимости Asterisk готов к быстрому старту.

Отличная масштабируемость.

Очень утомительно постоянно возвращаться к одному и тому же вопросу. Такое часто бывает в случае некачественного исполнения работ или выбора заведомо неподходящего бизнес-решения. С Asterisk точно не будет такой проблемы! Телефонная станция, построенная на Asterisk может быть масштабируема до немыслимых размеров. Главное – правильно подобрать оборудование.

Повышает управляемость бизнеса.

Asterisk дает не просто набор полезных функций, он повышает управляемость организации, качества и комфортности управления, а также увеличивает прозрачность бизнеса для руководства. Достичь этого можно, например, за счет автоматизации отчетов, подключения бота в Telegram, санкционированного доступа к станции из любой точки мира.

Снижает расходы на связь.

Связь между внутренними абонентами IP-АТС бесплатна всегда, независимо от их географического расположения. Также к Asterisk можно подключить любых операторов телефонии, в том числе GSM сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.