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

Оглавление:

В момент входящего вызова на номер клиента платформа МТТ производит POST запрос (c ip - 80.75.132.186) к API клиента методом getControlCallFollowMe по полученному номеру.

Точка входа: https://webapicommon.mtt.ru/index.php

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

Тип запроса: POST

Пример POST запроса к API клиента

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

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

Response

NameTypeDescription

sip_id

string

номер клиента по которому запрашивается алгоритм переадресации вызова. Формат номера 7+10 цифр (E.164), всегда

numberA

string

оригинальный А-номер РФ, номер с которого поступил вызов на "sip_id". Формат номера, тот который пришел на сеть МТТ, может быть и +7/8/7 + 10 цифр

h323_conf_id

string

Уникальный id звонка на платформе МТТ

Пример ответа от API клиента

JSON
{
	"jsonrpc": "2.0",
	"id": "1",
	"result": {
		"redirect_type": 1,
		"event_URL": "http://домен/stub.php",
		"client_id": "1235",
		"file_to_A": "47f51cac1b50fd136334697b11aa406a",
		"file_to_B": "3806efe36d0f1bfccb45ffae8e152c7c",
		"followme_struct": [1, [
		{
			"I_FOLLOW_ORDER": "1",
			"ACTIVE": "Y",
			"NAME": "79684881033",
			"REDIRECT_NUMBER": "79684881033",
			"PERIOD": "always",
			"PERIOD_DESCRIPTION": "always",
			"TIMEOUT": "15"
		} ]]
	}
}
Должен соответствовать нотации JsonRPC.

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

Response

Name

Type

Description

sip_idstringsip_id аккаунта, номер МТТ

redirect_type*

int

Тип переадресации 1 - одиночная, 2- последовательная, 3- параллельная

followme_structструктураСтруктура с параметрами и номерами переадресации

event_URL

string

URL для отправки онлайн уведомлений о ходе звонка*

event_extendedstringПараметр со значениями Y/N для получения расширенных логов по звонку

client_id

string

Сквозной идентификатор вызова от API клиента

file_to_A

string

Аудио сообщение в сторону звонящего пользователя, при отсутствии параметра аудио сообщение проигрываться не будет.

file_id, получаемый методом getCustomerPrompts, ранее загруженного промта через API  метод  createCustomerPrompt,

см. пункт "Premedia API"

file_to_B

string

Аудио сообщение в сторону принимающего вызов клиента, при отсутствии параметра аудио сообщение проигрываться не будет.

file_id, получаемый методом getCustomerPrompts, ранее загруженного промта через API  метод  createCustomerPrompt,

см. пункт "Premedia API"

masking

string

(Y/N)

Y – Скрытие А- номера.

N – Транслирование оригинального А-номера (numberA) если параметр не указан в ответе клиента

answer

string

(Y/N)

Y – проиграть промт в ответном состоянии.

N – проиграть промт в предответном состоянии.

По умолчанию (если параметр не указан в ответе клиента), проигрывание промта осуществляется в предответном состоянии

followme_struct

NameTypeDescription
i_follow_orderstring

Порядок следования номера при перенаправлении вызова

active

string

Активность (Y/N), Y - вызов пройдет на redirect_number, N - вызов отобьется.

name

string

Символьное имя номера для перенаправления вызова

redirect_number

string

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

period

string

Always

period_description

string

Описание периода перенаправления вызова

timeout

string

Таймаут (в секундах), время ожидания ответа. (смотри примечание)*

dtmfstring

Ввод добавочного номера.

Список возможных символов: 0-9,*#,w,W. w - пауза на пол секунды, W - пауза на одну секунду.

Пример: "WWW1W3151#" - после ответа IVR клиента, через 3 секунды будет отправлена цифра "1", далее через 1 секунду отправлена последовательность из 4-х цифр "3151", # - символ окончания ввода.

* Минимальное оптимальное время timeout при redirect_type 3 = 55-60 секунд.

Также необходимо учитывать, что длительность промтов file_to_А и file_to_B не входит во время таймаута.
Таким образом, при наличии промтов, минимальным оптимальным временем будет:
timeout = длительность промта file_to_А + 55-60 секунд + длительность промта file_to_В.


Запрос к API клиента отправляется на URL, структура: 
<схема>://<логин>:<пароль>@<хост>:<порт>/<URL-путь>

В данном случае:

  • в качестве схемы могут быть использованы протоколы http/https;
  • в качестве логина/пароля будут переданы реквизиты аутентификации;
  • хост - доменное имя или IP-адрес сервера API клиента;
  • порт 80/443.

Получив ответ от API клиента, МТТ переводит вызовы согласно полученным параметрам переадресации.


Your Rating:

  • No labels