При входящем вызове на номер МТТ звонящий слышит приветствие и в автоматическом или ручном режиме вводит добавочный номер (extension), платформа детектирует добавочный, отправляет в API клиента POST запрос на получение номера переадресации, пример запроса:
{
"id": "1",
"jsonrpc": "2.0",
"method": "getcontrolcallfollowme",
"params": {
"h323_conf_id": " BC5F236C 5AD211E9 81BA5CB9 01FED6FC",
"numberA": "79154368886",
"sip_id": "79586488002",
"extension": "0004"
}
}
Входные параметры
| Name | Type | Description |
|---|---|---|
h323_conf_id | string | Уникальный id звонка на платформе МТТ, используется для последующего получения записи разговора |
sip_id | string | sip_id аккаунта, арендованный номер МТТ |
numberA | string | номер с которого был совершен звонок |
extension | string | добавочный номер [0000, 9999] |
Выходные параметры
| Name | Type | Description |
|---|---|---|
client_id | string | Сквозной идентификатор вызова от API клиента (например можно использовать как номер заказа) |
followme_struct | структура | Структура с параметрами и номерами переадресации |
event_extended | string | Параметр со значениями Y/N для получения расширенных логов по звонку, описание см. в разделе онлайн уведомления. |
event_URL | string | URL для отправки онлайн уведомлений о ходе звонка |
file_to_A | string | id промпта для стороны A, загружаются на сторону МТТ по средствам функционала Premedia API |
file_to_B | string | id промпта для стороны B, загружаются на сторону МТТ по средствам функционала Premedia API |
masking | string | Скрытие номера звонящего: (Y/N) Y – Скрытие А- номера, в этом случае принимающий вызов абонент (REDIRECT_NUMBER) увидит в качестве номера звонящего sip_id N – Транслирование оригинального А-номера (numberA), значение по умолчанию. |
redirect_type | int | Тип переадресации 1 – одиночная (переадресация на 1 номер), 2- последовательная (переадресация на несколько номеров), 3- параллельная (переадресация на несколько номеров одновременно) |
followme_struct
| Name | Type | Description |
|---|---|---|
i_follow_order | string | Порядок следования номера при перенаправлении вызова |
active | string | Активность (Y/N), Y - вызов пройдет на REDIRECT_NUMBER, N - вызов отобьется. |
name | string | Символьное имя номера для перенаправления вызова |
redirect_number | string | Номер для перенаправления вызова |
period | string | Always |
period_description | string | Описание периода перенаправления вызова |
timeout | string | Таймаут (в секундах), время ожидания ответа. (смотри примечание) |
dtmf | string | Ввод добавочного номера. Используется при наличии IVR на redirect_number Список возможных символов: 0-9,*#,w,W. w - пауза на пол секунды, W - пауза на одну секунду. Пример: "WWW1W3151#" - после ответа IVR клиента, через 3 секунды будет отправлена цифра "1", далее через 1 секунду отправлена последовательность из 4-х цифр "3151", # - символ окончания ввода. |
Пример ответа от API клиента
{
"jsonrpc": "2.0",
"id": "1",
"result": {
"redirect_type": 1,
"event_URL": "http://workreviewer.ru/event.php",
"event_extended": "Y",
"client_id": "1235",
"file_to_A": "b49a7c80b736d5ea5285c467385cd3e8",
"file_to_B": "a49a7c80b737d5ea5285c467385cs3e9",
"masking": "Y",
"followme_struct": [1, [
{
"I_FOLLOW_ORDER": 1,
"PERIOD": "always",
"PERIOD_DESCRIPTION": "Always",
"TIMEOUT": "30",
"ACTIVE": "Y",
"NAME": "redirect",
"REDIRECT_NUMBER": "79586488002"
}
]
]
}
}
Сценарий дальнейшего установления соединения
При получении данного ответа от API клиента, платформа проиграет звонящему промт file_to_A. По окончанию проигрывания, инициирует вызов на redirect_number. При ответе, принимающей стороне проиграется промт file_to_B. По окончании проигрывания, произойдет соединение абонентов. У принимающей стороны в качестве АОН звонящего абонента высветится значение параметра sip_id запроса getcontrolcallfollowme. Также, будут отправлены расширенные event-уведомления, так как "event_extended": "Y".