На стороне внешней системы реализуйте http-сервер, который будет получать запрос о входящих звонках от Виртуальной АТС, а взамен отправлять инструкцию по их дальнейшей обработке. Запрос — обращение на определенный URL с параметрами вызова, вида

http://crm11.getsandbox.com/crm_integration?cdr_id=123&start_time=1200&input_result=None&numa=74952345678&numb=74951234567

где:

http://crm11.getsandbox.com/crm_integration — URI обработчика запросов Виртуальной АТС
cdr_id — идентификатор звонка
start_time — время начала звонка
input_result — введенные звонящим коды DTMF
numa — номер звонящего
numb — номер, на который звонят

Сервер должен в течение 5 секунд прислать успешный (со статусом 200) http-ответ, в котором будет инструкция для Виртуальной АТС — JSON-структура (примеры ниже). Если ответ не будет получен, по истечении 5 секунд звонок будет направлен на операцию «Ошибка http-запроса», на которой необходимо настроить алгоритм обработки звонков для таких случаев (если операцию не настроить, звонок будет потерян).

Примеры ответов:

Переадресация + информационное сообщение

Используется, когда внешняя система включает сценарий переадресации звонка на другой номер (номера) с воспроизведением сообщения пользователю. Например:

{"phones: ["74959876543", "79039691644"], "message_name": "10sec.mp3"}

{"text": "Приветствую", "phones": ["74959876543", "79039691644"]}

{"message_name": "10sec.mp3"}

{"text": "Привет"}

{"phones": ["74959876543", "79039691644"]}

{"phones: ["74959876543", "79039691644"], "message_name": "10sec.mp3", "operator_message": "op_hint.mp3"}

Проигрывание сообщения сотруднику перед началом разговора может быть воспроизведено как через настройку операции в Личном кабинете; так и через ответ внешней системы. Оperator_message может быть двух видов: operator_media — воспроизвести фрагмент из базы файлов или operator_text — преобразовать сообщение в голос. Если одновременно диктуются две инструкции operator_media и operator_text, то воспроизведено будет operator_media. При этом ответ внешней системы имеет приоритет над настройкой сообщения сотруднику в Личном кабинете.

Инструкция о переходе внутри сценария Виртуальной АТС

{"returned_code" : код возврата}

Используйте, когда необходимо направить обработку вызова по одному из привязанных сценариев. Можно выбрать несколько кодов возврата, обрабатываемых последовательно.

Настройка Виртуальной АТС

В сценарии Виртуальной АТС создайте операцию интерактивной обработки вызова.

В этом сценарии необходимо задать:

URI, по которому связываться с обработчиком запросов;
метод отправки запроса: GET или POST;
параметры, которые необходимо включать в запрос (cdr_id, start_time, input_result, numa, numb);
длину кода доступа, если требуется получать от звонящего DTMF.

Также, если будет использоваться инструкция о переходе внутри сценария Виртуальной АТС, указывайте связанные операции. Тогда система будет направлять звонок по связанной ветке внутри сценария.