Работа с переадресация на IPCR (URL)
Эта статья описывает принцип работы переадресации входящих вызовов на IPCR (URL). Если вы настроили переадресацию входящих вызовов на URL в Личном кабинете или через API, в момент входящего вызова платформа Exolve будет отправлять POST запрос на ваш URL методом getControlCallFollowMe
с данными о вызове. Ваш сервер должен ответить на запрос данными для переадресации входящего вызова. Ниже вы найдете список входных параметром, которые Exolve отправляет на ваш URL, и выходные параметры, который должен передать ваш сервер в ответе для успешной переадресации входящего звонка.
Входные параметры
Параметр | Тип | Описание |
---|---|---|
sip_id | string | купленный номер в приложении, на который поступил вызов |
numberA | string | номер телефона, с которого поступил вызов |
call_sid | string | уникальный идентификатор вызова |
Выходные параметры
Параметр | Тип | Описание |
---|---|---|
sip_id | string | купленный номер в приложении, на который поступил вызов |
redirect_type | int | тип переадресации: 1 - одиночная, 2 - последовательная, 3 - параллельная |
followme_struct | FollowMeStruct | параметры для переадресации входящего вызова |
event_URL | string | URL для отправки уведомлений о ходе звонка |
event_extended | string | Y для получения расширенных логов по звонку, N для получения стандартных логов (применимо только для redirect_type = 1). Если параметр не указан в ответе API клиента, по умолчанию передаются стандартные логи |
client_id | string | сквозной идентификатор вызова от API клиента |
file_to_A | string | ID аудио сообщения, которое будет проигрываться звонящему абоненту. При отсутствии параметра аудио сообщение проигрываться не будет |
file_to_B | string | ID аудио сообщения, которое будет проигрываться вызываемому абоненту. При отсутствии параметра аудио сообщение проигрываться не будет |
masking | string | Y для скрытия номена звонящего абонента, N для транслирование оригинального номера звонящего абонента. Если параметр не указан в ответе API клиента, по умолчанию номер звонящего абонента не скрыт |
answer | string | Y для проигрывания промта в ответном состоянии, N для проигрывания промта в предответном состоянии. Если параметр не указан в ответе API клиента, проигрывание промта осуществляется в предответном состоянии |
FollowMeStruct
Параметр | Тип | Описание |
---|---|---|
i_follow_order | string | порядок следования номера при переадресации вызова |
active | string | Y для переадресации вызова на redirect_number , N для сброса вызова |
name | string | символьное имя номера для переадресации вызова |
redirect_number | string | номер для переадресации вызова |
period | string | always |
period_description | string | описание периода переадресации вызова |
timeout | string | таймаут (в секундах), время ожидания ответа. (смотри примечание) |
dtmf | string | ввод добавочного номера. Список возможных символов: 0-9,*#,w,W, где w - пауза на пол секунды, W - пауза на одну секунду. Пример: “WWW1W3151#” - после ответа IVR клиента, через 3 секунды будет отправлена цифра “1”, далее через 1 секунду отправлена последовательность из 4-х цифр “3151”, # - символ окончания ввода |
Ответ должен соответствовать нотации JsonRPC.
Примеры
Входные параметры:
{
"id": "1",
"jsonrpc": "2.0",
"method": "getControlCallFollowMe",
"params":
{
"sip_id": " 79990557296",
"numberA": "79154368886",
"call_sid": "cald4c209ea-0e84-4a10-856a-6e7eab48e4f5"
}
}
Выходные параметры:
{
"jsonrpc": "2.0",
"id": "1",
"result": {
"redirect_type": 1,
"event_URL": "http://domain/redirect.php",
"client_id": "1235",
"file_to_A": "685",
"file_to_B": "686",
"followme_struct": [1, [
{
"I_FOLLOW_ORDER": "1",
"ACTIVE": "Y",
"NAME": "Manager",
"REDIRECT_NUMBER": "79683347698",
"PERIOD": "always",
"PERIOD_DESCRIPTION": "always",
"TIMEOUT": "15"
} ]]
}
}