Виртуальная атс ростелеком инструкция

Для подключения номера телефона к Виртуальной АТС необходимо в личном кабинете Ростелеком получить учетные данные для регистрации на SIP-сервере:

• Адрес SIP-сервера Ростелеком

• Логин

• Пароль

Чтобы начать принимать вызовы в Виртуальной АТС, необходимо выполнить следующие действия:

1. В личном кабинете Ростелеком перейдите в раздел «Управление доменом».

2. На Рабочем столе выберите пункт «Пользователи» и нажмите на кнопку «Добавить пользователя».

3. В открывшейся форме заполните поля «Отображаемое имя», «Логин», «Пароль» и «Внутренний номер». Нажмите на кнопку «Создать пользователя».

   ---

   Новый пользователь будет отображен в списке пользователей.

4. Выберите пункт «Маршрутизация» и подпункт «Правила маршрутизации».

5. Выберите первую строку таблицы с правилами. В столбце «Перевод на» измените значение, выбрав в выпадающем меню опцию «Пользователя». В той же строке выберите Пользователя, созданного в пункте 3.

6. Подключиться к системе управления вАТС.
   Для этого понадобится логин и пароль, который был получен на этапе регистрации.

7. В Разделе «Городские номера» нажмите кнопку «Добавить номер» для начала создания записи.

8. В открывшемся окне укажите номер с символом «+», который планируете подключить. Все Российские номера должны быть длиной 11 цифр и начинаться с 7-ки. Например, для добавления номера (495) XXX-12-34 необходимо в поле «Номер» добавить +7495XXX1234. В поле «Комментарий» можно добавить информацию о том, что это номер Ростелеком или информацию о том, для каких целей планируете использовать его, и нажмите кнопку «Сохранить» внизу страницы. Остальные поля можете оставить без изменений. Они понадобятся для настройки обработки входящих вызовов (правила, приветствия, голосовые меню, запись разговоров и т.д.) и распределения звонков между подключенными пользователями. К этому вопросу необходимо будет вернуться после успешного подключения номера к вАТС.

9. В разделе «SIP-провайдеры» нажмите кнопку «Добавить SIP-провайдера» для создания записи.

10. В открывшемся окне заполняем поля, используя регистрационные данные, сформированные в личном кабинете Ростелеком, а также Логин и Пароль для Пользователя, созданного в пункте 3. Обязательно нажимаем кнопку «Сохранить», чтобы добавить запись.

    В поле «Название» можно указать название оператора или другую информацию, которая поможет идентифицировать подключение
    В поле «SIP-сервер» указываем выданный вам домен от Ростелеком
    В поля «Пользователь» добавляем логин
    В поле «Пароль» добавляем пароль

    ---

    Для регистрации на сервере Ростелеком и приема входящих звонков, необходимо переключатель «Регистрация» включить. В поле «Городской номер» выберите номер, который был добавлен в разделе «Городские номера».

    ---

    Если планируете использовать подключение для исходящих вызовов, то оставляем переключатель «Использовать для исходящих» во включенном положении.
    «Формат набираемых номеров» выбираем исходя из требований провайдера. Если провайдер ожидает наборы, начинающиеся с 8 для звонков по России и 8-10 для международных звонков, то выбираем формат МГТС.
    «Приоритет» отвечает за очередность выбора провайдеров для исходящих вызовов. В первую очередь вызовы будут направляться на провайдера с самым высоким приоритетом.
    При использовании подключения для исходящих, в случае с Ростелеком, формат набираемых номеров должен быть «MGTS», «Логин» указываем в поле «Пользователь FROM»и «SIP-сервер» указываем в поле «Домен FROM».

    ---

    После нажатия кнопки «Сохранить», при успешной регистрации на сервере Ростелеком, должен измениться «Статус регистрации». Если статус не изменился в течение 10 минут, то имеет смысл проверить правильность указания регистрационных данных (Логин/Пароль).

Время на прочтение6 мин

Количество просмотров22K

Картинка с сайта: habr.com

Современный бизнес воспринимает городские телефоны как устаревшую технологию: сотовая связь обеспечивает мобильность и постоянную доступность сотрудников, соцсети и мессенджеры являются более легким и быстрым каналом общения. Чтобы не отставать от своих конкурентов, офисные АТС все больше становятся похожи на них: они переходят в облака, управляются через web-интерфейс и интегрируются с другими системами через API. В этом посте мы расскажем, какие есть функции у API виртуальной АТС «Ростелекома» и как через него работать с основными функциями виртуальной АТС.

Основная задача API виртуальной АТС «Ростелекома» —  взаимодействие с CRM или сайтами компаний. Например, на API реализованы виджеты «обратный звонок» и «звонок с сайта» для основных систем управления: WordPress, Bitrix, OpenCart. API позволяет:

• Получать информацию, уведомлять о статусе и совершать вызовы по запросу из внешней системы;
• Получить временную ссылку на запись разговора;
• Управлять и получать параметры ограничений у пользователей;
• Получить информацию о пользователе вирутальной АТС;
• Запросить истории списаний и начислений по вызовам;
• Выгрузить журнал звонков.

Как работает API

Интеграционный API и внешняя система взаимодействуют между собой при помощи HTTP-запросов. В личном кабинете администратор задает адреса, куда должны приходить запросы к API и куда должны отправляться запросы от API. У внешней системы должен быть публичный адрес, доступный из интернета, с установленным SSL-сертификатом.

Картинка с сайта: habr.com

Также в личном кабинете администратор домена может ограничить по IP источники запросов при обращении к API. 

Получаем информацию о пользователях виртуальной АТС 

Чтобы получить список пользователей или групп, нужно отправить в виртуальной АТС запрос методом /users_info.

{
        "domain":"example.ru"
}

В ответ придет список, который можно сохранить.

{
"result":0,
"resultMessage":"",
"users":[
                           {
                            "display_name":"test_user_1",
                            "name":"admin",
                            "pin":^_^quotʚquot^_^,
                           "is_supervisor":true,
                            "is_operator":false,
                            "email":"test_user_1@mail.gov","recording":1
                             },
                            {
                            "display_name":"test_user_2",
                            "name":"test",
                            "pin":^_^quotʿquot^_^,
                            "is_supervisor":true,
                            "is_operator":false,
                            "email":"",
                           "recording":1
                            }
              ],
"groups":
              [
                            {
                            "name":"testAPI",
                            "pin":^_^quotǴquot^_^,
                            "email":"Ivanov@mail.gov",
                            "distribution":1,
                           "users_list":[^_^quotʚquot^_^,^_^quotʿquot^_^]
                            }
              ]

В данном методе передается два массива. Один с пользователями домена, один с группами домена. У группу также есть возможность указать электронную почту, которая будет передаваться в запросе.

Обрабатываем информацию о входящем вызове

Подключение корпоративной телефонии к различным системам CRM экономит время сотрудников, которые взаимодействуют с клиентами, и ускоряет обработку входящих звонков. Например, по звонку от текущего клиента CRM может открыть его карточку, а из CRM можно отправить вызов клиенту и соединить его с сотрудником.

Чтобы получить информацию о вызовах через API, нужно использовать метод /get_number_info, который формирует список вызовов с информацией о группе, в которую вызов распределяется. Предположим, что на номер виртуальной АТС поступил входящий вызов с номера 1234567890. Тогда от АТС отправится запрос:

{
        "session_id":"SDsnZugDFmTW7Sec",
        "timestamp":"2019-12-27 15:34:44.461",
        "type":"incoming",
        "state":"new",
        "from_number":"sip:</i^_^gt㵀�lt&i;gt^_^@192.168.0.1",
        "from_pin":"",
        "request_number":"sip:</i^_^gt㵀�lt&i;gt^_^@1192.168.0.1",
        "request_pin":^_^quotɟquot^_^,
        "disconnect_reason":"",
        "is_record":""
}

Далее нужно подключить обработчик /get_number_info. Запрос должен выполняться при поступлении входящего вызова на входящую линию до маршрутизации вызовов. Если ответ на запрос не получен за установленное время, то вызов маршрутизируется по установленным в домене правилам.

Пример обработчика на стороне CRM.

if ($account) {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент найден',
            	'displayName' => $account->name,
            	//'PIN' => $crm_users,
        	];
    	} 
        else 
                {
        	$data = [
            	'result' => 0,
            	'resultMessage' => 'Абонент не найден',
            	'displayName' => 'Неизвестный абонент '.$contact,
            	//'PIN' => crm_users,
        	];
    	}
    	return $data;

Ответ от обработчика.

{
        "result":0,
        "resultMessage":"Абонент найден",
        "displayName":"Иванов Иван Иванович +1</i> 234-56-78-90<i>"
}

Отслеживаем статус и скачиваем записи разговоров

В виртуальной АТС «Ростелекома» запись разговоров активируется в личном кабинете. При помощи API можно отслеживать статус этой функции. При обработке завершения вызова в call_events можно увидеть флаг ‘is_record’, который уведомляет пользователя о статусе записи: true означает, что функция записи разговора у пользователя подключена.

Чтобы скачать запись, нужно по идентификатору сессии вызова session_id отправить запрос на api.cloudpbx.rt.ru/get_record.

{
        "session_id":"SDsnZugDFmTW7Sec"
}

В ответ придет временная ссылка на скачивание файла с записью разговора.

{
        "result": ^_^quotquot^_^,
        "resultMessage": "Операция выполнена успешно",
    	"url": "https://api.cloudpbx.rt.ru/records_new_scheme/record/download/501a8fc4a4aca86eb35955419157921d/188254033036"
}

Время хранения файла задается в настройках личного кабинета. После файл будет удален.

Статистика и отчетность

В личном кабинете на отдельной странице можно увидеть статистику и отчетность по всем вызовам и применить фильтры по статусу и времени. Через API нужно сначала обработать вызов методом /call_events:

       {
        "session_id":"SDsnZugDFmTW7Sec",
        "timestamp":"2019-12-27 15:34:59.349",
        "type":"incoming",
        "state":"end",
        "from_number":"sip:</i^_^gt㵀�lt&i;gt^_^@192.168.0.1",
        "from_pin":"",
        "request_number":"sip:</i^_^gt㵀�lt&i;gt^_^@192.168.0.1",
        "request_pin":^_^quotʚquot^_^,
        "disconnect_reason":"",
        "is_record":"true"
        }

Затем вызвать метод call_info для обработки массива и отображения вызова в CRM системе.

     {
        "session_id":"SDsnZugDFmTW7Sec"
}

В ответ придет массив данных, который можно обработать для хранения данных в журнале CRM.

{
        "result":0,
        "resultMessage":"",
        "info":
        {
                "call_type":1,
                "direction":1,
                "state":1,
                "orig_number":"sip:</i^_^gt㵀�lt&i;gt^_^@192.168.0.1",
                "orig_pin":null,
                "dest_number":"sip:</i^_^gt㵀�lt&i;gt^_^@192.168.0.1",
                "answering_sipuri":"admin@example.ru",
                "answering_pin":^_^quotɟquot^_^,
                "start_call_date":^_^quot夾�quot^_^,
                "duration":14,
                 "session_log":"0:el:123456789;0:ru:admin;7:ct:admin;9:cc:admin;14:cd:admin;",
                "is_voicemail":false,
                "is_record":true,
                "is_fax":false,
                "status_code":^_^quotquot^_^,
                "status_string":""
        }
}

Другие полезные функции виртуальной АТС

Кроме API, у виртуальной АТС есть еще несколько полезных функций, которые можно использовать. Например, это интерактивное голосовое меню и объединение сотовой и фиксированной связи.

Интерактивное голосовое меню (IVR — Interactive Voice Response) — то, что мы слышим в трубке до того, как ответит человек. По сути, это электронный оператор, который перенаправляет вызовы в соответствующие отделы и отвечает на часть вопросов в автоматическом режиме. Скоро с IVR можно будет работать через API: сейчас мы разрабатываем ПО, которое позволит отслеживать прохождение вызова через IVR и получать информацию о нажатиях клавиш тонального набора при нахождении абонента в голосовом меню.

Для переноса корпоративной телефонии на мобильные телефоны можно либо использовать приложения-софтфоны, либо отдельно подключить услугу Fixed Mobile Convergence (FMC). При любом из способов звонки внутри сети бесплатны, появляется возможность работать с короткими номерами, а звонки можно записывать и вести по ним общую статистику. 

Отличие заключается в том, что софтфонам для связи нужен интернет, но они не привязаны к оператору, а FMC привязана к определенному оператору, но может использоваться даже на старых кнопочных телефонах.