Получение статистики по звонкам, записей разговоров и статусов сотрудников

Через API статистики вы можете в любой момент получать информацию по звонкам в формате CSV, обрабатывать эту информацию, сохранять в своей базе данных или CRM. Также данное API предоставляет возможность скачивать записи звонков, таким образом, вы можете все записи звонков сохранять у себя на диске.

Чтобы начать пользоваться функцией, зайдите в Настройки > API > Статистика и нажмите на кнопку «Подключить услугу».

 

 

Получение списка записей разговоров (в формате CSV)

URL: https://sipuni.com/api/statistic/export

Параметры:

Название

Описание

Значения

user Номер в системе 078332
from С какой даты 30.01.2019
to До какой даты (включительно) 30.01.2019
type Тип звонка 0 — Все звонки
1 — Входящий
2 — Исходящий
3 — Внутренний
state Статус звонка 0 — Все звонки
1 — Пропущенный
2 — Принятый
tree Номер схемы 000658612 — Входящая
000658610 — Исходящая
fromNumber Номер, откуда 7916123456
101
102
...
toNumber Номер, куда 7916123456
101
102
...
toAnswer Номер, кто ответил 7916123456
101
102
...
anonymous Отображать анонимные звонки 0 — Нет
1 — Да
firstTime Только новые клиенты 0 — Нет
1 — Да
hash Контрольная подпись  

 

При формировании контрольной подписи значения полей "склеиваются" в одну строку с разделителем "+" в следующем порядке:

anonymous
firstTime
from
fromNumber
state
to
toAnswer
toNumber
tree
type
user
секретный ключ

От полученной строки вычисляется MD5. 

 

Пример на PHP:

$user = '078332';
$from = date('d.m.Y');
$to = date('d.m.Y');
$type = '0';
$state = '0';
$tree = '';
$fromNumber = '';
$toNumber = '';
$toAnswer = '';
$anonymous = '1';
$firstTime = '0';
$secret = 'ваш ключ интеграции';

$hashString = join('+', array($anonymous, $firstTime, $from, $fromNumber, $state, $to, $toAnswer, $toNumber, $tree, $type, $user, $secret));
$hash = md5($hashString);

$url = 'https://sipuni.com/api/statistic/export';
$query = http_build_query(array(
    'anonymous' => $anonymous,
    'firstTime' => $firstTime,
    'from' => $from,
    'fromNumber' => $fromNumber,
    'state' => $state,
    'to' => $to,
    'toAnswer' => $toAnswer,
    'toNumber' => $toNumber,
    'tree' => $tree,
    'type' => $type,
    'user' => $user,
    'hash' => $hash,
));

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($ch);
curl_close($ch);

header("Content-Disposition: attachment; filename=stat_$from-$to.csv");
echo $output;

 

 

Получение файла записи разговора

URL: https://sipuni.com/api/statistic/record

Параметры:

Название Описание Значения
user Номер в системе 078332
id ID записи Берется из CSV-файла (см. выше)
hash Контрольная подпись  

 

При формировании контрольной подписи значения полей "склеиваются" в одну строку с разделителем "+" в следующем порядке:

id
user
секретный ключ

От полученной строки вычисляется MD5. 

Пример на PHP:

$user = '078332';
$id = '1234567890.123456';
$secret = 'ваш ключ интеграции';

$hashString = join('+', array($id, $user, $secret));
$hash = md5($hashString);

$url = 'https://sipuni.com/api/statistic/record';
$query = http_build_query(array(
    'id' => $id,
    'user' => $user,
    'hash' => $hash,
));

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($ch);
curl_close($ch);

header("Content-Disposition: attachment; filename=$id.mp3");
echo $output;

 

 

Получение списка сотрудников и статусов присутствия (в формате CSV)

URL: https://sipuni.com/api/statistic/operators

Параметры:

Название Описание Значения
user Номер в системе 078332
hash Контрольная подпись  


При формировании контрольной подписи значения полей "склеиваются" в одну строку с разделителем "+" в следующем порядке:

user
секретный ключ

От полученной строки вычисляется MD5. 

Пример на PHP:

$user = '078332';
$secret = 'ваш ключ интеграции';

$hashString = join('+', array($user, $secret));
$hash = md5($hashString);

$url = 'https://sipuni.com/api/statistic/operators';
$query = http_build_query(array(
    'user' => $user,
    'hash' => $hash,
));

$ch = curl_init();
curl_setopt($ch, CURLOPT_URL, $url);
curl_setopt($ch, CURLOPT_POST, 1);
curl_setopt($ch, CURLOPT_POSTFIELDS, $query);
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
$output = curl_exec($ch);
curl_close($ch);

header("Content-Disposition: attachment; filename=operators_$from-$to.csv");
echo $output;

 

Была ли эта статья полезной?
Пользователи, считающие этот материал полезным: 1 из 1