Александр Мисюрин
12.08.2020
759598

Статистика по звонкам из API Zadarma. Отчеты на почту и в Telegram

В данной статье рассмотрим получение статистики затрат на связь по периоду времени из API Zadarma и формирование из нее таблицы, с последующей отправкой на почту и в Telegram. Скачиваем и устанавливаем пакет git библиотеки для подключения к API Zadarma: git clone cd user-api-v1 composer install Полученные файлы (autoload.php, папки vendor/, lib/) копируем в папку, в […]

API Zadarma статистика по звонкам, отчеты на почту и в Telegram

В данной статье рассмотрим получение статистики затрат на связь по периоду времени из API Zadarma и формирование из нее таблицы, с последующей отправкой на почту и в Telegram.

Тестирование проводилось на системе CentOs 6.9, Asterisk 13, FreePBX 13, PHP 5.6.40

Скачиваем и устанавливаем пакет git библиотеки для подключения к API Zadarma:

git clone

cd user-api-v1

composer install

Для работы с API необходимо иметь работающую виртуальную АТС, а также запросить ключ API. Есть ограничение на включение АТС, если вы не пополняли счет более чем три месяца, также после пополнения может потребоваться перелогиниться в личном кабинете.

Полученные файлы (autoload.php, папки vendor/, lib/) копируем в папку, в которой лежит исполняемый скрипт (можно не копировать, а подключать как есть, если нужно ☺).

Получение API ключа и пароля: https://my.zadarma.com/api/

Включение виртуальной АТС: https://my.zadarma.com/mypbx/

Запросим статистику по времени за час:

#!/usr/bin/php -q
<?php

include_once 'vendor/autoload.php';
use Zadarma_API\Api;

define('USE_SANDBOX', true);
define('KEY', 'your_key');
define('SECRET', 'your_secret');

$api = new Api(KEY, SECRET, USE_SANDBOX);

$result = $api->getStatistics('2020-08-03 11:00:00','2020-08-03 12:00:00');
echo print_r($result);

?>
Статистика за час времени в виде объекта

Полученную статистику необходимо привести в удобный для чтения вид. Добавим ее в таблицу csv:

$fp = fopen('/usr/src/test/statistic.csv', 'w');
fputcsv($fp, array('Время вызова','Исходящий номер','SIP', 'Номер направления', 'Регион направления', 'Время разговора (сек)', 'Цена за минуту', 'Стоимость', 'Статус'));

foreach ($statistic as $value) {
	$date=$value['callstart'];
	$cnum=$value['from'];
	$sip=$value['sip'];
	$dnum=$value['to'];
	$region=$value['description'];
	$billseconds=$value['billseconds'];
	$cost=$value['cost'];
	$billcost=$value['billcost'];
	$disposition=$value['disposition'];
fputcsv($fp, array("$date", "$cnum", "$sip", "$dnum", "$region", "$billseconds","$cost", "$billcost", "$disposition"));	
}
fclose($fp);
Файл таблицы

Таблица сформирована, теперь добавим к запросу внесение дат, будем собирать статистику за вчерашний день изменяем начальный запрос):

$datestart=date("Y-m-d H:i:s", mktime(0, 0, 0, date("m"), date("d")-1, date("Y")));
$dateend=date("Y-m-d H:i:s", mktime(23, 59, 59, date("m"), date("d")-1, date("Y")));
$result = $api->getStatistics(“$datestart”, “$dateend”);
При необходимости дату можно ввести иную, например, по запросу из веб-интерфейса или из бота в Telegram. В данном примере рассмотрим простой вывод вчерашней статистики.

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

$sendmail=`/bin/echo "Статистика за период $datestart - $dateend" -a /usr/src/test/statistic.csv [email protected]`;

Далее отправка в Telegram группу:

Подключение бота Telegram к Asterisk рассматривалось в этой статье.

Отправлять будем через curl, для этого используем код:

$curl = curl_init();
curl_setopt_array($curl, [
    CURLOPT_URL => "https://api.telegram.org/bot11XXXX:XXXXXX/sendDocument?caption=Статистика+за+период:+C+$datestart по $dateend&chat_id=-XXXXXXXXX»,
    CURLOPT_RETURNTRANSFER => true,
    CURLOPT_HTTPHEADER => [
        'Content-Type: multipart/form-data'
    ],
    CURLOPT_POST => true,
    CURLOPT_POSTFIELDS => [
        'document' => curl_file_create('/usr/src/test/statistic.csv', 'application/csv', 'statistic.csv')
    ]
]);
$data = curl_exec($curl);
curl_close($curl);
Файл в чате
Отправка статистики, просмотр файла (для теста номера изменены)

Скрипт помещаем на выполнение в крон, каждое утро в 08:00

0 8 * * * /usr/bin/php –f /usr/src/test/stat.php
Кейсы внедрения
Asterisk от VoxLink
Узнайте, какие крупные компании уже используют Asterisk в работе.
Скачать
Подписаться
Уведомить о
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 сим-карты и настроить маршрутизацию вызовов по наиболее выгодному тарифу. Всё это позволяет экономить с первых минут пользования станцией.