voximplant.statistic.get
Получить список истории звонков
Описание
Метод voximplant.statistic.get возвращает список звонков из статистики телефонии.
Параметры
FILTER
object
необязательный
Объект для фильтрации в формате {"field_1": "value_1", ... "field_N": "value_N"}.
Смотрите ниже список доступных полей для фильтрации.
Поддерживаемые операторы в ключе фильтра:
- ! — не равно
- >= — больше либо равно
- > — больше
- <= — меньше либо равно
- < — меньше
- >< — между (диапазон, включительно)
- !>< — не между (вне диапазона)
- ? — поиск по строке
- = — равно, точное совпадение (используется по умолчанию)
- != — не равно
- % — LIKE, поиск по подстроке
- !% — NOT LIKE, поиск по подстроке
По умолчанию — без фильтрации
SORT
string
необязательный
Поле сортировки.
Используются те же поля, что и в списке полей для фильтрации, кроме CALL_TYPE.
По умолчанию — без сортировки
ORDER
string
необязательный
Направление сортировки.
Возможные значения:
- ASC — сортировка по возрастанию
- DESC — сортировка по убыванию
По умолчанию — без сортировки
start
integer
необязательный
Параметр постраничной навигации.
Размер страницы результатов — 50 записей.
Чтобы получить вторую страницу, передайте 50; третью — 100 и так далее.
Формула:
start = (N - 1) * 50, где N — номер страницы
Доступные поля для фильтрации
ID
integer
необязательный
Внутренний идентификатор записи статистики
CALL_ID
string
необязательный
Идентификатор звонка
EXTERNAL_CALL_ID
string
необязательный
Идентификатор звонка на стороне внешней АТС/интеграции
CALL_CATEGORY
string
необязательный
Категория звонка
PORTAL_USER_ID
integer
необязательный
Идентификатор пользователя.
Идентификатор можно получить методом user.get
PORTAL_NUMBER
string
необязательный
Номер линии, через который шел звонок
PHONE_NUMBER
string
необязательный
Номер абонента
CALL_TYPE
integer
необязательный
Тип звонка.
Возможные значения:
- 1 — исходящий
- 2 — входящий
- 3 — входящий с перенаправлением
- 4 — обратный звонок
- 5 — информационный звонок
CALL_DURATION
integer
необязательный
Длительность звонка в секундах
CALL_START_DATE
datetime
необязательный
Дата и время начала звонка в формате ISO-8601 с указанием часового пояса
CALL_LOG
string
необязательный
URL лога звонка
CALL_RECORD_URL
string
необязательный
URL записи звонка
CALL_VOTE
integer
необязательный
Оценка звонка.
Возможные значения:
- 1, 2, 3, 4, 5
Если оценка отсутствует — 0 или null
COST
double
необязательный
Стоимость звонка
COST_CURRENCY
string
необязательный
Валюта стоимости звонка
CALL_FAILED_CODE
string
необязательный
Код результата звонка.
Возможные значения:
- 200 — успешный звонок
- 304 — пропущенный звонок
- 603 — отклонено
- 603-S — вызов отменен
- 403 — запрещено
- 404 — неверный номер
- 486 — занято
- 484 — направление недоступно
- 503 — направление недоступно
- 480 — временно недоступен
- 402 — недостаточно средств
- 423 — заблокировано
- OTHER — не определено
CALL_FAILED_REASON
string
необязательный
Текст причины/результата звонка
CRM_ENTITY_TYPE
string
необязательный
Тип объекта CRM.
Возможные значения:
- CONTACT — контакт
- COMPANY — компания
- LEAD — лид
CRM_ENTITY_ID
integer
необязательный
Идентификатор объекта CRM из CRM_ENTITY_TYPE
CRM_ACTIVITY_ID
integer
необязательный
Идентификатор CRM-дела звонка
REST_APP_ID
integer
необязательный
Идентификатор приложения
REST_APP_NAME
string
необязательный
Название приложения
TRANSCRIPT_ID
integer
необязательный
Идентификатор расшифровки звонка
TRANSCRIPT_PENDING
string
необязательный
Признак ожидания расшифровки.
Возможные значения:
- Y — расшифровка ожидается
- N — расшифровка доступна или отсутствует
SESSION_ID
integer
необязательный
Идентификатор сессии на стороне телефонии
REDIAL_ATTEMPT
integer
необязательный
Номер попытки дозвона (для callback-сценариев)
COMMENT
string
необязательный
Комментарий к звонку
RECORD_DURATION
integer
необязательный
Длительность файла записи звонка
Примеры запроса
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"FILTER":{"ID":[1,7],">=CALL_START_DATE":"2025-01-01T00:00:00+03:00"},"SORT":"ID","ORDER":"ASC"}' \
https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/voximplant.statistic.get
curl -X POST \
-H "Content-Type: application/json" \
-H "Accept: application/json" \
-d '{"FILTER":{"ID":[1,7],">=CALL_START_DATE":"2025-01-01T00:00:00+03:00"},"SORT":"ID","ORDER":"ASC","auth":"**put_access_token_here**"}' \
https://**put_your_bitrix24_address**/rest/voximplant.statistic.get
// This snippet is an ES module: top-level await requires type="module" or a bundler.
// $b24 is an already-initialized SDK instance (see the SDK "Get started" guide).
import { Text } from '@bitrix24/b24jssdk'
import type { B24Frame, ISODate } from '@bitrix24/b24jssdk'
declare const $b24: B24Frame
// Shape of each CallStatRecord returned in result[]
type CallStatRecord = {
ID: string
PORTAL_USER_ID: string
PORTAL_NUMBER: string
PHONE_NUMBER: string
CALL_ID: string
EXTERNAL_CALL_ID: string | null
CALL_CATEGORY: string
CALL_LOG: string | null
CALL_DURATION: string
CALL_START_DATE: ISODate
CALL_RECORD_URL: string | null
CALL_VOTE: string | null
COST: string
COST_CURRENCY: string
CALL_FAILED_CODE: string
CALL_FAILED_REASON: string
CRM_ENTITY_TYPE: string
CRM_ENTITY_ID: string
CRM_ACTIVITY_ID: string
REST_APP_ID: string | null
REST_APP_NAME: string | null
TRANSCRIPT_ID: string | null
TRANSCRIPT_PENDING: string
SESSION_ID: string | null
REDIAL_ATTEMPT: string | null
COMMENT: string | null
RECORD_DURATION: string | null
RECORD_FILE_ID: number | null
CALL_TYPE: string
}
try {
// voximplant.statistic.get returns a single page (max 50 records). For the whole result set
// use a list helper: $b24.actions.v2.callList.make() returns every record as one
// array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
// NOTE: the list helpers do not accept `order` (it is excluded from their params, so
// passing it is a TS error) — keep this call.make + `start` variant when sort matters.
const response = await $b24.actions.v2.call.make<CallStatRecord[]>({
method: 'voximplant.statistic.get',
params: {
FILTER: {
ID: [1, 7],
'>=CALL_START_DATE': '2025-01-01T00:00:00+03:00',
},
SORT: 'ID',
ORDER: 'ASC',
start: 0,
},
requestId: Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
} else {
const result = response.getData()!.result
console.info('Fetched call statistics:', result.length, 'records', result)
}
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
<!-- Load the SDK (UMD build); it is exposed as the global B24Js -->
<script src="https://unpkg.com/@bitrix24/b24jssdk@1/dist/umd/index.min.js"></script>
<script>
async function fetchCallStatistics() {
try {
// Initialize the SDK inside a Bitrix24 frame
const $b24 = await B24Js.initializeB24Frame()
// voximplant.statistic.get returns a single page (max 50 records). For the whole result set
// use a list helper: $b24.actions.v2.callList.make() returns every record as one
// array, $b24.actions.v2.fetchList.make() yields them in chunks (async generator).
// NOTE: the list helpers do not accept `order` (it is excluded from their params, so
// passing it is a TS error) — keep this call.make + `start` variant when sort matters.
const response = await $b24.actions.v2.call.make({
method: 'voximplant.statistic.get',
params: {
FILTER: {
ID: [1, 7],
'>=CALL_START_DATE': '2025-01-01T00:00:00+03:00',
},
SORT: 'ID',
ORDER: 'ASC',
start: 0,
},
requestId: B24Js.Text.getUuidRfc4122()
})
// The payload is available only on a successful response
if (!response.isSuccess) {
console.error(response.getErrorMessages().join('; '))
return
}
const result = response.getData().result
console.info('Fetched call statistics:', result.length, 'records', result)
} catch (error) {
// Thrown on transport or SDK failures (AjaxError, SdkError, etc.)
console.error(error)
}
}
document.addEventListener('DOMContentLoaded', fetchCallStatistics)
</script>
from b24pysdk.errors import BitrixAPIError, BitrixSDKException
filter = {
"ID": [
1,
7,
],
">=CALL_START_DATE": "2025-01-01T00:00:00+03:00",
}
try:
bitrix_response = client.voximplant.statistic.get(
filter=filter,
sort="ID",
order="ASC",
).response
result = bitrix_response.result
print(result)
except BitrixAPIError as error:
print(
"Ошибка Bitrix API",
f"error: {error.error}",
f"error_description: {error.error_description}",
sep="\n",
)
except BitrixSDKException as error:
print(f"Ошибка Bitrix SDK: {error.message}")
except Exception as error:
print(f"Непредвиденная ошибка: {error}")
try {
$response = $b24Service
->core
->call(
'voximplant.statistic.get',
[
'FILTER' => [
'ID' => [1, 7],
'>=CALL_START_DATE' => '2025-01-01T00:00:00+03:00'
],
'SORT' => 'ID',
'ORDER' => 'ASC'
]
);
$result = $response
->getResponseData()
->getResult();
echo 'Success: ' . print_r($result, true);
processData($result);
} catch (Throwable $e) {
error_log($e->getMessage());
echo 'Error fetching statistics: ' . $e->getMessage();
}
BX24.callMethod(
"voximplant.statistic.get",
{
FILTER: {
ID: [1, 7],
'>=CALL_START_DATE': '2025-01-01T00:00:00+03:00'
},
SORT: 'ID',
ORDER: 'ASC'
},
function(result)
{
if (result.error())
{
console.error(result.error(), result.error_description());
}
else
{
console.log(result.data());
}
}
);
require_once('crest.php');
$result = CRest::call(
'voximplant.statistic.get',
[
'FILTER' => [
'ID' => [1, 7],
'>=CALL_START_DATE' => '2025-01-01T00:00:00+03:00'
],
'SORT' => 'ID',
'ORDER' => 'ASC'
]
);
echo '<PRE>';
print_r($result);
echo '</PRE>';
// client и ctx уже созданы — см. раздел «SDK для Go»
res, err := client.Core().Call(ctx, "voximplant.statistic.get", b24.Params{
"FILTER": b24.Params{
"ID": []int{1, 7},
">=CALL_START_DATE": "2025-01-01T00:00:00+03:00",
},
"SORT": "ID",
"ORDER": "ASC",
}, b24.WithIdempotent())
if err != nil {
return fmt.Errorf("voximplant.statistic.get: %w", err)
}
var items []struct {
ID b24.ID `json:"ID"`
PortalUserID b24.ID `json:"PORTAL_USER_ID"`
PortalNumber string `json:"PORTAL_NUMBER"`
PhoneNumber string `json:"PHONE_NUMBER"`
CallID string `json:"CALL_ID"`
CallCategory string `json:"CALL_CATEGORY"`
}
if err := json.Unmarshal(res.Result, &items); err != nil {
return fmt.Errorf("разбор ответа: %w", err)
}
for _, it := range items {
fmt.Println(it.ID, it.PortalUserID)
}
Ответ
HTTP-статус: 200
{
"result": [
{
"ID": "1",
"PORTAL_USER_ID": "1",
"PORTAL_NUMBER": "reg133788",
"PHONE_NUMBER": "+79638835976",
"CALL_ID": "11018129443EB80D.1754478570.11438214",
"EXTERNAL_CALL_ID": null,
"CALL_CATEGORY": "external",
"CALL_LOG": "https://storage-gw-ru-02.voximplant.com/voximplant-logs/2025/08/06/YTdjNmMxYWMyNzNmZDA2NTAwZTlkODYzMWExODN06ODM0MkU1MjY2OEIxMkMuMTc1NDQ3ODUyMC4xMTQzODIxNV8xODUuMTY0LjE0OC4xMzIubG9n?sessionid=3841557776",
"CALL_DURATION": "0",
"CALL_START_DATE": "2025-08-06T14:08:40+03:00",
"CALL_RECORD_URL": "",
"CALL_VOTE": null,
"COST": "0.0000",
"COST_CURRENCY": "RUR",
"CALL_FAILED_CODE": "603-S",
"CALL_FAILED_REASON": "Decline self",
"CRM_ENTITY_TYPE": "CONTACT",
"CRM_ENTITY_ID": "275",
"CRM_ACTIVITY_ID": "7739",
"REST_APP_ID": null,
"REST_APP_NAME": null,
"TRANSCRIPT_ID": null,
"TRANSCRIPT_PENDING": "N",
"SESSION_ID": "3841557776",
"REDIAL_ATTEMPT": null,
"COMMENT": null,
"RECORD_DURATION": null,
"RECORD_FILE_ID": null,
"CALL_TYPE": "1"
},
{
"ID": "7",
"PORTAL_USER_ID": "1269",
"PORTAL_NUMBER": "3",
"PHONE_NUMBER": "79062195047",
"CALL_ID": "externalCall.716f1cb73def9700a23842adf9c4c568.1773130779",
"EXTERNAL_CALL_ID": null,
"CALL_CATEGORY": "external",
"CALL_LOG": null,
"CALL_DURATION": "95",
"CALL_START_DATE": "2026-03-10T11:19:38+03:00",
"CALL_RECORD_URL": null,
"CALL_VOTE": "5",
"COST": "0.0000",
"COST_CURRENCY": "",
"CALL_FAILED_CODE": "200",
"CALL_FAILED_REASON": "",
"CRM_ENTITY_TYPE": "CONTACT",
"CRM_ENTITY_ID": "797",
"CRM_ACTIVITY_ID": "7943",
"REST_APP_ID": "3",
"REST_APP_NAME": "Документация по REST API",
"TRANSCRIPT_ID": "1",
"TRANSCRIPT_PENDING": "N",
"SESSION_ID": null,
"REDIAL_ATTEMPT": null,
"COMMENT": null,
"RECORD_DURATION": null,
"RECORD_FILE_ID": 9079,
"CALL_TYPE": "2"
}
],
"total": 2,
"time": {
"start": 1773141841,
"finish": 1773141841.595178,
"duration": 0.5951778888702393,
"processing": 0,
"date_start": "2026-03-10T14:24:01+03:00",
"date_finish": "2026-03-10T14:24:01+03:00",
"operating_reset_at": 1773142441,
"operating": 0
}
}
Возвращаемые данные
result
array
Массив записей статистики. Состав записей зависит от условий FILTER.
Пустой массив означает, что нет записей, соответствующих условиям FILTER
total
integer
Общее количество записей в выборке
next
integer
Смещение следующей страницы (если есть)
time
time
Информация о времени выполнения запроса
Обработка ошибок
HTTP-статус: 403
{
"error": "ACCESS_DENIED",
"error_description": "Access denied!"
}
| Код | Описание | Значение |
|---|---|---|
ACCESS_DENIED |
Access denied! | Недостаточно прав на просмотр статистики звонков |

