Для аутентификации запросов используется протокол OAuth 2.0.
Необходимо отметить, что для каждой новой интеграции будут сгенерированы свои уникальные ключи. Даже в рамках одного личного кабинета, каждая интеграция - уникальна. |
Описание
После выполнения запроса, будет выполнен редирект на страницу ввода логина и пароля в ЛК МТТ Бизнес. После успешного подтверждения логина и пароля, будет выполнен редирект на указанный redirect_uri с передачей кода (например: http://localhost:9090/callback?code=Yzk5ZDczMzRlNDEwY&state=xyz). |
Описание
|
Обменивает вышедший из употребления токен доступа (access_token) на новый путём использования токена обновления (refresh_token).
|
Группа методов запросов и нотификации предназначены для получения информации о настройке ВАТС в ЛК: внешней нумерации и составе РМ пользователей МТТ Бизнес.
При изменении настроек пользователем в ЛК МТТ Бизнес отрабатывают соответствующие методы нотификации, которые возвращают новую, обновленную информацию.
Для всех методов используется единый адрес для отправки запросов: https://openapi.mtt.ru
Для получения нотификаций необходимо настроить сервер по адресу Redirect URI указанному при подключении интеграции в ЛК МТТ Бизнес и по пути /events нужно настроить слушателя событий (обработчик POST запросов). Дополнительно специально подписываться нигде не нужно, вы будете получать все события на свой сервер redirect_uri/events.
Описание Адрес для отправки запроса Параметры
|
Описание Адрес для отправки запроса Параметры
|
Описание Адрес для отправки запроса Параметры
|
Описание
|
Описание
|
Группа методов для работы с вызовами позволяет получать информацию о вызовах и их состояниях, осуществлять управление вызовами, настраивать режим «парковки» для внешних номеров.
Для всех методов используется единый адрес для отправки запросов: https://openapi.mtt.ru
Для получения нотификаций необходимо настроить сервер по адресу Redirect URI указанному при подключении интеграции в ЛК МТТ Бизнес и по пути /events нужно настроить слушателя событий (обработчик POST запросов). Дополнительно специально подписываться нигде не нужно, вы будете получать все события на свой сервер redirect_uri/events.
Описание
Необходимо учесть последовательность: второе плечо (вызов на calleeId) осуществляется только после ответа «первого плеча» (SIP ID РМ callerId). Параметр callerId обычно "подтягивается" из CRM системы по данным текущего рабочего места Оператора настроенного в CRM системе. Адрес для отправки запроса Параметры
Пример запроса |
Описание Адрес для отправки запроса Параметры
|
Описание
Адрес для отправки запроса Параметры
|
Описание Адрес для отправки запроса Параметры
|
Методы нотификации о вызовах предназначены для получения информации о начале и окончании вызова, прохождении вызова по РМ пользователей МТТ Бизнес и прикрепления записи разговора.
|
Описание
|
|
Описание Сообщение о готовности записи разговора. Запись разговора формируется в виде файла в формате *.mp3, который может быть скачан по указанной в нотификации ссылке. Файл имеет срок хранения, по умолчанию равный 90 дням. Пример нотификации { "event": "callNotifications", "result": { "callInfo": { "accountId": "883140777446532", "call": { "id": "SDvapac01-3bd7d743109f2668f16de50c9ab53559100@127.0.0.1" }, "state": "recorded", "urlRecord": "https://openapi-stage.mtt.ru/records/34380859/2020/12/18/9B58D12A_EC9D5E37_56485D37_0EE913E5.mp3" } } } |
|
|
|
|