Page tree
Skip to end of metadata
Go to start of metadata

Оглавление:

getServiceHistoryByCustomer - данный метод предназначен для получения истории звонков по всему лицевому счету (по всем номерам).

Точка подключения: https://webapicommon.mtt.ru/index.php

Авторизация: Basic Auth

Метод: POST

Входные параметры

Name

Type

Description

type*string
NameTypeDescription
incomingarrayИстория входящих звонков
missedarrayИстория пропущенных звонков
dialedarrayИстория исходящих звонков
forwardedarrayИстория переадресованных вызовов
record_count*

int

Количество возвращаемых записей (не более 1000)

order

string

Сортировка - возможные значения desc (по умолчанию) и asc

filter

string

Номер, для фильтрации вызовов по "cli" и "cld"

date_to*

string

Конечная дата  и время (YYYY-MM-DD HH24:Mi-SS)

date_from*

string

Начальная дата и время (YYYY-MM-DD HH24:Mi-SS)

customer_name*

string

customer_name

* обязательные параметры

Выходные массивы

Name

Type

Description

incoming

array

История входящих звонков

missed

array

История пропущенных звонков

dialed

array

История исходящих звонков

forwarded

array

История переадресованных вызовов

Необязательные параметры

При  отсутствующих параметрах date_from и  date_to будут выданы результаты работы за полчаса от текущего момента.

В любом случае, количество строк в результате будет ограниченно 1000.

Выходные параметры

NameTypeDescription

cli

string

А-номер

cld

string

Номер МТТ либо номер для переадресации (В-номер)

customer_local_time

string

Время платформы

connect_time

string

Время звонка

charged_time

Integer

Сумма charged_time всех плеч агрегированного вызова, для которых charged_amount > 0

charged

Float

Стоимость вызова

destination

string

Направление вызова

h323_conf_id

string

Идентификатор записи, по которому можно получить ссылку на скачивание

h323_incoming_conf_id

string

Идентификатор записи входящего вызова, h323_conf_id в массиве incoming

curr

string

Валюта клиента

disconnect_cause

Integer

Причина завершения последнего плеча вызова

setup_time_ms

Integer

время установления соединения в мс

account_id

string

Номер клиента, номер МТТ

used_quantity

Integer

Общее время соединений в ходе сессии, измеряется в секундах

h323_conf_id

string

Идентификатор записи, по которому можно получить ссылку на скачивание

voice_record_exist

Boolean

Наличие записанного разговора, false - нет записи, true - запись есть (сформировалась)

cli - в общем случае телефонный номер с которого поступил вызов,  cld - номер на который поступил вызов.

В общем случае, за исключением forwarded, account_id и  cli будут совпадать. 

В случае forwarded в cli будет номер с которого поступил звонок переадресованный на номер cld.

Пример

JSON
{
  "jsonrpc": "2.0",
  "id": "1",
  "method": "getServiceHistoryByCustomer",
  "params":{
    "type": "dialed",
    "customer_name": "110011256",
    "date_from": "2017-09-14 16:01:05",
    "date_to": "2017-09-14 16:01:10",
    "record_count": 20
  }
}

Успешный ответ

JSON
{
    "jsonrpc": "2.0",
    "id": "1",
    "result": {
        "dialed": [
            {
                "cli": "79066899000",
                "cld": "74959333223",
                "customer_local_time": "2017-09-14 16:01:09",
                "connect_time": "2017-09-14 16:01:09",
                "charged_time": "119",
                "charged": 2.48,
                "destination": "Россия фикс.",
                "h323_conf_id": "2B23D937 BD9BCF86 E89D407D 44DA0162",
                "h323_incoming_conf_id": "AC4D7D28 994C11E7 88C6AC16 2D8CE148",
                "curr": "RUB",
                "setup_time_ms": "4581",
                "disconnect_cause": "16",
                "account_id": "74951349387",
                "used_quantity": "119",
                "voice_record_exist": false
            },
            {
                "cli": "79262049647",
                "cld": "79775133876",
                "customer_local_time": "2017-09-14 16:01:08",
                "connect_time": "2017-09-14 16:01:08",
                "charged_time": "60",
                "charged": 0,
                "destination": "Россия фикс.",
                "h323_conf_id": "C2D68D0D 584EEE9A 2697A64B 9A0A0F53",
                "h323_incoming_conf_id": "92E21D30 994C11E7 8FD7AC16 2D8CE148",
                "curr": "RUB",
                "setup_time_ms": "8575",
                "disconnect_cause": "16",
                "account_id": "883140584982783",
                "used_quantity": "35",
                "voice_record_exist": false
            },
            {
                "cli": "74993018267",
                "cld": "79104080307",
                "customer_local_time": "2017-09-14 16:01:07",
                "connect_time": "2017-09-14 16:01:07",
                "charged_time": "0",
                "charged": 0,
                "destination": "Россия фикс.",
                "h323_conf_id": "7EFDAECB 8A53BF45 63F48E8E 273A7F83",
                "h323_incoming_conf_id": "92E26222 994C11E7 8FD7AC16 2D8CE148",
                "curr": "RUB",
                "setup_time_ms": "2000",
                "disconnect_cause": "17",
                "account_id": "883140587615452",
                "used_quantity": "0",
                "voice_record_exist": false
            }
        ],
        "success": 1
    }
}

Не успешный ответ

JSON
{
    "jsonrpc": "2.0",
    "id": "3",
    "error": {
        "code": -32602,
        "message": "Invalid params",
        "data": "Invalid begin date"
    }
}

Комментарий:

  • cli - откуда
  • cld - куда

Your Rating:

  • No labels