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

Это работает через веб-хуки — «Мобильные сотрудники» сами отправляют данные при их изменении, не дожидаясь запроса от вашей системы. Такой подход особенно удобен для событийной интеграции: вы сразу получаете нужную информацию и можете быстрее реагировать.

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

Подготовка веб-хука

Чтобы получать данные из «Мобильных сотрудников» в реальном времени, настройте веб-хук — адрес, на который сервис будет отправлять информацию об изменениях и событиях.

1. Подготовьте публичный URL-адрес, доступный по HTTPS, куда будет отправляться информация.

2. Обеспечьте прием POST-запросов с телом в формате JSON.

3. Обработайте полученные данные в своей системе (например, сохранить или передать дальше по бизнес-процессу).

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

Настройка событий

Настроить нужное событие можно в веб-интерфейсе «Мобильных сотрудников»:

1. В рабочей области Координатор перейдите на вкладку События.

2. Нажмите кнопку Новое событие.

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

4. Введите название события и выберите сотрудников. Название события не должно содержать символ «\». 

5. Настройте параметры события для отправки уведомления. Параметры отличаются во всех событиях.

6. Настройте:

• период действия события — укажите период, когда нужно отправлять уведомления о зафиксированном событии. Чтобы сделать событие бессрочным, поставьте галочку без ограничения даты.

• дни недели учета события — выберите дни недели, в которые вы хотите получать уведомления о событии, например, только в будни;

• ограничения события в течение суток — настройте время, когда вы хотите получать уведомления о событии. Например, можно настроить получение уведомлений только в рабочее время с 9:00 до 18:00.

• список почтовых адресов для отправки уведомлений — введите адреса электронной почты, на которые нужно отправлять уведомления;

• список телефонных номеров для отправки уведомлений — введите номера телефона, на которые нужно отправлять уведомления о событиях по SMS. Для этого должна быть подключена платная опция Пакет SMS 1000.

• список пользователей для отправки уведомлений через Telegram — выберите пользователей, которым нужно отправлять уведомления о событиях через Telegram. Для этого у пользователей должен быть подключен Telegram-бот «МТС Транспорт».

• отправлять на API — отметьте галочкой Отправлять на API и в появившемся поле введите ссылку на API вашей системы (подробнее см. Подготовка веб-хука), например, https://example.ru/api.

7. Нажмите кнопку Готово.

Получение событий из услуги в КИС

Общее описание

Запрос выполняется услугой в направлении вашей корпоративной информационной системы (КИС) и передает информацию о зафиксированных событиях в КИС.

Параметры запроса

Функция передает массив данных. Каждый элемент в массиве содержит следующие параметры:

Результат выполнения

События передаются в КИС клиента.

Пример запроса с типом события «Контроль датчиков»

POST /client_uri HTTP/1.1
Host: host
Content-Type: application/json

{
    "subscriberID": 1,
    "subscriberExternalID": 1,
    "signalID": 1,
    "signalDate": "2021-02-03T11:44:35Z",
    "signalTypeID": 10,
    "sensorID": 1,
    "sensorValue": 12
}