Обновление статуса оператора из внешней системы необходимо для синхронизации статуса в случае возможной загрузки другими задачами - обработкой звонков, подготовкой писем, т.д.
Для установки статуса используется метод PUT контроллера User https://<SherlockPlatform_API>/v2/users/{UserId}/OperatorStatus/{OperatorStatusId}. Входными параметрами необходимо передавать UserId и OperatorStatusId
UserId можно получить используя метод GET контроллера User. Список статусов операторов (OperatorStatusId) возвращает метод GET контроллера OperatorStatus https://<SherlockPlatform_API>/v2/OperatorStatus. Как правило данные статусы не меняются после настройки приложения. Поэтому допустимо взять константные значения и далее - использовать их для смены статуса.
Также в качестве UserId можно передавать идентификатор пользователя во внешней системе, если для Sherlock Platform настроена синхронизация внешних идентификаторов. Для этого надо использовать следующий формат вызова метода https://<SherlockPlatform_API>/v2/users/{ExternalUserId}/OperatorStatus/{OperatorStatusId}?externalSystemCode={ExternalSystemCode}
Метод возвращает код результата 200 в случае успешной смены статуса. В случае если пользователь или статус не найдены по переданным значениям, то возвращается код результата 404 с текстом ошибки: Error: Not Found