Предупреждение
При использовании мобильной версии могут быть недоступны некоторые элементы управления страницей. Вы можете переключиться на версию для компьютера или скачать приложение Confluence, чтобы получить доступ ко всем элементам управления страницей.
Определения и сокращения
Значение | Расшифровка значения |
Открытое API | Коммерческое название услуги ОАО «МТТ» по интеграции с ВАТС МТТ Бизнес. |
ВАТС | Виртуальная Автоматическая Телефонная Станция. |
API | Application Programming Interface - программный интерфейс приложения. |
РМ | Рабочее Место пользователя ВАТС МТТ Бизнес. |
Терминал | Оконечное устройство, подключаемое тем или иным способом к ВАТС для приема вызовов. |
Трансфер | Переадресация активного вызова на другой номер. |
ЛК МТТ Бизнес | Личный кабинет портала ВАТС МТТ Бизнес. |
ЛС МТТ Бизнес | Лицевой Счет ВАТС МТТ Бизнес. |
OAuth 2.0 | Принцип организации предоставления прав (или делегирования прав) от одного приложения к другому приложению. Описан в RFC 6749. |
Назначение и описание
Открытое API предназначено для интеграции различных сторонних приложений с услугами, которые предоставляет ВАТС МТТ Бизнес. За счет интеграции приложений с ВАТС МТТ Бизнес предполагается расширение спектра предоставляемых услуг конечному пользователю за счет синергетического эффекта и реализация новой функциональности.
Для того чтобы воспользоваться решением необходимо быть Клиентом ВАТС МТТ Бизнес и в ЛК МТТ Бизнес в разделе услуги перейти на вкладку "Открытое API" и перевести слайдер в состояние ВКЛ.
Уважаемые партнёры!
API ВАТС находится на этапе опытной эксплуатации и доступно ограниченному числу партнёров.
Условия подключения: Вам необходимо быть пользователем МТТ Бизнес.
По вопросам потенциального сотрудничества обращайтесь на электронную почту openapi_support@mtt.ru. Для удобства использования страницы инструкции можно экспортировать. Нажмите на три точки в верхнем правом углу и выберите экспорт в удобный формат.
В зависимости от конфигурации, Рабочие Места в ВАТС МТТ Бизнес могут быть как самостоятельными терминальными устройствами, так и объединять под одним из рабочих мест несколько терминалов (локаций) с различными методами распределения вызовов между ними.
То есть формируется иерархия терминальных устройств и одно Рабочее место может объединять несколько или один терминал(ов).
Возможности решения
Открытое API ВАТС МТТ Бизнес позволяет:
1. Обеспечить авторизацию между приложениями и ВАТС МТТ Бизнес по принципам OAuth 2.0.
2. Предоставляет возможности сторонним приложениям:
- получить структуру Рабочих Мест, терминалов и нумерации, которые используются в ВАТС пользователя.
- информирует об изменениях, произведенных пользователем в настройках ВАТС МТТ Бизнес.
- информирует о вызовах и их состояниях в режиме реального времени (начало вызова, конец вызова, получение вызова на рабочее место и перенаправление вызова с рабочего места).
- информирует о готовности записи разговора по вызову.
3. Устанавливает входящие вызовы на временный паркинг до 5 секунд для осуществления управления входящими вызовами сторонними приложениями. Если в альтернативной обработке нет необходимости, то приложение может «сбросить» вызов с паркинга и отправить вызов дальше по стандартному пути при помощи метода terminateCall.
4. Позволяет осуществлять управление вызовами сторонним приложениям.
Возможные способы реализации в сторонних приложениях
Суть решения заключается в том, что по определенным событиям происходит обмен данными. Таких событий несколько (описаны выше), из них формируются возможности. Дальше мы рассмотрим каждую возможность в подробности и приведём примеры их реализации.
Особенности работы и известные ограничения
- При переадресации на внешний номер и при использовании IP SIP терминала приходят не все event'ы, а только event trying и finished.
- При трансфере вызова с терминала FMC на другой номер, трансфер не возможен и вызов завершается.
- Нотификация о записи разговора приходит только если вызов проходит через РМ. При настройке логики распределения вызовов необходимо это учитывать и добавлять РМ в качестве промежуточного звена. Если использовать IP SIP терминал и инициировать исходящие вызовы не с РМ, то запись разговора так же не сформируется.
- Решение не занимается преобразованием номеров и передаёт их в поступившем формате. К примеру, некоторые операторы могут передавать номер с двумя ведущими нулями: 0079581234567.
- При использовании мобильного приложения МТТ Бизнес в качестве РМ, из за его особенностей работы, происходит дублирование нотификаций.
- При звонке через IVR на FMC, для корректного получения нотификаций, необходимо FMC терминал добавлять в групп и затем саму эту группу добавлять в меню IVR.
- На каждый экземпляр решения распространяется ограничение API в 5 RPS.
- Если необходимо использовать разные URL адреса (redirect_url) для приёма нотификаций и отправки команд, то можно настроить в личном кабинете 2 интеграции с разными URL. Одну из них использовать для отправки команд, вторую для прослушивания нотификаций. На той, что используется только для отправки команд рекомендуется отключить ползунок под названием интеграции для минимизации лишней нагрузки и ошибок.
- История нотификаций не сохраняется. Они передаются в реальном времени в момент возникновения.