Блог Горошко Андрея Bitrix24 Получить список истории звонков voximplant.statistic.get

Получить список истории звонков voximplant.statistic.get

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить список истории звонков voximplant.statistic.get». Мы подготовили подробный разбор принципов работы и развернутые примеры интеграции.

Получить список истории звонков voximplant.statistic.get

Тут может не хватать некоторых данных — дополним в ближайшее время

  • не указаны типы параметров
  • не указана обязательность параметров
  • отсутствуют примеры
  • отсутствует ответ в случае успеха
  • отсутствует ответ в случае ошибки

Метод voximplant.statistic.get Возвращает список истории звонков. Списочный метод. Метод доступен обладателю права Статистика звонков - Просмотр в соответствии с его значением этого права.

ПараметрОписание
FILTERПоля для фильтрации
SORTПо какому полю производится сортировка
ORDERПорядок сортировки (ASC/DESC)

Возвращаемые данные

ПараметрОписание
CALL_IDИдентификатор звонка
IDИдентификатор звонка (для внутренних целей)
CALL_TYPEТип звонка:
— 1 — исходящий,
— 2 — входящий,
— 3 — входящий с перенаправлением на мобильный или стационарный телефон,
— 4 — обратный звонок
CALL_VOTEПо умолчанию — 0. Оценка звонка используется только для внутренней телефонии
COMMENTКомментарий к звонку
PORTAL_USER_IDИдентификатор ответившего оператора (если это тип звонка: 2 — Входящий) или идентификатор позвонившего оператора (если это тип звонка: 1 — Исходящий)
PORTAL_NUMBERНомер, на который поступил звонок (если это тип звонка: 2 — Входящий) или номер, с которого был совершен звонок (1 — Исходящий)
PHONE_NUMBERНомер, с которого звонит абонент (если это тип звонка: 2 — Входящий) или номер, которому звонит оператор (1 — Исходящий)
CALL_DURATIONПродолжительность звонка в секундах
CALL_START_DATEВремя инициализации звонка. При сортировке по этому полю нужно указывать дату в формате ISO-8601
CALL_LOGСтрока содержит ссылку на лог звонка
COSTСтоимость звонка
COST_CURRENCYВалюта звонка (RUR, USD, EUR)
CALL_FAILED_CODEКод вызова (см. таблицу кодов вызова)
CALL_FAILED_REASONТекстовое описание кода вызова (латиница)
CRM_ACTIVITY_IDИдентификатор дела CRM, созданного на основании звонка
CRM_ENTITY_IDИдентификатор объекта CRM, к которому прикреплено дело
CRM_ENTITY_TYPEТип объекта CRM, к которому прикреплено дело, например: LEAD
REST_APP_IDИдентификатор приложения интеграции внешней телефонии
REST_APP_NAMEНазвание приложения интеграции внешней телефонии
REDIAL_ATTEMPTНомер попытки дозвониться (для обратных звонков)
SESSION_IDИдентификатор сессии звонка на стороне Voximplant
TRANSCRIPT_IDИдентификатор расшифровки звонка
TRANSCRIPT_PENDINGY\N. Признак того, что расшифровка будет получена позднее
RECORD_FILE_IDИдентификатор файла с записью звонка

Практический пример и готовый код на PHP

  • JS
    try
    {
    	const response = await $b24.callMethod(
    		'voximplant.statistic.get',
    		{
    			"FILTER": {">CALL_DURATION":60},
    			"SORT": "CALL_DURATION",
    			"ORDER": "DESC",
    		}
    	);
    	
    	const result = response.getData().result;
    	console.info(result);
    }
    catch( error )
    {
    	console.error(error);
    }
  • PHP
    try {
        $response = $b24Service
            ->core
            ->call(
                'voximplant.statistic.get',
                [
                    'FILTER' => ['>CALL_DURATION' => 60],
                    'SORT'   => 'CALL_DURATION',
                    'ORDER'  => 'DESC',
                ]
            );
    
        $result = $response
            ->getResponseData()
            ->getResult();
    
        if ($result->error()) {
            error_log($result->error());
        } else {
            echo 'Success: ' . print_r($result->data(), true);
        }
    
    } catch (Throwable $e) {
        error_log($e->getMessage());
        echo 'Error getting Voximplant statistics: ' . $e->getMessage();
    }
  • BX24.js
    BX24.callMethod(
        'voximplant.statistic.get',
        {
            "FILTER": {">CALL_DURATION":60},
            "SORT": "CALL_DURATION",
            "ORDER": "DESC",
        },
        function(result)
        {
            if(result.error())
                console.error(result.error());
            else
                console.info(result.data());
        }
    );

💡 Экспертное мнение и рекомендации

Советы эксперта по интеграции:

  • Всегда используйте кэширование при частых запросах к voximplant.statistic.get, чтобы разгрузить базу данных.
  • Соблюдайте стандарты PSR при написании обработчиков для «Получить список истории звонков voximplant.statistic.get».
  • Регулярно проводите аудит производительности системы с помощью встроенного монитора 1С-Битрикс.

Похожая задача в бизнесе?

Помогу автоматизировать процессы и внедрить ИИ

Меня зовут Андрей Горошко. Я Full-stack разработчик и эксперт по 1С-Битрикс. Настраиваю CRM Битрикс24, разрабатываю защищенные API и создаю умных ИИ-агентов для автоматизации рутины.

Related Post

Получить поля товара crm.product.fieldsПолучить поля товара crm.product.fields

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Получить поля товара crm.product.fields», проанализируем лучшие практики и

Создать документ складского учета catalog.document.addСоздать документ складского учета catalog.document.add

Каждый PHP-разработчик, работающий с экосистемой Bitrix Framework, должен глубоко понимать работу её ключевых компонентов. В этой статье мы проведем подробный аудит темы «Создать документ складского учета catalog.document.add», проанализируем лучшие практики

Получить настройку регулярного счета по идентификатору crm.invoice.recurring.getПолучить настройку регулярного счета по идентификатору crm.invoice.recurring.get

Оптимизация производительности и безопасности — залог успешного проекта на 1С-Битрикс. Данный материал посвящен практическому применению «Получить настройку регулярного счета по идентификатору crm.invoice.recurring.get». Мы подготовили подробный разбор принципов работы и развернутые