Определения и сокращения

Назначение и описание

Открытое API предназначено для интеграции различных сторонних приложений с услугами, которые предоставляет ВАТС МТТ Бизнес. За счет интеграции приложений с ВАТС МТТ Бизнес предполагается расширение спектра предоставляемых услуг конечному пользователю за счет синергетического эффекта и реализация новой функциональности.

Для того чтобы воспользоваться решением необходимо быть Клиентом ВАТС МТТ Бизнес и в ЛК МТТ Бизнес в разделе услуги перейти на вкладку "Открытое API" и перевести слайдер в состояние ВКЛ.

В зависимости от конфигурации, Рабочие Места в ВАТС МТТ Бизнес могут быть как самостоятельными терминальными устройствами, так и объединять под одним из рабочих мест несколько терминалов (локаций) с различными методами распределения вызовов между ними.

То есть формируется иерархия терминальных устройств и одно Рабочее место может объединять несколько или один терминал(ов).

Возможности решения

Открытое API ВАТС МТТ Бизнес позволяет:
1. Обеспечить авторизацию между приложениями и ВАТС МТТ Бизнес по принципам OAuth 2.0.
2. Предоставляет возможности сторонним приложениям:

• получить структуру Рабочих Мест, терминалов и нумерации, которые используются в ВАТС пользователя.
• информирует об изменениях, произведенных пользователем в настройках ВАТС МТТ Бизнес.
• информирует о вызовах и их состояниях в режиме реального времени (начало вызова, конец вызова, получение вызова на рабочее место и перенаправление вызова с рабочего места).
• информирует о готовности записи разговора по вызову.

3. Устанавливает входящие вызовы на временный паркинг до 5 секунд для осуществления управления входящими вызовами сторонними приложениями. Если в альтернативной обработке нет необходимости, то приложение может «сбросить» вызов с паркинга и отправить вызов дальше по стандартному пути при помощи метода terminateCall.

4. Позволяет осуществлять управление вызовами сторонним приложениям.

Возможные способы реализации в сторонних приложениях

Суть решения заключается в том, что по определенным событиям происходит обмен данными. Таких событий несколько (описаны выше), из них формируются возможности. Дальше мы рассмотрим каждую возможность в подробности и приведём примеры их реализации.

Преимущества: сокращение времени разговора и беседа по делу, возможность обратиться к Клиенту по имени, повышает лояльность Клиента и помогает выстраивать с ним доверительную коммуникацию. Показывает профессиональность подхода компании в целом. Схема работы: Описание: на корпоративную телефонию МТТ Бизнес поступает входящий вызов. Он адресуется на РМ сотрудника согласно настроенной в ВАТС МТТ Бизнес логике и одновременно информация о нём передаётся по API в корпоративную CRM. Получив эту информацию, корпоративная CRM осуществляет по номеру телефона поиск карточки клиента и отображает её на мониторе РМ сотрудника.

Преимущества: позволяет упростить и оптимизировать работу сотрудников, организовать автоматизацию процессов отдела продаж. Звонок Клиентам осуществляется буквально в один клик. Схема работы: Описание: сотрудник открывает в корпоративной CRM карточку Клиента и желая связаться с ним нажимает на его телефонный номер. Информация об этом действии передаётся в ВАТС МТТ Бизнес и она осуществляет звонок на РМ сотрудника («первое плечо»). После того, как сотрудник ответит на вызов осуществляется вызов номера Клиента («второе плечо»). Это позволяет избежать ситуации, когда случайное нажатие на номер в корпоративной CRM сгенерирует ложный вызов Клиенту, и в момент ответа Клиента сотрудник уже на линии ожидает его ответа.

Преимущества: позволяет в автоматическом режиме создавать карточку клиента (если её ещё нет), фиксировать факт вызовов и его статус в сущностях CRM и статистике вызовов CRM, скачивать и прослушивать записи разговоров. Это позволяет организовать автоматический учёт и фиксацию обращений клиентов при входящих звонках, контролировать работу своих сотрудников и иметь материал на случай сложных ситуаций, проверять соблюдение скриптов на каждом этапе общения с Клиентами. Схема работы: Описание: Информация о факте совершённого или пропущенного входящего или исходящего вызова посредством API передаётся в корпоративную CRM. В зависимости от её настроек, может выполняться создание сущностей (сделка, лид, контакт, задача) либо не выполняться. По факту состоявшихся вызовов формируется файл с записью разговора, информация об этом так же передаётся посредством API в CRM для прикрепления к какой-либо сущности. В зависимости от функциональности корпоративной CRM возможно создать отчёт о всех вызовах в разрезе сотрудник/Клиент/сделка, прослушать все разговоры по интересующему сотруднику или Клиенту.

Преимущества: позволяет в автоматическом режиме распределять входящие вызовы по персональным менеджерам. Это позволяет закрепить ключевых Клиентов за специалистами продаж или обслуживания и построить процесс ведения Клиента в случае «длинной» сделки. Для новых Клиентов (потенциальных) позволяет организовать моментальный ответ. Схема работы: Описание: при поступлении входящего вызова, он «паркуется» на время до 5 секунд и происходит запрос по API корпоративной CRM о наличии персонального менеджера для входящего номера. Если такого менеджера нет, или это новый номер, то необходимо «сбросить паркинг» и вызов будет незамедлительно распределён соответственно настроенной ранее схеме распределения входящих вызовов ВАТС МТТ Бизнес. Если же такой менеджер найден, то вызов маршрутизируется на его РМ. В случае не доступности менеджера, вызов возвращается на маршрутизацию по ранее настроенной схеме распределения входящих вызовов ВАТС МТТ Бизнес.

Особенности работы и известные ограничения

1. При переадресации на внешний номер и при использовании IP SIP терминала приходят не все event'ы, а только event trying и finished.
2. При трансфере вызова с терминала FMC на другой номер, трансфер не возможен и вызов завершается.
3. Нотификация о записи разговора приходит только если вызов проходит через РМ. При настройке логики распределения вызовов необходимо это учитывать и добавлять РМ в качестве промежуточного звена. Если использовать IP SIP терминал и инициировать исходящие вызовы не с РМ, то запись разговора так же не сформируется.
4. Решение не занимается преобразованием номеров и передаёт их в поступившем формате. К примеру, некоторые операторы могут передавать номер с двумя ведущими нулями: 0079581234567.
5. При использовании мобильного приложения МТТ Бизнес в качестве РМ, из за его особенностей работы, происходит дублирование нотификаций.
6. При звонке через IVR на FMC, для корректного получения нотификаций, необходимо FMC терминал добавлять в групп и затем саму эту группу добавлять в меню IVR.
7. На каждый экземпляр решения распространяется ограничение API в 5 RPS.
8. Если необходимо использовать разные URL адреса (redirect_url) для приёма нотификаций и отправки команд, то можно настроить в личном кабинете 2 интеграции с разными URL. Одну из них использовать для отправки команд, вторую для прослушивания нотификаций. На той, что используется только для отправки команд рекомендуется отключить ползунок под названием интеграции для минимизации лишней нагрузки и ошибок. 
9. История нотификаций не сохраняется. Они передаются в реальном времени в момент возникновения.

Оглавление
7. Аутентификация OAuth 2.0
8. Методы для работы с OAuth 2.0.
9. Методы для работы с настройками ВАТС МТТ Бизнес.
9.1. Получение информации о структуре внешней нумерации ЛК МТТ Бизнес.
9.2. Получение списка рабочих мест в ЛК МТТ Бизнес.
9.3. Получение списка терминалов в ЛК МТТ Бизнес.
9.4. Нотификация об изменении структуры РМ в ЛК МТТ Бизнес.
9.5. Нотификация об изменении настроек в ЛК МТТ Бизнес.
10. Методы для работы с вызовами.
10.1. Нотификация о вызовах.
10.1.1. Нотификация о поступлении входящего вызова.
10.1.2. Нотификация о начале исходящего вызова
10.1.3. Нотификация о готовности записи разговора.
10.1.4. Нотификация о поступлении вызова на РМ оператора.
10.1.5. Нотификация о соединении вызова с РМ оператора.
10.1.6. Нотификация об окончании вызова на РМ оператора.
10.1.7. Нотификация об окончании вызова.
10.2. Установка/снятие парковки вызова для внешней нумерации.
10.3. Методы управления вызовами
10.3.1. Инициализация (оригинация) входящего вызова.
10.3.2. Команда завершения плеча вызова.
10.3.3. Команда перевода вызова.