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

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

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

Настройка.

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

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

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

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

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

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

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

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

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

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

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

https://api.telegram.org/botТокен_вашего_бота/getUpdates

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

Для вызова скрипта будем использовать 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 и другой логики маршрутизации звонков.

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