Установить статус агента

Обновлено: 12 марта 2026

Используйте этот метод, чтобы установить агенту необходимый статус. Возможные опции: READY, OUTGOING и INACTIVE.

• Вызовите этот метод, используя "status": "READY" или "status": "OUTGOING", чтобы переключить статус агента в один из тех, в которых агент может продолжать работу.
• Вызовите этот метод, используя "status": "INACTIVE" и "reason: "REASON", чтобы перевести агента в неактивный статус.

По умолчанию доступны следующие причины для статуса INACTIVE:

• Технический перерыв technicalbreak_time
• Встреча meeting_time
• Обеденный перерыв lunch_time
• Перерыв shortbreak_time
• Тренинг training_time

к сведению

С этим методом, кроме причин по умолчанию, вы можете также использовать любые другие причины не активности, добавленные в колонку reason в таблице inactivity_reasons edna Chat Center.

    ----
    Permissions:INTEGRATOR,OPERATOR
    ----

Переменные пути запроса

Переменная	Описание
userVariable	Значение id или login агента

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

Параметр	Описание
userVariableName	Возможные значения: id/login - переменная агента

Поля тела запроса

Параметр	Тип	Описание
status	String	Текущий статус агента
reason	String	Причина не активности агента

Пример curl

$ curl 'http://localhost:8080/api/v1/agents/1/status?userVariableName=id' -i -X PUT \
    -H 'Content-Type: application/json' \
    -H 'Authorization: Bearer <integrator_token>' \
    -H 'X-Tenant-Name: local' \
    -d '{
  "status" : "READY",
  "reason" : null
'

Пример HTTP запроса

PUT /api/v1/agents/1/status?userVariableName=id HTTP/1.1
Content-Type: application/json
Authorization: Bearer <integrator_token>
X-Tenant-Name: local
Content-Length: 43
Host: localhost:8080

{
  "status" : "READY",
  "reason" : null
}

Пример HTTP ответа

HTTP/1.1 200 OK
X-Request-Id: 4783cf0d-4f06-4d79-b637-846c632ecbff
Vary: Origin
Vary: Access-Control-Request-Method
Vary: Access-Control-Request-Headers
X-Content-Type-Options: nosniff
X-XSS-Protection: 0
Cache-Control: no-cache, no-store, max-age=0, must-revalidate
Pragma: no-cache
Expires: 0
X-Frame-Options: DENY