Работа с переадресация на 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"
        } ]]
    }
}

Содержание статьи