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

Оглавление:

При входящем вызове на номер МТТ звонящий слышит приветствие и в автоматическом или ручном режиме вводит добавочный номер (extension),   платформа детектирует добавочный, отправляет в API клиента POST запрос на получение номера переадресации, пример запроса:

JSON
{
    "id": "1",
    "jsonrpc": "2.0",
    "method": "getcontrolcallfollowme",
    "params": {
        "h323_conf_id": " BC5F236C 5AD211E9 81BA5CB9 01FED6FC",
        "numberA": "79154368886",
        "sip_id": "79586488002",
        "extension": "0004"
    }
}

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

NameTypeDescription

h323_conf_id

string

Уникальный id звонка на платформе МТТ, используется для последующего получения записи разговора

sip_id

string

sip_id аккаунта, арендованный номер МТТ

numberA

string

номер с которого был совершен звонок

extension

string

добавочный номер [0000, 9999]

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

NameTypeDescription

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

NameTypeDescription

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 клиента

JSON
{
    "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".


Your Rating:

  • No labels