Page History

Описание:
Нотификация об изменении структуры РМ в ЛК МТТ Бизнес.
Параметры нотификации:

Пример нотификации:

{
    "event": "vpbxNotifications",
    "result": {
        "eventType": "numbersChanged"
    }
}

Описание:
Нотификация об изменении структуры РМ в ЛК МТТ Бизнес. Возникает при изменении настроек в ЛК МТТ Бизнес.
Параметры нотификации:

Пример нотификации:

{
    "event": "vpbxNotifications",
    "result": {
        " eventType ": "workplacesChanged"
    }
}

Описание:
Производит инициализацию вызова с использованием пользовательского РМ или терминала и вызов указанного в запросе номера. Алгоритм работы ВАТС:

1. ВАТС инициирует вызов на рабочее место Оператора (параметр callerId).
2. Дожидается принятия вызова оператором ("поднятия трубки"). Если Оператор не отвечает в течении одной минуты, то дальнейшая работа метода прерывается.
3. После успешного ответа Оператора, ВАТС инициирует второй исходящий вызов на номер абонента (параметр calleeId) и производит объединение вызовов. 

Необходимо учесть последовательность: второе плечо (вызов на calleeId) осуществляется только после ответа «первого плеча» (SIP ID РМ callerId).

Параметр callerId обычно "подтягивается" из CRM системы по данным текущего рабочего места Оператора настроенного в CRM системе.

Адрес для отправки запроса:

https://openapi.mtt.ru

Параметры:
POST/ transferCallmakeCall

Примечание: для получения списка РМ необходимо воспользоваться запросом GET /workPlacesInfo.

Пример запроса:
{
"params": {
"calleeId": "89219462761",
"callerId": "883140582526566"
}
}

curl --location --request POST 'https://openapi.mtt.ru/makeCall' \
--header 'Authorization: Bearer MMRLZJU5NTETMTNHZI0ZNZIYLWJHOTGTNJY1M2ZMM2YZNMYX' \
--header 'Content-Type: application/json' \
--data-raw '{
"params":
{ "callerId":"883140777777777", "calleeId": "89999999999" }
}'

Пример ответа:

{
    "result": {
        "call": {
            "id": "7NKe6!8fa1FMSlc6ypZdb1GSV6ZN@10.133.51.137"
        },
        "success": 1
    }
}

Описание:
Завершает плечо вызова, что позволяет продолжить обработку по стандартному маршруту, который настроен в ЛК ВАТС МТТ Бизнес. Данной командой можно прекратить «парковку» вызова, так как в момент парковки создаётся дополнительное плечо.

Адрес для отправки запроса:

https://openapi.mtt.ru

Параметры:
POST/ terminateCall

Пример запроса:

{
    "params": {
        "call": {
            "id": "b9111e52e5d011e9aec7ac162d8cda20_00015D95DB072BFC_7022A1~2o",
            "tag": "133609"
        },
        "transportId": "10.133.51.137:5070"
    }
}

Пример ответа:

{
    "result": {
        "success": 1
    }
}

Описание:
Выполняет перевод (трансфер) вызова на указанный номер (SIP ID). Данный метод используется для управления вызовами и осуществления альтернативного распределения вызовов, взамен настроенного в ЛК МТТ Бизнес. Возможно два варианта использования:

• перевод уже отвеченного вызова во время разговора. Пока не ответит номера Абонента Б, в линии будет играть мелодия ожидания.
• перевод ещё не отвеченного вызова. Вызывающий абонент при этом слышит обычные гудки (КПВ). При реализации кейса "маршрутизация на персонального менеджера", сначала необходимо получить нотификацию с информацией о вызове и затем выполнить данный метод для его перевода на необходимое рабочее место. 

Адрес для отправки запроса:

https://openapi.mtt.ru

Параметры:
POST/transferCall

Пример запроса:

{
    "params": {
        "call": {
            "id": "b9111e52e5d011e9aec7ac162d8cda20_00015D95DB072BFC_7022A1~2o",
            "tag": "133609"
        },
        " calleeId ": "883140582526566",
        "transportId": "10.133.51.137:5070"
    }
}

Пример ответа:

{
    "result": {
        "success": 1
    }
}

Описание:
Устанавливает или снимает внешний номер(а) с парковки. Если у внешнего номера активирована «парковка», то при поступлении входящего вызова он не распределяется по логике ВАТС МТТ Бизнес, а на 5 секунд устанавливается на «парковку». Нотификация об этом передаётся по API во внешнее приложение. В течении этих 5 секунд по API ожидается команда перераспределения входящего вызова. Если в течении 5 секунд команды на перенаправление вызова не последовало, то задействуется ранее настроенная для номера логика распределения вызов в ВАТС МТТ Бизнес. При помощи данного метода реализуется кейс «маршрутизация на персонального менеджера».

Адрес для отправки запроса:

https://openapi.mtt.ru

Параметры:
POST / setParkingNumbers
Параметры нотификации

Пример запроса:

{
    "params": {
        "numbers": [
            "880023213",
            "880034344"
        ],
        "isParking": true
    }
}

Пример ответа:

{
    "success": 1
}

Описание:
Сообщение о начале входящего вызова.
При поступлении входящего вызова на внешнюю нумерацию пользователя, вызов «паркуется» на 5 сек для принятия решения о его последующем перераспределении. При «парковке» создается отдельное «плечо» вызова, которое передается в сообщении.
Сообщение предназначено для:

• выполнения необходимых проверок, анализа параметров и создания сущностей.

• перенаправления вызова на РМ пользователя ВАТС.
  выдачи команды на прекращение «парковки» и отправки вызова по маршруту, который настроен в логике распределения вызовов ВАТС МТТ Бизнес.

  
  Пример нотификации:

  Code Block
  language java theme Midnight title JSON linenumbers true
  { "event": "callNotifications", "result": { "callInfo": { "call": { "id": "c166e238a4c211ea9d373863bb43daf8_00015ED635780FC7~1o", "tag": "hswdfry52vmykfla____.o" }, "callee": { "accountId": "74996497803", "centrexId": "67821426", "displayId": "74996497803", "displayName": "", "forwarderList": [], "id": "74996497803" }, "caller": { "accountId": "78124241500@pstn", "displayId": "78124241500", "forwarderList": [], "id": "78124241500" }, "startTime": "2020-06-02 11:18:16", "state": "trying", "transportId": "10.133.33.136:5073", "type": "incoming" } } }

  
  

Описание: Сообщение о начале исходящего вызова.

Пример нотификации:

{
    "event": "callNotifications",
    "result": {
        "callInfo": {
            "call": {
                "id": "SDfe2n901-b510751695c9e53584301f0c0e8d98c9200@127.0.0.1",
                "tag": "sdfe2n901-281028329"
            },
            "callee": {
                "displayId": "+79219462761",
                "forwarderList": [],
                "id": "+79219462761"
            },
            "caller": {
                "accountId": "883140582526566",
                "centrexId": "48212857",
                "displayId": "78005560251",
                "forwarderList": [],
                "id": "78005560251"
            },
            "startTime": "2020-06-24 15:01:45",
            "state": "trying",
            "transportId": "10.133.51.137:5070"

,
            "type": "outgoing"
        }
    }
}

Описание: Сообщение о перенаправлении вызова на РМ пользователя МТТ Бизнес.
Пример нотификации:

{
    "event": "callNotifications",
    "result": {
        "callInfo": {
            "call": {
                "id": "SDfe2n901-b510751695c9e53584301f0c0e8d98c9200@127.0.0.1",
                "tag": "sdfe2n901-281028329"
            },
            "callee": {
                "displayId": "+79219462761",
                "forwarderList": [],
                "id": "+79219462761"
            },
            "caller": {
                "accountId": "883140582526566",
                "centrexId": "48212857",
                "displayId": "

78005560251",
       

         "forwarderList": 

[

],
    

    "

id": "

78005560251"

 },
    

   "startTime": "2020-06-

24 

15:

01:

45",
            "state": "

showing",
            "transportId": "10.133.

51.

137:

5070",
            "type": "

outgoing"
        

}
    

}

}

Описание: Вызов завершён в рамках ВАТС МТТ Бизнес.

Примеры нотификации:

Успешный входящий вызов завершён на стороне пользователя МТТ Бизнес.

{
    "displayIdevent": "79219462761callNotifications",
    "forwarderListresult": \[\],
    "id": "79219462761"
{
     \},
   "callercallInfo": \{
    "accountId": "883140582526566",
    "centrexId": "48212857",
    "displayId": "78005560251",
    "forwarderListcall": \[\],{
    "id": "78005560251"
   \},
   "startTime": "2020-06-24 15:01:55",
   "stateid": "connectedc166e238a4c211ea9d373863bb43daf8_00015ED635780FC7~2o",
       "transportId": "10.133.51.137:5070",
     "type": "outgoing"
  \}
 \}
\}
\\

*Описание:*
Вызов завершён в рамках ВАТС МТТ Бизнес.
*Пример нотификации:*
Успешный входящий вызов завершён на стороне пользователя МТТ Бизнес.
\{
 "event": "callNotifications" },
 "result": \{
    "callInfo": \{
   "call": \{
    "id": "c166e238a4c211ea9d373863bb43daf8_00015ED635780FC7~2o",
    "tag": "hswddry52ykfcb2a____.o"
 {
      \},
   "callee": \{
    "accountId": "883140777828305",
    "centrexId": "67821426",
    "displayIdid": "883140777828305scheme_prd100275045-3885981",
         "display_name": "74996497803",
    "extensionId": "",
    "forwarderList": \[\{ }
      "id": "an_prd100275045-3881851"
          \}],
         \{
       "id": "scheme_prd100275045-3885981883140777828305"
     \}
       },
     \],
       "idcaller": "883140777828305"
{
        \},
   "caller": \{
    "accountId": "78124241500@pstn",
                "displayId": "78124241500",
                "forwarderList": \[\],
                "id": "78124241500"
         \   },
            "duration": 4,
            "reason": "Answer leg disconnected",
 disconnected",
            "reasonCode": null,
            "state": "finished",
            "transportId": "10.133.33.136:5073",
            "type": "incoming"
        \}
 \   }
\}
\\

Успешный

исходящий

вызов

завершён

на

стороне

вызываемого

абонента.

{
    "event": "callNotifications",
    "result": \{
: {
        "callInfo": \{
            "call": \{
                "id": "SDfe2n901-b510751695c9e53584301f0c0e8d98c9200@127.0.0.1",
                "tag": "sdfe2n901-281028329"
            \},
            "callee": \{
     "displayId": "79219462761",
           "displayId": "79219462761",
                "forwarderList": \[\],
                "id": "79219462761"
   \         },
            "caller": \{
                "accountId": "883140582526566",
                "centrexId": "48212857",
                "displayId": "78005560251",
                "forwarderList": \[\],
                "id": "78005560251"
     \       },
            "duration": 3,
            "reason": "Originate leg disconnected",
            "reasonCode": null,
            "state": "finished",
            "transportId": "10.133.51.137:5070",
            "type": "outgoing"
       \ }
 \   }
\}