метод REST scope: im

im.user.status.set

Установить статус пользователя

Кто может выполнять: любой пользователь

Описание

Метод im.user.status.set устанавливает пользовательский статус текущего пользователя.

Чтобы узнать текущий статус, используйте метод im.user.status.get.

Параметры

STATUS string обязательный

Новый статус пользователя. Значение чувствительно к регистру и должно передаваться в нижнем регистре.

Допустимые значения:
- online — в сети, пользователь получает все уведомления
- dnd — не беспокоить, статус отключает уведомления
- away — отсутствую
- break — перерыв

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

curl -X POST \
  -H "Content-Type: application/json" \
  -H "Accept: application/json" \
  -d '{"STATUS":"dnd"}' \
  https://**put_your_bitrix24_address**/rest/**put_your_user_id_here**/**put_your_webhook_here**/im.user.status.set

Ответ

HTTP-статус: 200

{
    "result": true,
    "time": {
        "start": 1760000000.0,
        "finish": 1760000000.1,
        "duration": 0.1,
        "processing": 0.04,
        "date_start": "2026-03-02T09:30:00+03:00",
        "date_finish": "2026-03-02T09:30:00+03:00",
        "operating_reset_at": 1760030000,
        "operating": 0
    }
}

Возвращаемые данные

result boolean

Возвращает true, если статус установлен

time time

Информация о времени выполнения запроса

Обработка ошибок

HTTP-статус: 400

{
    "error": "STATUS_ERROR",
    "error_description": "Status is not available"
}
Код Описание Значение
STATUS_ERROR Status is not available Передано значение STATUS, которого нет в списке доступных статусов

Что будем искать? Например,Продвижение

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